Changelog

What's new in the Avesk design system.

  1. v0.11.1Latest

    Component audit fixes

    • ImprovedDark mode: checkbox ticks, Apple and X logos, the switch thumb, file-format tags and status marks all stay readable.
    • ImprovedForms: ChoiceChip looks selected with defaultChecked, NumberField submits the plain number, Select keeps onChange with a ref (react-hook-form), and "Last 7 days" covers exactly 7 days.
    • ImprovedOne focus outline everywhere, one CloseButton, and tooltips and the notification bell in the top layer so nothing crops them.
    • ImprovedToasts show above open dialogs and drawers, queue instead of dropping, wait for you when they have an action, and announce errors at once.
    • ImprovedKeyboard: Tabs always keep a tab stop, filter pills use arrow keys, Pagination shows the first and last page, and the command menu's "See all" can be reached.
    • NewDateRangePicker surface="inline", Rating half stars, DialogBody, and npm run registry:sync, which keeps the registry in step with the code.
    • ChangedAtomic levels corrected (NumberField is a molecule; Table, ColorPicker, Pagination and the settings, notification, auth and agent-limits cards are organisms). audit:ds now checks that no component uses a higher level.
    • Improvednpx avesk-ui init now copies scripts/registry-sync.mjs, so npm run audit:ds works in new projects.
  2. v0.11.0

    Table on React Aria

  3. v0.10.0

    Playground, Bar chart card and smoother motion

  4. v0.9.0

    Install components one at a time

    • Newnpx avesk-ui add <component>: copies a component plus only the files it imports, its docs page and icons if needed; sets up tokens, cn() and packages the first time.
    • Newnpx avesk-ui list shows every component you can add, by category.
    • NewInstallation section on every component page: the add command for npm, pnpm, yarn and bun, or the exact files to copy by hand.
  5. v0.8.2

    Theme tokens audit

    • ImprovedShadows now change with the theme: focus rings, popovers, dialogs and the slider thumb are built from colour variables.
    • ImprovedStronger dark tints, so focus borders and medium badges read clearly on dark.
    • ImprovedChart colours, the row highlight and the neutral gradients follow the theme too; no literal colours left outside tokens.
  6. v0.8.1

    Security headers

    • ImprovedThe site sends a Content Security Policy: only its own scripts, styles, images and fonts, no framing by other sites.
    • ImprovedStandard security headers (nosniff, referrer policy, camera/mic/location off, HSTS in production); the X-Powered-By header is gone.
    • ChangedTests run on Vitest 5, which clears six security advisories in the test tools; Node 22.12 or newer is now required.
  7. v0.8.0

    Dark mode

  8. v0.7.0
  9. v0.6.0
  10. v0.5.0

    New docs site

  11. v0.4.0
  12. v0.1.0

    First release

    • NewAvesk design system: tokens, components, playbook and docs.

Menu

Foundations

The tokens every component is built on: colour, type, spacing, corners, shadows, breakpoints and the accessibility rules. Each component has its own page under Components.

Colours

tokens.css

Every colour style from the Figma Design system page (108:4758). Each chip reads its colour from the browser and checks it against the Figma value.

Brand · 8 styles

Brand/25

…

Brand/50

…

Brand/100

…

Brand/200

…

Brand/300

…

Brand/600

…

Brand/700

…

Brand/800

…

Base · 2 styles

Base/White

…

Base/Black

…

Neutral · 11 styles

Neutral/50

…

Neutral/100

…

Neutral/200

…

Neutral/300

…

Neutral/400

…

Neutral/500

…

Neutral/600

…

Neutral/700

…

Neutral/800

…

Neutral/900

…

Neutral/950

…

Red · 11 styles

Red/50

…

Red/100

…

Red/200

…

Red/300

…

Red/400

…

Red/500

…

Red/600

…

Red/700

…

Red/800

…

Red/900

…

Red/950

…

Yellow · 11 styles

Yellow/50

…

Yellow/100

…

Yellow/200

…

Yellow/300

…

Yellow/400

…

Yellow/500

…

Yellow/600

…

Yellow/700

…

Yellow/800

…

Yellow/900

…

Yellow/950

…

Green · 11 styles

Green/50

…

Green/100

…

Green/200

…

Green/300

…

Green/400

…

Green/500

…

Green/600

…

Green/700

…

Green/800

…

Green/900

…

Green/950

…

Sky · 11 styles

Sky/50

…

Sky/100

…

Sky/200

…

Sky/300

…

Sky/400

…

Sky/500

…

Sky/600

…

Sky/700

…

Sky/800

…

Sky/900

…

Sky/950

…

Blue · 11 styles

Blue/50

…

Blue/100

…

Blue/200

…

Blue/300

…

Blue/400

…

Blue/500

…

Blue/600

…

Blue/700

…

Blue/800

…

Blue/900

…

Blue/950

…

Purple · 11 styles

Purple/50

…

Purple/100

…

Purple/200

…

Purple/300

…

Purple/400

…

Purple/500

…

Purple/600

…

Purple/700

…

Purple/800

…

Purple/900

…

Purple/950

…

Pink · 11 styles

Pink/50

…

Pink/100

…

Pink/200

…

Pink/300

…

Pink/400

…

Pink/500

…

Pink/600

…

Pink/700

…

Pink/800

…

Pink/900

…

Pink/950

…

Rose · 11 styles

Rose/50

…

Rose/100

…

Rose/200

…

Rose/300

…

Rose/400

…

Rose/500

…

Rose/600

…

Rose/700

…

Rose/800

…

Rose/900

…

Rose/950

…

Slate · 11 styles

Slate/50

…

Slate/100

…

Slate/200

…

Slate/300

…

Slate/400

…

Slate/500

…

Slate/600

…

Slate/700

…

Slate/800

…

Slate/900

…

Slate/950

…

Gradients · 6 neutral styles (Brand gradients are still purple in Figma, not added)

Neutral/600 → 500 (90°)

Neutral/700 → 600 (45°)

Neutral/800 → 600 (45°)

Neutral/800 → 600 (90°)

Neutral/800 → 700 (26.5°)

Neutral/900 → 600 (45°)

Product tokens (not Figma styles)

page

…

tab-indicator

…

logo

…

avatar

…

chart-spent

…

chart-budget

…

chart-muted

…

red-25

…

Typography

tokens.css

Text roles by purpose, built only from the Figma text styles. Use the role class (type-title-h3, type-paragraph-sm…) in screens. The full set of 44 Figma styles is below for reference.

Text roles · Inter

Inter for titles

Page and section headings. Medium weight; H1 stops at 30px for a calm dashboard.

Title H1 · type-title-h1

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaDisplay sm / Medium

Title H2 · type-title-h2

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaDisplay xs / Medium

Title H3 · type-title-h3

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText xl / Medium

Title H4 · type-title-h4

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText lg / Medium

Title H5 · type-title-h5

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText md / Medium

Title H6 · type-title-h6

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText sm / Medium

Inter for labels

Buttons, field labels, tabs, table headers, menu items.

Label LG · type-label-lg

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText md / Medium

Label MD · type-label-md

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText sm / Medium

Label SM · type-label-sm

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText xs / Medium

Inter for paragraphs

Body text, descriptions, hints and captions.

Paragraph LG · type-paragraph-lg

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText lg / Regular

Paragraph MD · type-paragraph-md

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText md / Regular

Paragraph SM · type-paragraph-sm

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText sm / Regular

Paragraph XS · type-paragraph-xs

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText xs / Regular

Inter for subheadings

Small uppercase labels that group content, like BASICS in a form.

Subheading MD · type-subheading-md

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText sm / Semibold

Subheading SM · type-subheading-sm

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText xs / Semibold

Inter for docs

Long reading such as briefs and proposals. Space paragraphs by one font size (16px).

Doc label · type-doc-label

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText md / Semibold

Doc paragraph · type-doc-paragraph

The quick brown fox jumps over the lazy dog.

Font size…Line height…Letter spacing…Weight…FigmaText md / Regular
All 44 Figma text stylesDisplay 2xl–xs and Text xl–xs in Regular, Medium, Semibold and Bold, each checked live against Figma. Display lg and larger are for marketing pages only.

Display 2xl/Regular

text-display-2xl font-normal

Every project in one place

72/90 · 400 · -2%

Display 2xl/Medium

text-display-2xl font-medium

Every project in one place

72/90 · 500 · -2%

Display 2xl/Semibold

text-display-2xl font-semibold

Every project in one place

72/90 · 600 · -2%

Display 2xl/Bold

text-display-2xl font-bold

Every project in one place

72/90 · 700 · -2%

Display xl/Regular

text-display-xl font-normal

Every project in one place

60/72 · 400 · -2%

Display xl/Medium

text-display-xl font-medium

Every project in one place

60/72 · 500 · -2%

Display xl/Semibold

text-display-xl font-semibold

Every project in one place

60/72 · 600 · -2%

Display xl/Bold

text-display-xl font-bold

Every project in one place

60/72 · 700 · -2%

Display lg/Regular

text-display-lg font-normal

Every project in one place

48/60 · 400 · -2%

Display lg/Medium

text-display-lg font-medium

Every project in one place

48/60 · 500 · -2%

Display lg/Semibold

text-display-lg font-semibold

Every project in one place

48/60 · 600 · -2%

Display lg/Bold

text-display-lg font-bold

Every project in one place

48/60 · 700 · -2%

Display md/Regular

text-display-md font-normal

Every project in one place

36/44 · 400 · -2%

Display md/Medium

text-display-md font-medium

Every project in one place

36/44 · 500 · -2%

Display md/Semibold

text-display-md font-semibold

Every project in one place

36/44 · 600 · -2%

Display md/Bold

text-display-md font-bold

Every project in one place

36/44 · 700 · -2%

Display sm/Regular

text-display-sm font-normal

Every project in one place

30/38 · 400

Display sm/Medium

text-display-sm font-medium

Every project in one place

30/38 · 500

Display sm/Semibold

text-display-sm font-semibold

Every project in one place

30/38 · 600

Display sm/Bold

text-display-sm font-bold

Every project in one place

30/38 · 700

Display xs/Regular

text-display-xs font-normal

Every project in one place

24/32 · 400

Display xs/Medium

text-display-xs font-medium

Every project in one place

24/32 · 500

Display xs/Semibold

text-display-xs font-semibold

Every project in one place

24/32 · 600

Display xs/Bold

text-display-xs font-bold

Every project in one place

24/32 · 700

Text xl/Regular

text-xl font-normal

Every project in one place

20/30 · 400

Text xl/Medium

text-xl font-medium

Every project in one place

20/30 · 500

Text xl/Semibold

text-xl font-semibold

Every project in one place

20/30 · 600

Text xl/Bold

text-xl font-bold

Every project in one place

20/30 · 700

Text lg/Regular

text-lg font-normal

Every project in one place

18/28 · 400

Text lg/Medium

text-lg font-medium

Every project in one place

18/28 · 500

Text lg/Semibold

text-lg font-semibold

Every project in one place

18/28 · 600

Text lg/Bold

text-lg font-bold

Every project in one place

18/28 · 700

Text md/Regular

text-md font-normal

Every project in one place

16/24 · 400

Text md/Medium

text-md font-medium

Every project in one place

16/24 · 500

Text md/Semibold

text-md font-semibold

Every project in one place

16/24 · 600

Text md/Bold

text-md font-bold

Every project in one place

16/24 · 700

Text sm/Regular

text-sm font-normal

Every project in one place

14/20 · 400

Text sm/Medium

text-sm font-medium

Every project in one place

14/20 · 500

Text sm/Semibold

text-sm font-semibold

Every project in one place

14/20 · 600

Text sm/Bold

text-sm font-bold

Every project in one place

14/20 · 700

Text xs/Regular

text-xs font-normal

Every project in one place

12/18 · 400

Text xs/Medium

text-xs font-medium

Every project in one place

12/18 · 500

Text xs/Semibold

text-xs font-semibold

Every project in one place

12/18 · 600

Text xs/Bold

text-xs font-bold

Every project in one place

12/18 · 700

Spacing

tokens.css

4px grid: class number × 4 = pixels (p-4 = 16px). Orange = full steps; light = 2px half steps, only inside components where Figma uses them.

Scale

0.52px · half
14px
1.56px · half
28px
2.510px · half
312px
3.514px · half
416px
520px
624px
832px
1040px
1248px
1664px
2080px
2496px

Corner radius

tokens.css

One job per step: lg (8px) for controls, xl (12px) for surfaces, full for pills and avatars.

Scale

rounded-xs

2px · Hairline details

rounded-sm

4px · Small tiles

rounded-md

6px · Badges

rounded-lg

8px · Buttons, inputs

rounded-xl

12px · Cards, popovers, dialogs

rounded-2xl

16px · Large panels

rounded-full

full · Pills, avatars

Shadows

tokens.css

Figma's Shadow/xs and focus shadows, plus elevation levels for floating surfaces.

Scale

shadow-xs

Figma Shadow/xs · buttons, inputs, cards

shadow-sm

Knobs

shadow-md

Knobs on hover

shadow-popover

Dropdowns, tooltip, toast

shadow-dialog

Dialog, command menu

shadow-sheet

Side panel

shadow-focus-brand

Focus (brand)

shadow-focus-error

Focus (error)

shadow-focus-neutral

Focus (grey)

Breakpoints

tokens.css

Mobile-first min-width breakpoints taken from the dashboard. Resize the window to watch the active one change. Height variants short: (≤ 820px) and shorter: (≤ 740px) keep onboarding on one screen.

Current window

This window is …px wide → base

(none)≥ 0px
sm:≥ 640px
md:≥ 768px
lg:≥ 1024px
xl:≥ 1280px
2xl:≥ 1536px

Accessibility

PLAYBOOK.md

Target WCAG 2.2 AA. 18 rules in the playbook, summarised here; colour pairs below are measured live. Fails come from Figma colours and wait for an owner decision.

Rules

See it

Text ≥ 4.5:1; controls, meaningful icons and focus ≥ 3:1; never colour alone; works at 200% zoom.

Keyboard

Everything reachable with Tab in order; focus always visible; arrow keys inside tabs, menus, calendars; Escape closes overlays and returns focus.

Screen readers

Visible labels on every input; hints/errors via aria-describedby and aria-invalid; aria-label on icon-only buttons; headings in order; live updates announced.

Comfort

Motion only with motion-safe; targets ≥ 24×24px; links say where they go; errors say how to fix.

Contrast of the colour pairs we use

Body text… : 1 / 4.5…
Hint text… : 1 / 4.5…
Placeholder… : 1 / 4.5…
Inactive tab, (optional)… : 1 / 4.5…
Error text… : 1 / 4.5…
Primary button (owner kept Brand/600)… : 1 / 4.5…
Primary button hover… : 1 / 4.5…
Link… : 1 / 4.5…
Destructive button… : 1 / 4.5…
Input border (UI) — known exception… : 1 / 3…
Focus ring brand-100 (UI) — owner kept… : 1 / 3…
Focus ring neutral-100 (UI) — owner kept… : 1 / 3…
Tab underline (UI)… : 1 / 3…