Foundations
Colors
Neutral surfaces and text, one blue accent, three status colours with soft fills and five muted card tones. Every value comes from the Penpot token set statix.
Use the semantic utilities in the table further down (bg-card, text-muted-foreground, bg-primary). The swatches show the raw --sx-color-* tokens behind them. Each swatch lists the hex value from the Penpot
export and the OKLCH value that tokens.css ships.
Surfaces & text
Page and card fills, hairlines and the three text steps. Ink is the brand navy.
bg
#F9FAFB
oklch(0.9846 0.0017 247.84)
bg-2
#EFF1F5
oklch(0.9578 0.0058 264.53)
surface
#FFFFFF
oklch(1 0 0)
white
#FFFFFF
oklch(1 0 0)
line
#DDDFE4
oklch(0.9036 0.0071 268.54)
line-strong
#C7CAD3
oklch(0.8394 0.0129 271.26)
muted
#6B6E7C
oklch(0.5405 0.0221 276.04)
ink-2
#393B50
oklch(0.3594 0.0364 280.16)
ink
#131130
oklch(0.2007 0.0598 282.49)
Accent
The deep blue is for primary actions, links and focus rings. brand is the logo blue; only the logo uses it.
accent
#243BBB
oklch(0.4293 0.2006 267.96)
accent-hover
#1A29A2
oklch(0.3699 0.1909 268.12)
accent-soft
#DDE5FF
oklch(0.9238 0.0364 272.07)
accent-ink
#122172
oklch(0.3003 0.1392 267.91)
brand
#0B86FF
oklch(0.6285 0.2033 255.01)
Status
Success, warning and danger. Each has a soft fill for badges and banners and a dark ink for text on that fill.
ok
#06915F
oklch(0.58 0.1298 160.05)
ok-soft
#D9F7E5
oklch(0.9496 0.0394 159.25)
ok-ink
#065A3D
oklch(0.4146 0.0878 162.48)
warn
#CD9130
oklch(0.6993 0.1301 74.9)
warn-soft
#FFEFCD
oklch(0.9562 0.0476 85.79)
warn-ink
#7A4E0B
oklch(0.4629 0.0953 70.39)
danger
#C92F33
oklch(0.5507 0.1902 24.94)
danger-soft
#FFE7E4
oklch(0.9465 0.0267 26.18)
danger-ink
#8F1F23
oklch(0.4289 0.1474 24.39)
Card tones
Muted fills for feature cards. They carry white text.
tone-navy
#223068
oklch(0.3309 0.0995 269.7)
tone-plum
#553B65
oklch(0.3996 0.0754 311.75)
tone-moss
#245240
oklch(0.4004 0.0597 165.52)
tone-clay
#8A5336
oklch(0.4987 0.085 47.87)
tone-slate
#394353
oklch(0.3805 0.0305 259.74)
Semantic variables
Components never read the raw tokens. They use the shadcn names from theme.css, and Tailwind turns those into utilities. Every colour works with any
colour utility (bg-, text-, border-, ring-, fill-). The table lists the one you need most often.
Note that accent is shadcn's quiet hover fill. The brand blue is primary.
| Semantic variable | Token | Utility |
|---|---|---|
--background | --sx-color-bg | bg-background |
--foreground | --sx-color-ink | text-foreground |
--card | --sx-color-surface | bg-card |
--card-foreground | --sx-color-ink | text-card-foreground |
--popover | --sx-color-surface | bg-popover |
--popover-foreground | --sx-color-ink | text-popover-foreground |
--primary | --sx-color-accent | bg-primary |
--primary-hover | --sx-color-accent-hover | bg-primary-hover |
--primary-foreground | --sx-color-white | text-primary-foreground |
--primary-soft | --sx-color-accent-soft | bg-primary-soft |
--primary-soft-foreground | --sx-color-accent-ink | text-primary-soft-foreground |
--secondary | --sx-color-bg-2 | bg-secondary |
--secondary-foreground | --sx-color-ink | text-secondary-foreground |
--muted | --sx-color-bg-2 | bg-muted |
--muted-foreground | --sx-color-muted | text-muted-foreground |
--accent | --sx-color-bg-2 | bg-accent |
--accent-foreground | --sx-color-ink | text-accent-foreground |
--ink | --sx-color-ink | text-ink |
--ink-2 | --sx-color-ink-2 | text-ink-2 |
--destructive | --sx-color-danger | bg-destructive |
--destructive-foreground | --sx-color-white | text-destructive-foreground |
--destructive-soft | --sx-color-danger-soft | bg-destructive-soft |
--destructive-soft-foreground | --sx-color-danger-ink | text-destructive-soft-foreground |
--success | --sx-color-ok | bg-success |
--success-foreground | --sx-color-white | text-success-foreground |
--success-soft | --sx-color-ok-soft | bg-success-soft |
--success-soft-foreground | --sx-color-ok-ink | text-success-soft-foreground |
--warning | --sx-color-warn | bg-warning |
--warning-foreground | --sx-color-ink | text-warning-foreground |
--warning-soft | --sx-color-warn-soft | bg-warning-soft |
--warning-soft-foreground | --sx-color-warn-ink | text-warning-soft-foreground |
--brand | --sx-color-brand | bg-brand |
--border | --sx-color-line | border-border |
--border-strong | --sx-color-line-strong | border-border-strong |
--input | --sx-color-line-strong | border-input |
--ring | --sx-color-accent | ring-ring |
--tone-navy | --sx-color-tone-navy | bg-tone-navy |
--tone-plum | --sx-color-tone-plum | bg-tone-plum |
--tone-moss | --sx-color-tone-moss | bg-tone-moss |
--tone-clay | --sx-color-tone-clay | bg-tone-clay |
--tone-slate | --sx-color-tone-slate | bg-tone-slate |
--chart-1 | --sx-color-accent | bg-chart-1 |
--chart-2 | --sx-color-ok | bg-chart-2 |
--chart-3 | --sx-color-warn | bg-chart-3 |
--chart-4 | --sx-color-tone-plum | bg-chart-4 |
--chart-5 | --sx-color-tone-clay | bg-chart-5 |
--sidebar | --sx-color-surface | bg-sidebar |
--sidebar-foreground | --sx-color-ink | text-sidebar-foreground |
--sidebar-primary | --sx-color-accent | bg-sidebar-primary |
--sidebar-primary-foreground | --sx-color-white | text-sidebar-primary-foreground |
--sidebar-accent | --sx-color-bg-2 | bg-sidebar-accent |
--sidebar-accent-foreground | --sx-color-ink | text-sidebar-accent-foreground |
--sidebar-border | --sx-color-line | bg-sidebar-border |
--sidebar-ring | --sx-color-accent | bg-sidebar-ring |
Usage
- Separate areas with fills (
bg-secondaryonbg-background) and 1px hairlines. Keep shadows faint. - Use
bg-primaryfor the one main action per screen. Everything else is ink, outline or ghost. - Pair status colours with their soft fill:
bg-success-soft text-success. - Put white text on card tones only (
bg-tone-navy text-white). - Never use raw hex or Tailwind palette colours like
bg-blue-600. Alpha tints of ink (bg-ink/[0.05]) are fine for hovers.
<div class="rounded-card bg-card p-6 text-foreground shadow-card">
<p class="text-label text-muted-foreground">Website</p>
<p class="text-title">yoga-berger.de</p>
<span class="rounded-full bg-success-soft px-2.5 py-0.5 text-label text-success">Online</span>
</div>