Skip to content

ADR 0010

github-actions[bot] edited this page Nov 21, 2026 · 1 revision

Status: accepted · Built: done · Date: 2026-11-21 · Supersedes: 0002, 0003, 0004, 0005

Fully supersedes ADRs 0003 and 0004; partly 0002 (the outputs and export paths) and 0005 (only the themes stay prebuilt). ADR 0001's token contract stands. Blocks come next, in their own record.

Spotstrap is a brand for shadcn, not a component library

Context

Spotstrap has its own component CSS (btn, field, switch…), Apple's touch sizes and type scale (ADR 0003), a Zag.js script for four widgets, and React Native recipes, and it ships no runtime (ADR 0004).

The apps it's for already use a shadcn port: shadcn-vue in Sokobanko, shadcn-svelte in Spotcraft's dashboard. Spotcraft dropped Spotstrap's classes for stock shadcn-svelte, because two component sets for one look was more to keep in sync than it gave. Spotcraft's ADR 0043 plans Spotstrap as the brand and the blocks apps repeat (privacy policy, legal notice, your data, consent), with shadcn's ports as the components. Nothing depends on the component layer.

Decision

  • Spotstrap is the brand: themes as the tokens of ADR 0001, which are shadcn's names. It ships no components, sizes or type scale; each framework's shadcn port (shadcn/ui, shadcn-vue, shadcn-svelte, React Native Reusables) brings its own, and Basecoat does for plain HTML.
  • Outputs:
    • tailwind.css: shadcn's plain names mapped to the theme, the page's colors and font, border and focus colors. Nothing else;
    • dark-class.css, to follow a .dark class;
    • themes/<name>.css, the source themes, which Tailwind v4 and Uniwind read;
    • dist/themes/<name>.css, prebuilt for pages without Tailwind, with every color under Tailwind's name (--color-primary) and shadcn's (--primary);
    • tokens.json and tokens/<name>.json.
  • Removed: the component CSS, spotstrap/js, spotstrap/recipes, spotstrap/merge, native.css, dist/spotstrap.css, dist/base.css, the touch sizes and the type scale.

Consequences

  • One look per framework: whatever its shadcn port draws, in the brand's colors, radius and fonts.
  • Apps that want phone-sized controls set them in their own components.
  • The tests check the tokens (contract, static values, contrast) and the outputs, not rendered components, so the suite needs no browser.
  • The website styles itself with its own few classes.

Clone this wiki locally