# Northstar Harbor Games

Public website and press kit for Northstar Harbor Games, an indie studio building story-driven exploration games.

## Overview

This project powers the studio homepage, game pages, devlog, press kit, and newsletter signup. It is designed to be lightweight, easy to update, and suitable for small teams that need to publish announcements without a large CMS.

## Features

- Responsive studio landing page
- Individual pages for released and upcoming games
- Devlog and announcement support
- Press kit with screenshots, logos, trailers, and fact sheets
- Newsletter signup integration
- SEO metadata and social sharing images
- Simple content-driven structure for non-engineers

## Install

```bash
git clone https://github.com/northstar-harbor/studio-site.git
cd studio-site
npm install
cp .env.example .env.local
```

Start the development server:

```bash
npm run dev
```

Build for production:

```bash
npm run build
```

Preview the production build locally:

```bash
npm run preview
```

## Usage

Update studio and game content in the `content/` directory.

Common tasks:

```bash
npm run dev        # Start local development
npm run lint       # Check code style
npm run build      # Create production build
npm run preview    # Preview production output
```

Add a new game by creating a folder under `content/games/` with an `index.md` file and assets such as capsule art, screenshots, and trailer thumbnails.

Add a devlog post by creating a Markdown file in `content/devlog/`.

## Configuration

Configuration is handled through environment variables.

| Variable | Description | Required |
| --- | --- | --- |
| `SITE_URL` | Public URL of the website | Yes |
| `STUDIO_NAME` | Display name of the studio | Yes |
| `NEWSLETTER_PROVIDER` | Newsletter service name, such as `buttondown` or `mailchimp` | No |
| `NEWSLETTER_API_KEY` | API key for newsletter signup | No |
| `PRESS_CONTACT_EMAIL` | Public press contact email | Yes |
| `ANALYTICS_ID` | Optional analytics tracking ID | No |

Example `.env.local`:

```env
SITE_URL=https://northstarharbor.games
STUDIO_NAME=Northstar Harbor Games
PRESS_CONTACT_EMAIL=press@northstarharbor.games
NEWSLETTER_PROVIDER=buttondown
NEWSLETTER_API_KEY=
ANALYTICS_ID=
```

Do not commit `.env.local` or production secrets to the repository.