Design system

Antoni's design system

Every token and component from design-system/, rendered from the JSON at build time. Names match the Figma file, so the same word means the same thing in design and code.

Colors

Semantic roles switch between light and dark. Components use these, never the palette below.

RoleCSS variablelightdark
background--background
#ffffffcolor/white
#09090bcolor/zinc/950
foreground--foreground
#09090bcolor/zinc/950
#fafafacolor/zinc/50
card--card
#ffffffcolor/white
#18181bcolor/zinc/900
card-foreground--card-foreground
#09090bcolor/zinc/950
#fafafacolor/zinc/50
popover--popover
#ffffffcolor/white
#18181bcolor/zinc/900
popover-foreground--popover-foreground
#09090bcolor/zinc/950
#fafafacolor/zinc/50
primary--primary
#2563ebcolor/blue/600
#60a5facolor/blue/400
primary-foreground--primary-foreground
#ffffffcolor/white
#09090bcolor/zinc/950
secondary--secondary
#f4f4f5color/zinc/100
#27272acolor/zinc/800
secondary-foreground--secondary-foreground
#18181bcolor/zinc/900
#fafafacolor/zinc/50
muted--muted
#f4f4f5color/zinc/100
#27272acolor/zinc/800
muted-foreground--muted-foreground
#52525bcolor/zinc/600
#a1a1aacolor/zinc/400
accent--accent
#f4f4f5color/zinc/100
#27272acolor/zinc/800
accent-foreground--accent-foreground
#18181bcolor/zinc/900
#fafafacolor/zinc/50
destructive--destructive
#dc2626color/red/600
#f87171color/red/400
destructive-foreground--destructive-foreground
#ffffffcolor/white
#09090bcolor/zinc/950
success--success
#15803dcolor/green/700
#4ade80color/green/400
success-foreground--success-foreground
#ffffffcolor/white
#09090bcolor/zinc/950
warning--warning
#f59e0bcolor/amber/500
#fbbf24color/amber/400
warning-foreground--warning-foreground
#09090bcolor/zinc/950
#09090bcolor/zinc/950
info--info
#0369a1color/sky/700
#38bdf8color/sky/400
info-foreground--info-foreground
#ffffffcolor/white
#09090bcolor/zinc/950
border--border
#e4e4e7color/zinc/200
#27272acolor/zinc/800
input--input
#71717acolor/zinc/500
#71717acolor/zinc/500
ring--ring
#2563ebcolor/blue/600
#60a5facolor/blue/400
chart-1--chart-1
#2563ebcolor/blue/600
#60a5facolor/blue/400
chart-2--chart-2
#0d9488color/teal/600
#2dd4bfcolor/teal/400
chart-3--chart-3
#7c3aedcolor/violet/600
#a78bfacolor/violet/400
chart-4--chart-4
#ea580ccolor/orange/600
#fb923ccolor/orange/400
chart-5--chart-5
#71717acolor/zinc/500
#a1a1aacolor/zinc/400

Palette (primitives)

zinc
50
100
200
300
400
500
600
700
800
900
950
blue
50
100
200
300
400
500
600
700
800
900
950
green
50
100
200
300
400
500
600
700
800
900
950
amber
50
100
200
300
400
500
600
700
800
900
950
red
50
100
200
300
400
500
600
700
800
900
950
sky
50
100
200
300
400
500
600
700
800
900
950
base
white
black
teal
400
600
violet
400
600
orange
400
600

Spacing

One base unit, --spacing; Tailwind's p-4, gap-2 … multiply it.

TokenTailwindValuePreview
spacing/0p-00px
spacing/0-5p-0.52px
spacing/1p-14px
spacing/2p-28px
spacing/3p-312px
spacing/4p-416px
spacing/5p-520px
spacing/6p-624px
spacing/8p-832px
spacing/10p-1040px
spacing/12p-1248px

Radii

Components use the three theme radii; the full scale is there for the rest.

Theme

radius/sm
--radius-sm · 4px
radius/md
--radius · 6px
radius/lg
--radius-lg · 8px

Scale (primitives)

radius/none
--radius-none · 0px
radius/xs
--radius-xs · 2px
radius/sm
--radius-sm · 4px
radius/md
--radius-md · 6px
radius/lg
--radius-lg · 8px
radius/xl
--radius-xl · 12px
radius/2xl
--radius-2xl · 16px
radius/full
--radius-full · 9999px

Typography

Text styles are utilities: class="type-heading-h1" and so on.

StyleClassSize / weight / lineSample
Displaytype-display30px / 600 / 120%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Heading/H1type-heading-h124px / 600 / 125%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Heading/H2type-heading-h220px / 600 / 130%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Heading/H3type-heading-h316px / 600 / 140%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Body/Defaulttype-body-default14px / 400 / 150%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Body/Strongtype-body-strong14px / 600 / 150%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Labeltype-label14px / 500 / 140%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Smalltype-small12px / 400 / 140%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Small/Strongtype-small-strong12px / 500 / 140%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026
Codetype-code13px / 400 / 150%Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026

Font sizes (primitives)

TokenTailwindValueSample
font-size/xstext-xs12pxZażółć gęślą jaźń
font-size/smtext-sm14pxZażółć gęślą jaźń
font-size/basetext-base16pxZażółć gęślą jaźń
font-size/lgtext-lg18pxZażółć gęślą jaźń
font-size/xltext-xl20pxZażółć gęślą jaźń
font-size/2xltext-2xl24pxZażółć gęślą jaźń
font-size/3xltext-3xl30pxZażółć gęślą jaźń
font-size/4xltext-4xl36pxZażółć gęślą jaźń
--font-sans · IBM Plex Sans

Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026

--font-mono · IBM Plex Mono

Zażółć gęślą jaźń — 1 250,00 zł, 19.11.2026

Control heights

Buttons, inputs and selects share one height, so rows line up.

size/32
size/36
control
size/40
size/44
size/48
TokenCSS variableValueAlias
control/height--control-height36pxsize/36
control/padding-x--control-padding-x12pxspacing/3
control/gap--control-gap8pxspacing/2

Theme

The product's character, in one "default" mode. Restyling for an organization starts here and at --primary / --ring.

TokenCSS variableValueAlias
radius/sm--radius-sm4pxradius/sm
radius/md--radius6pxradius/md
radius/lg--radius-lg8pxradius/lg
control/height--control-height36pxsize/36
control/padding-x--control-padding-x12pxspacing/3
control/gap--control-gap8pxspacing/2
layout/gap--layout-gap16pxspacing/4
layout/padding--layout-padding24pxspacing/6
font-size/body--text-body14pxfont-size/sm
font-size/small--text-small12pxfont-size/xs
stroke/default--border-width1pxborder-width/1
stroke/strong--border-width-strong2pxborder-width/2
stroke/accent--border-width-accent4pxborder-width/4
font/sans--font-sansIBM Plex Sans—
font/mono--font-monoIBM Plex Mono—
stroke/default
stroke/strong
stroke/accent

Shadows

Raised for cards, Overlay for menus and dialogs, Focus ring for keyboard focus.

Elevation/Overlay
--shadow-lg
Elevation/Raised
--shadow-sm
Focus ring
--shadow-focus-ring 2 px background gap + 2 px ring (var(--ring)); in code use outline or ring-2 ring-offset-2

Icons

lucide-react, 16px, stroke 2. The ones the design uses:

Components

41 components in components.json: 25 from shadcn (18 families, working below) and 16 proposed, to build locally when a task needs them.

Button

Buttoncore<Button variant="default|secondary|outline|ghost|destructive|link">

One Primary per view. Secondary is the default. Destructive only for irreversible actions, with a confirm step.

Icon buttoncore<Button size="icon" aria-label="…">

Always an aria-label; tooltip unless the icon is obvious (close, more).

Badge

NowaSzkicArchiwumOdrzucona Zatwierdzona Wymaga uwagi W toku
Badgecore<Badge variant="…">

Status colors only with a word that says the status.

Input

Wpisz kod w formacie 00-000.

Inputcore<Input aria-invalid>

Visible label above, never placeholder-only. Error needs a message that says how to fix it.

Textarea

Textareacore<Textarea>

Visible label above.

Select

Selectcore<Select><SelectTrigger/><SelectContent/></Select>

5+ options. For 2–4 use Radio group.

Select itemcore<SelectItem>
Select menucore<SelectContent>

Checkbox

Checkboxcore<Checkbox checked={true|false|"indeterminate"}/> + <Label>

Whole row is the click target; row height = --control-height.

Radio group

Sposób kontaktu
Radiocore<RadioGroupItem/> + <Label>
Radio groupcore<RadioGroup>

Exactly one checked; group label above.

Switch

Switchcore<Switch/> + <Label>

Takes effect immediately; not inside forms with Submit.

Card

Wniosek o dowód osobisty
Złożony 19.11.2026
Odbiór w urzędzie gminy w ciągu 30 dni. Powiadomimy Cię SMS-em.
Cardcore<Card><CardHeader/><CardContent/><CardFooter/></Card>

No cards inside cards.

Alert

Alertcore<Alert variant="…">

Persistent status. Description says what to do next.

Tabs

Wnioskodawca, adres i dane sprawy.
Tabscore<Tabs><TabsList><TabsTrigger/></TabsList></Tabs>

Exactly one active.

Dialog

Dialogcore<Dialog><DialogContent>…</DialogContent></Dialog>

Primary label repeats the verb ("Wyślij").

Toast

Toastcoretoast.success("…", { description, action })

Bottom-right; errors stay until closed.

Sidebar

Analityk
Widok: Sprawy
Sidebarcore<Sidebar><SidebarMenu><SidebarMenuButton isActive/></SidebarMenu></Sidebar>

Analyst tools; one active item.

Table

NumerWnioskodawcaStatusKwotaAkcje
WN-2026/014219.11.2026Anna WiśniewskaW toku1 250,00 zł
WN-2026/013818.11.2026Józef ŁęckiZatwierdzona320,50 zł
WN-2026/013115.11.2026Małgorzata Żółkiewska-BrzęczyszczykiewiczWymaga uwagi12 800,00 zł
1–3 z 3
Table / Header cellanalyst<TableHead aria-sort>

One sorted column at a time.

Table / Cellanalyst<TableCell>

Mono for IDs; Muted for dates; numbers right-aligned; text truncates with tooltip.

Table / Rowanalyst<TableRow data-state="selected">

Same column widths as the header row.

Table / Header rowanalyst<TableHeader>

First cell selects all (indeterminate when some selected).

Pagination

1–3 z 3
Table / Paginationanalyst<Pagination>

Always under data tables, even with one page.

Form / Field

Na ten adres wyślemy potwierdzenie.

Fieldforms<FormItem><FormLabel/><FormControl/><FormDescription/><FormMessage/></FormItem>

Visible label; mark optional fields; error says how to fix.

Chart

Dane jako tabela
MiesiącZłożoneZatwierdzoneOdrzucone
Lipiec18612022
Sierpień20514130
Wrzesień23716019
Październik17313225
Chart / Bardashboard<ChartContainer> with var(--chart-1…5)

Series colors chart-1…5 in order; legend with words; data also as a table.

Proposed

Not built yet. If time is short, build the Review bar, Source card and Filter bar first.