Skip to content
Path 1 ~half a day · 5 docs · ~117 min reading

Author your first theme

Ship a brand-true theme — fork the default, author a sample, lock the layout rules. Five docs, half a day, one theme dir you can ship to production.

  1. Build a theme B1 ~6 min

    Theme overview

    Build the mental model first — a theme is templates + samples + assets, nothing more. Five minutes, then you know what every later doc is talking about.

  2. Build a theme B2 ~13 min

    Theme anatomy

    Map every file in `themes/default/` to a purpose. After this you can navigate the dir without grep, and you know which files to copy when you fork.

  3. Build a theme B3 ⭐ Copy-along ~30 min

    Create a sample

    Add a brand-new sample to the default theme — 11 lock-step beats, ships in 30 minutes. The mechanic transfers identically to your own theme.

  4. Build a theme B4 ⭐ Copy-along ~60 min

    Create a theme

    Author a NEW theme dir end-to-end — fork or scratch, both paths covered. Ship in 60 minutes, register with the picker.

  5. Build a theme B5 ~8 min

    Layout best practice

    Lock the patterns that survive the brand-color / hierarchy / padding-cascade gauntlet. Read AFTER you ship a theme so each rule lands as "oh THAT bug — yes."

Outcome A new theme dir + sample registered with the picker, light + dark verified.

Other paths