# Sonic Universe Theme

Sonic the Hedgehog universe theme. Cinematic, photorealistic visual style — movie-poster quality renders with dramatic lighting, detailed textures, and dynamic compositions.

## Visual Style

- **Cinematic photorealistic** — like Sonic movie posters / Unreal Engine 5 renders
- Dramatic lighting, volumetric effects, detailed fur/quill textures
- Characters should feel alive and dimensional, not flat or cartoon-like
- White or transparent backgrounds for standalone assets
- Concept sketches stored in `sketches/` subfolders during exploration phase

## Character Roster

### Heroes

| Character | File | Description | Status |
|-----------|------|-------------|--------|
| Sonic | `sonic.png` | Blue hedgehog, super speed, iconic quills | Sketch |
| Shadow | `shadow.png` | Black/red hedgehog, chaos energy, rival | Sketch |
| Tails | `tails.png` | Two-tailed fox, flight, tech genius | Sketch |
| Knuckles | `knuckles.png` | Red echidna, super strength, guardian | Sketch |
| Amy Rose | `amy.png` | Pink hedgehog, Piko Piko Hammer | Sketch |
| Silver | `silver.png` | Silver-white hedgehog, psychokinesis, futuristic | Sketch |
| Cream | `cream.png` | Cream rabbit with Chao companion Cheese | Sketch |

### Villains / Anti-heroes

| Character | File | Description | Status |
|-----------|------|-------------|--------|
| Dr. Eggman | `eggman.png` | Main villain, genius inventor, red military jacket | Sketch |
| Metal Sonic | `metal-sonic.png` | Robot hedgehog, blue chrome, red eyes | Sketch |
| Rouge | `rouge.png` | White bat spy, jewel hunter, bat wings | Sketch |
| Chaos | `chaos.png` | Translucent water creature, green glowing brain | Sketch |
| Zavok | `zavok.png` | Red demon, leader of Deadly Six, muscular | Sketch |
| Infinite | `infinite.png` | Black jackal, silver mask, phantom ruby | Sketch |
| Egg Robo | `egg-robo.png` | Egg-shaped robot soldier, red/silver metal | Sketch |

## Items

| Item | Description | Status |
|------|-------------|--------|
| Chaos Emeralds | 7 colored crystals of immense power | Planned |
| Gold Rings | Collectible rings, life energy | Planned |
| More TBD | — | — |

## Asset Inventory

| Category | Path | Count | Description |
|----------|------|-------|-------------|
| Protagonist sketches | `sketches/protagonists/{name}/` | 7×5 | Base sketch, character sheet, lvl1-3 per hero |
| Antagonist sketches | `sketches/antagonists/{name}/` | 7×5 | Base sketch, character sheet, lvl1-3 per villain |

### Per-character file structure

Each character folder contains:
- `{name}.png` — base presentation sketch (standing pose, white bg)
- `{name}-sheet.png` — character sheet (views + expressions, 16:9)
- `{name}-lvl1.png` — Level 1: child (age 5-6), cute accessories, shy smile
- `{name}-lvl2.png` — Level 2: teen (age 12-14), gadgets, stylish, show-off
- `{name}-lvl3.png` — Level 3: young adult (18-20), cyberpunk gear, serious hero/villain

**Exceptions:**
- Eggman: lvl1 = early Robotnik (government suit), lvl2 = unhinged mad scientist, lvl3 = Gerald Robotnik (elderly grandfather)
- Metal Sonic: lvl1 = crude prototype, lvl2 = upgraded combat model, lvl3 = ultimate war machine
- Egg Robo: lvl1 = basic tin robot, lvl2 = combat model, lvl3 = elite destroyer mech

**Total: 70 files** (14 characters × 5 files each)

## Usage in Templates

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

## Color Palette

TBD — will be defined after initial sketches are reviewed and art direction is confirmed.

## Reference Policy

- `heroes/` — use existing hero images as `--ref` for consistency within character
- `items/` — use existing items as `--ref` within same item type
- Cross-character refs: use any hero sketch to maintain style consistency

## Adding New Assets

1. Generate via `/gen-image` with cinematic photorealistic style keywords
2. Save sketches/concepts to `{category}/sketches/`
3. Final production assets go directly to `{category}/`
4. Use `--ref` from same category for visual consistency