Search documentation

Search guides, examples, and component APIs.

Quick links
↑↓ NavigateEnter OpenEsc Close
Get started

Blocks / Settings

Appearance settings

Theme picker with light, dark, and system thumbnails, a live app-window preview, text size, density, language, and accessibility switches with a sticky save bar.

bunx --bun @getweini/cli@latest add button card radio-group select slider switch toggle-group visually-hidden
Customize
  • The settings shell (workspace header, grouped section nav with `aria-current`, and the back link) is identical across the four settings blocks, so the pages read as one product. Its labels live in `copy.nav`; it becomes a scrolling row of sections below 1024px.
  • The block is controlled. Pass the saved values in `appearance`; it keeps an editable copy, shows the unsaved state, and emits `save` with the full object or `reset` after restoring the baseline.
  • The thumbnails and the preview window use the `.light` and `.dark` classes, which re-scope the theme tokens to that subtree, so each theme is drawn with its real colors. Applying the choice to your app is yours: listen to `save` and update the root class or root font size.
  • Theme cards are native radios inside `RadioGroup`; each label stretches over its card. Density is a single-choice `ToggleGroup`, and the two accessibility preferences are `Switch` rows.
  • The visually hidden status line is the accessible twin of the preview: it announces the new size and density as they change. Every visible string lives in the `copy` prop.