Foundations
Typography
Headings, text, quotes, code, links, lists and prose on one type scale.
npx shadcn-svelte@latest add http://localhost:5173/r/typography.json Headings
level sets the element (h1–h6); size sets the look, so a document outline never dictates visual size.
Display
Heading 1 — title-1
Heading 2 — title-2
Heading 3 — title-3
Heading 4 — headline
An h2 at headline size, muted
Display
Heading 1 — title-1
Heading 2 — title-2
Heading 3 — title-3
Heading 4 — headline
An h2 at headline size, muted
Text
Lead introduces a page with a larger, quieter voice.
Body text is set at 16px with relaxed line-height and pretty wrapping, so paragraphs end without lonely words.
Callout is the size of controls and menus.
Footnote carries descriptions and helper text.
Caption · metadata · 2 min ago
Small, for fine print with weight.Lead introduces a page with a larger, quieter voice.
Body text is set at 16px with relaxed line-height and pretty wrapping, so paragraphs end without lonely words.
Callout is the size of controls and menus.
Footnote carries descriptions and helper text.
Caption · metadata · 2 min ago
Small, for fine print with weight.Inline elements
Run pnpm build, then press ⌘ R. Inline code scales with its text: lead-sized. Links in text are always underlined; a standalone link only
on hover; external links open in a new tab.
Run pnpm build, then press ⌘ R. Inline code scales with its text: lead-sized. Links in text are always underlined; a standalone link only
on hover; external links open in a new tab.
Quote and lists
Simplicity is not the absence of clutter; that's a consequence of simplicity.
- Calm and precise
- Physical motion
- Concentric radii
- Install the theme
- Add components
- Ship
Simplicity is not the absence of clutter; that's a consequence of simplicity.
- Calm and precise
- Physical motion
- Concentric radii
- Install the theme
- Add components
- Ship
Prose
Raw HTML or rendered Markdown gets the same type scale as the components above.
Release 2.4
This release focuses on speed and polish. Read the migration guide before upgrading.
Highlights
- Menus open in
200msand close in150ms. - Buttons respond to presses with a subtle scale.
- New ⌘ K command palette.
Details are not the details. They make the design.
Breaking changes
- The
sizeprop now acceptssm,defaultandlg. - Icons default to 16px.
npx shadcn-svelte@latest add http://localhost:5173/r/button.json
| Metric | Before | After |
|---|---|---|
| Bundle | 48.2 kB | 31.7 kB |
| First paint | 1.21 s | 0.84 s |
Thanks to everyone who reported issues.
Release 2.4
This release focuses on speed and polish. Read the migration guide before upgrading.
Highlights
- Menus open in
200msand close in150ms. - Buttons respond to presses with a subtle scale.
- New ⌘ K command palette.
Details are not the details. They make the design.
Breaking changes
- The
sizeprop now acceptssm,defaultandlg. - Icons default to 16px.
npx shadcn-svelte@latest add http://localhost:5173/r/button.json
| Metric | Before | After |
|---|---|---|
| Bundle | 48.2 kB | 31.7 kB |
| First paint | 1.21 s | 0.84 s |
Thanks to everyone who reported issues.