Example themes

The ten official themes in team-spotube/themes and the technique each one demonstrates.

Every theme in team-spotube/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.