# Fieldhouse OS Architecture

Fieldhouse OS is the primary application shell. It owns the session entry,
desktop, app launcher, taskbar, window state, and school theme.

There is no authentication. The login screen is a local program profile:

- When a snapshot is available, it shows the parsed coach and school and allows
  the user to sign in.
- When no snapshot is available, it exposes save-folder and save-file selection
  plus the existing import workflow.
- Signing out returns to the local profile without changing save data.

## Applications

The app registry lives in `src/renderer/src/FieldhouseOS.tsx`.

- **Gridiron Navigator** hosts the Saturday Circuit publication in browser
  chrome. Saturday Circuit keeps its own scoped brand tokens and navigation.
- **MailBag** is the program inbox.
- **The Podium** is the press-conference surface.
- **Depth Chart Pro** reads the active school's real roster from the snapshot.
- **Recruiting Board** owns future prospect and visit workflows.
- **Media Desk** hosts screenshot import, OCR, correction, and approval.
- **Generation Studio** hosts provider setup, prompt packs, and AI generation.
- **Program Files** hosts save selection and dynasty import.
- **Settings** hosts Fieldhouse and data diagnostics.

Each application renders inside a Fieldhouse window. Window open, close,
minimize, maximize, focus, taskbar, and Start menu behavior is isolated from the
application content.

## Branding

Fieldhouse OS uses fixed dark neutrals and receives `--school-primary` and
`--school-accent` from the active team's parsed colors.

Editorial products remain independently branded. Saturday Circuit is scoped
beneath `[data-brand="saturday-circuit"]`, so future browser publications or
standalone coaching products can introduce their own shells and token scopes
without leaking styles into Fieldhouse OS.