Repository navigation
ADR 0010
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 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.
- 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.darkclass; -
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.jsonandtokens/<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.
- 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.
Published from docs/. Edit the files there; changes here are overwritten.