Every theme in [team-spotube/themes][themes] is written to show a different approach. Read the module in `src/` (TypeScript) for the technique you want, or the generated `themes/<id>/theme.json` to see the plain format. Each one is also a template: `pnpm exec spotube-theme add my-theme --template metro`.

| Theme | Idea | Fonts | Icons | Techniques to copy |
|---|---|---|---|---|
| **Classic** (`classic95`) | A 1990s desktop | Liberation Sans | Fluent filled | Bevels from `borderColor` + `innerGlowColor` + `bottomRimColor`; pressed state inverts them; navy title bar (`titleBarBackground`); menu highlight on hover. |
| **Amp** (`amp`) | A hi-fi deck | Silkscreen + Liberation Sans | Lucide | Brushed-metal gradients; an "LCD" for inputs and selection; glowing text with a text-style `shadow`; a `led` colour parameter. |
| **Phosphor** (`phosphor`) | A terminal | VT323 | Font Awesome | Inverse video for hover and selection; `tokens.type.scale`; a radial CRT backdrop in dark and paper in light. |
| **You** (`material-you`) | Tonal Material-style | Red Hat Text | Fluent | Per-accent tonal surfaces with `match`; stadium-shaped selection; a `Corners` parameter driving every radius. |
| **Metro** (`metro`) | Flat tiles | Open Sans | Bootstrap | No borders or shadows; `pressedScale` tilt; big light type via `tokens.type.styles`. |
| **Newsprint** (`newsprint`) | The Sunday paper | DM Serif Display + Caladea | Phosphor Thin | A different font per role (headlines vs body); hairline rules; an italic font face. |
| **Brutal** (`brutalist`) | Thick outlines | Archivo Black + Space Mono | Phosphor Bold | A number parameter (`Outline thickness`) feeding every `borderWidth`; hover floods a control with the accent. |
| **Pocket Synth** (`pocket-synth`) | A hardware sampler | Space Mono | Phosphor Fill | Raised "keys" via `bottomRimColor`; a pale LCD; the dock as a row of keys. |
| **Neon Noir** (`neon-noir`) | Synthwave | Audiowide + Chakra Petch | Phosphor | A gradient `tokens.app.background`; glow driven by a number parameter; neon outlines; a floating dock (`margin`). |
| **Candy Pop** (`candy-pop`) | Sweets | Comfortaa | Phosphor Fill | Glossy pills with a thick under-edge; bouncy `pressedScale`; a flavour parameter deriving three shades with `lighten`/`darken`. |

## Start from the closest one

| You want | Start from |
|---|---|
| Flat and minimal | `metro` or `material-you` |
| Skeuomorphic / bevelled | `classic95` or `pocket-synth` |
| Glowing and dark | `neon-noir` or `amp` |
| Typographic | `newsprint` or `brutalist` |
| Soft and playful | `candy-pop` |

## What every theme does

- Declares `schema`, metadata, a `logo.png` and a `LICENSE` that includes the licence of every bundled font and icon set.
- Defines **both** light and dark values with `A(light, dark)`.
- Exposes one or two **parameters** rather than many: accent, corner style, glow.
- Starts from `flatComponents()` so no stock sheen leaks through, then adds only the effects it wants.
- Passes `spotube-theme check` (JSON Schema) and Spotube's own zero-warning validation.

[themes]: https://github.com/team-spotube/themes
