Skip to content
Reed Docs

Templates

mint, rapide, black — and what a template actually owns.

template is required and picks the visual design your site renders through.

The three

Section titled “The three”
minttemplate

The fully-featured design system. Everything Reed’s component catalog can express is designed here.

rapidetemplate

A minimal in-repo template. Baseline sidebar width 260px.

blacktemplate

A minimal in-repo template. Baseline sidebar width 300px.

rapide and black conform to the same ReedTemplate interface mint does. They exist partly as alternatives and partly as proof that the interface is real — a design system with exactly one implementation has an untested contract.

A template owns its own baseline

Section titled “A template owns its own baseline”

Each template carries a baseline stylesheet with its own values for every dimension. That is why omitting a layout field is not the same as setting it to the schema default: an omitted field leaves the template’s baseline in control.

Set layout.sidebar-width explicitly and all three templates obey you. Leave it out and rapide renders 260px, black 300px, mint 280px — each its own design, not a shared fallback.

What reed init scaffolds

Section titled “What reed init scaffolds”

--template mint produces a full starter taxonomy with real prose per category. --template rapide and --template black produce a minimal two-page stub. This is a difference in scaffolding only — all three build the same content equally well.

Switching templates

Section titled “Switching templates”

Change the field and rebuild. Your content does not change: the component catalog is identical across templates, so every page renders under all three. What changes is the baseline styling, and any layout dimension you left unset.