# NMS (No Man's Sky) Theme

Space exploration theme inspired by No Man's Sky. Dark cosmic backgrounds, asteroid fields, cargo freighters, planet panoramas.

## Asset Inventory

| Category | Path | Count | Description |
|----------|------|-------|-------------|
| Hero images | `hero-images/spaceship{1-9}.{jpeg,png}` | 15 | Spaceships for page headers |
| Splitters | `hero-images/splitters/splitter{1-9}.png` | 9 | Splitting ship variants |
| Footers - Planets | `footers/planet{1-9}.jpeg` | 9 | Planet panoramas |
| Footers - Cabins | `footers/cabin{1-9}.jpeg` | 9 | Ship interior views |
| Icons Pack 1 | `icons/pack1/` | 60 | Minerals & plants (space-exploration) |
| Icons Pack 2 | `icons/pack2/` | 60 | Elements (space-exploration) |
| Icons Pack 3 | `icons/pack3-asteroids/` | 16 | Colored asteroid icons |
| Icons Pack 4 | `icons/pack4-cargobay/` | 9 | Cargo bay icons |
| Asteroids | `items/asteroids/` | 17 | Full-size colored asteroid images |
| Asteroid shapes | `items/asteroid-shapes/` | 16 | Line-art asteroid silhouettes |
| Freighters | `items/freighters/` | 30 | Ships and pods |
| Plants | `items/plants/` | 6 | Decorative plant icons |
| Stones | `items/stones/` | 6 | Stone/mineral textures |
| Elements | `items/elements/` | 4 | Element icons |

**Legacy:** `icons/pack1-2-unused/` (136 files) — superseded by pack2, kept for reference.

## Usage in Templates

All paths relative to project root:
- HTML templates: `/assets/themes/nms/{category}/{file}`
- Generator scripts (from docs/): `../../assets/themes/nms/{category}/{file}`
- Generator scripts (from project root): `assets/themes/nms/{category}/{file}`

## Color Palette

| Element | Class |
|---------|-------|
| Title text | `text-indigo-950` |
| Subtitle | `text-indigo-400` |
| Card border | `border-indigo-100` |
| Answer underline | `border-indigo-300` |
| Card bg gradient | `from-white to-indigo-50/40` |
| Badges | `bg-indigo-600` |

## Adding New Assets

1. Generate via `/gen-image` with `--ref` from same category for visual consistency
2. Save raw output (white background) to `items/{category}/raw/`
3. Run `pnpm remove-bg` if transparent background needed
4. Move final PNG to `items/{category}/`

## Reference Policy

- `items/asteroids/` — use any existing asteroid as `--ref`
- `items/crystals/` — use any existing crystal as `--ref`
- `icons/` — generate independently (icon packs have their own pipeline)
- `hero-images/`, `footers/`, `backgrounds/` — generate independently

## Cargo Bay Image Generation

Proven approach for generating `cargo-bayN.jpeg` from `spaceshipN.jpeg`:
- **Ref**: use original `spaceshipN.jpeg` first, then iterate using the generated `cargo-bayN.jpeg` as ref
- **Template**: `illustration`, **Aspect**: `16:9`, **Flag**: `--no-enhance`
- **Key prompt elements**: describe the ship's unique features, emphasize "NO landing gear", "rear engines glow", "open cargo bay hatch", "flying in zero gravity", "white background", "concept art illustration style"