Design system v1.0
Fresh coffee, brought to you.
One set of tokens drives the landing page, the customer app and the business dashboard. Warm, crafted, unfussy.
Logo
A crema swirl inside a cup seen from above, paired with a lowercase Fraunces wordmark. Keep clear space equal to the swirl's stroke width x 3.
Colour
Click a swatch to copy its hex. Ember Dark is the action fill (white text, AA). Ember itself is for icons, charts, focus and large display type only. Use Espresso text on Crema and Steam.
Pairings that pass AA
Type
Fraunces for voice, Inter for work. Use tabular numerals for money and times.
72 displayBook a barista52 h1Your event, caffeinated38 h2Choose your setup28 h3Office espresso bar22 leadTwo baristas, one bar, three hours.16 bodyWe bring beans, milk, cups and a very patient barista.14 smallFree reschedule up to 48 hours before.12 captionSAT 14 DEC, 9:30 AM, $1,240.00Spacing, radius, shadow
4px base unit.
Components
Buttons
Form fields
Status badges
Booking card
Sat 14 Dec, 9:30 am
Wedding cart
2 baristas, 4 hours, Yarra Valley
Icons
Lucide, 1.75px stroke, round caps, 20 or 24px, Espresso or Ember. Never filled.
Tokens and the dashboard
The static pages read shared/tokens.css. The shadcn dashboard maps the same values onto its semantic variables in dashboard/src/index.css, so nothing is redefined by hand per screen.
| Brand token | Static CSS variable | shadcn variable |
|---|---|---|
| Milk | --c-milk | --background |
| Espresso | --c-espresso | --foreground, --sidebar |
| Ember Dark | --c-ember-dark | --primary |
| Ember | --c-ember | --ring, --chart-1 |
| Steam | --c-steam | --secondary, --muted |
| Crema | --c-crema | --chart-2, --sidebar-primary |
| Sage / Honey / Berry | --c-sage etc. | --sage, --honey, --destructive |
| Radius 12px, pill buttons | --radius, --radius-pill | --radius, buttons use rounded-full |
Dark surface (dashboard)
Dashboard defaults to light. Dark mode keeps the same hues on a warm espresso ground, never neutral grey.
Imagery
Flat, warm illustration with a 5px Espresso outline, Crema highlights and one Ember accent. Steam rises, always slowly.
Motion
Pour, don't pop. Things settle with cubic-bezier(.2,.8,.2,1). UI motion 150 to 400 ms, ambient up to 4 s. Reduced motion collapses every duration to near zero and stops loops.
Pour
Fill levels ease out like liquid. 600 ms.
Steam
Ambient, slow, upward. 4 s loop.
Press
Scale to 0.97 in 150 ms.
Your system reduced-motion setting: checking
Voice and copy
Like a barista who remembers your order: warm, a bit cheeky, always clear. Short sentences, verbs first, real numbers. No exclamation spam, no jargon.
Say
- "Book a barista in under a minute."
- "You're booked. We'll bring the beans."
- "Plans change. Pick a new time, no fee up to 48 hours before."
- "Nothing brewing yet. Book your first barista."
Avoid
- "Revolutionary beverage solutions!!!"
- "Error 409: slot conflict."
- "Your reservation has been successfully processed."
Errors stay plain: "That slot just got taken. Here are three nearby times."
Tone by surface
| Surface | Tone | Example |
|---|---|---|
| Landing | Playful | Your event, properly caffeinated. |
| Confirmation | Calm, exact | Sat 14 Dec, 9:30 am. 2 baristas. $1,240.00. |
| Dashboard | Plain, fast | 3 baristas free Friday. Assign a booking. |