Browse documentation
Design System
Every visible property comes from a step, and every element exists exactly once. Everything the pages are built from lives here.
No matching example in this view. Clear the search or select another category.
Each category loads its own examples. Source contracts sit beneath each preview; native hover and keyboard focus can be tested directly.
Primitives
Input
Usage and source contract
Use Input for native text/search fields. Always connect a visible label; errors use aria-invalid and aria-describedby.
Primary source: src/components/ui/input.tsx
Variants: size: sm | md · native input props except numeric size
States: empty · filled · focus-visible · disabled · readOnly · aria-invalid + aria-describedby
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<label for="search">Search work</label>
<Input id="search" type="search" size="md" />Card
A calm surface
Cards hold one unit of content and lift off the page by one shadow step.
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/ui/card.tsx
src/components/ui/badge.tsx
src/components/ui/separator.tsx
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<Card className="max-w-text">
<CardHeader><CardTitle>{t(locale, 'ds.cardTitle')}</CardTitle><CardDescription>{t(locale, 'ds.cardBody')}</CardDescription></CardHeader>
<Separator />
<div class="flex gap-2"><Badge tone="brand" dot>{t(locale, 'flag.tag')}</Badge></div>
</Card>Table
| Figure | What |
|---|---|
| 0 → 1 | One entry point for every zvoove product, from the first shell prototype to shipping with the zvoove One bundles. |
| 4 → 14 | Grew the Container xChange design team as Design Co-Lead. |
| Seven figures | Outstanding customer receivables brought back, a joint initiative in finance. |
| Since 2017 | My own design systems, from car2go and SHARE NOW to Compass. |
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/ui/table.tsx
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<div class="overflow-hidden rounded-card bg-panel shadow-lift">
<Table>
<TableHeader><TableRow><TableHead>{locale === 'de' ? 'Kennzahl' : 'Figure'}</TableHead><TableHead>{locale === 'de' ? 'Was' : 'What'}</TableHead></TableRow></TableHeader>
<TableBody>
{proof.map((n) => <TableRow><TableCell className="text-lg font-medium text-ink tabular-nums">{t(locale, `proof.${n}.v`)}</TableCell><TableCell>{t(locale, `proof.${n}.t`)}</TableCell></TableRow>)}
</TableBody>
</Table>
</div>Dialog, menu, tooltip
Usage and source contract
Use the existing Radix dialog/menu/tooltip wrappers. Dialogs require an accessible title and focus return; tooltips never carry essential content alone.
Primary source: src/components/ds/PrimitiveDemos.astro
src/components/islands/DsDialogDemo.tsx
src/components/islands/DsTooltipDemo.tsx
src/components/islands/PanelMenu.tsx
src/components/islands/PreRead.tsx
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<div class="flex flex-wrap items-center gap-3">
<DsDialogDemo client:visible open={t(locale, 'ds.dialogOpen')} title={t(locale, 'ds.dialogTitle')} body={t(locale, 'ds.dialogBody')} close={t(locale, 'ds.close')} />
<PanelMenu client:visible label={t(locale, 'ds.menuLabel')} items={[{label: t(locale, 'ds.menuAll'), href: '/work/'}, {label: t(locale, 'ds.menuCv'), href: t(locale, 'nav.cvHref')}]} />
<DsTooltipDemo client:visible trigger={t(locale, 'ds.tooltipTrigger')} text={t(locale, 'ds.tooltip')} />
<PreRead client:visible trigger={t(locale, 'preread.open')} title={t(locale, 'preread.title')} intro={t(locale, 'preread.intro')} items={[t(locale, 'preread.1'), t(locale, 'preread.2'), t(locale, 'preread.3')]} closeLabel={t(locale, 'ds.close')} />
</div>SegmentSwitcher
Usage and source contract
Use links for navigation and buttons for in-page choices. Exactly one current/pressed item.
Primary source: src/components/SegmentSwitcher.astro
Variants: mode: links | buttons
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<div class="flex flex-wrap items-center gap-6">
<SegmentSwitcher name="lang-demo" mode="links" label={t(locale, 'lang.label')} items={[{value: 'de', label: 'DE', lang: 'de', href: localePath('de', '/design-system/'), current: locale === 'de'}, {value: 'en', label: 'EN', lang: 'en', href: localePath('en', '/design-system/'), current: locale === 'en'}]} />
<SegmentSwitcher name="theme-demo" mode="buttons" label={t(locale, 'switch.theme')} items={[{value: 'system', label: t(locale, 'theme.system'), current: true}, {value: 'light', label: t(locale, 'theme.light')}, {value: 'dark', label: t(locale, 'theme.dark')}]} />
</div>Shortcuts
Chapters CPre-read KRead the case RStory S / W
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/Keycap.astro
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<div class="flex flex-col gap-4"><div class="flex items-center gap-2 text-xs text-ink-muted"><Keycap>C</Keycap><Keycap>K</Keycap><Keycap>S</Keycap><Keycap>W</Keycap><Keycap>L</Keycap><Keycap>T</Keycap><Keycap title="Enter">↵</Keycap><Keycap>Esc</Keycap><Keycap>?</Keycap></div><p class="flex flex-wrap items-center gap-6 text-xs text-ink-muted"><span class="inline-flex items-center gap-2">{t(locale,'case.chapters')} <Keycap>C</Keycap></span><span class="inline-flex items-center gap-2">{t(locale,'case.preRead')} <Keycap>K</Keycap></span><span class="inline-flex items-center gap-2">{t(locale,'case.readCase')} <Keycap>R</Keycap></span><span class="inline-flex items-center gap-2">Story <Keycap>S</Keycap> / <Keycap>W</Keycap></span></p></div>Switch · Radix
Usage and source contract
Use the existing Radix Switch with a visible label and controlled on/off semantics.
Primary source: src/components/ui/switch.tsx
src/components/islands/SwitchDemo.tsx
Variants: checked | unchecked · disabled
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<SwitchDemo client:load label={t(locale,'keys.enabled')}/>KeyboardHelp
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/islands/KeyboardHelp.tsx
src/components/Keycap.astro
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<button hidden type="button" data-keyboard-help aria-haspopup="dialog" aria-expanded="false" aria-keyshortcuts="?" class="inline-flex min-h-8 items-center gap-2 rounded-control border border-line px-3 text-sm hover:bg-sunken focus-visible:outline-2 focus-visible:outline-ring"><Keycap>?</Keycap>{t(locale,'island.label')}</button>
<KeyboardHelp client:load title={t(locale,'island.label')} close={t(locale,'case.close')} enabled={t(locale,'keys.enabled')} hint={t(locale,'keys.hint')} native={t(locale,'keys.native')} sections={{reading:t(locale,'keys.reading'),page:t(locale,'keys.page'),focus:t(locale,'keys.focus')}} shortcuts={[{key:'?',label:t(locale,'keys.help')},{key:'L',label:t(locale,'island.lang')},{key:'T',label:t(locale,'island.theme')}]}/>Metadata chip
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/ds/ControlDemos.astro
src/components/ui/badge.tsx
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<div class="flex flex-wrap gap-2"><Badge tone="meta">Figma Make</Badge><Badge tone="meta">Claude Code</Badge><Badge tone="meta">Lovable</Badge></div>Glossary term
Every action with an effect passes the
Usage and source contract
Reuse this composition from its source and demo. Keep its existing semantic structure and locale/data contracts.
Primary source: src/components/islands/Term.tsx
States: default · keyboard focus where interactive · light / dark · reduced motion
- Use native semantics and visible keyboard focus.
- Check 320px, long content and both themes.
<p class="max-w-text">{t(locale, 'term.before')}<Term client:visible term={t(locale, 'term.word')} title={t(locale, 'term.title')} body={t(locale, 'term.body')} />{t(locale, 'term.after')}</p>