Design system v1

Doppio style guide

One system for the landing page, the customer app and the operator dashboard. Warm, high-contrast and calm: a head barista, not a tech startup. Tokens live in shared/tokens.css; the dashboard mirrors them as shadcn variables.

Pour, not pop

Motion eases out like liquid and settles. Nothing bounces for show.

Warm, never grey

Neutrals are browns. Surfaces feel like paper and crema.

Certainty first

Who, when, how much: always visible before a commitment.

Colour

Roasted, with one bright note

Copper is the only loud colour and is reserved for the primary action and key numbers. Use Copper Deep for small text on light surfaces.

Contrast pairings

Type

A soft serif with a clear sans

Fraunces gives headlines warmth and character. Inter keeps interfaces legible. JetBrains Mono is for times and booking references. Scale ratio 1.25 from 16px; display sizes are fluid.

Spacing, radius, shadow

A 4px grid with soft corners

Space in multiples of four. Corners are generous, matching cups and cards in hand.

Radius

Shadow

Components

The building blocks

Buttons

Badges

ConfirmedPendingCancelledDraftNew

Fields

We put this on your barista's brief.
Add at least 1 guest so we can size your setup.

Chips

Appointment card

ConfirmedDPO-2041

Product launch, Fitzroy

Fri 21 Nov, 8:30 am to 11:30 am
Priya N. with the espresso cart

Nothing brewing yet

Book your first barista and it'll appear here.

Iconography

Rounded, 1.75px, one copper accent

24px grid, round caps and joins. One filled copper detail per icon at most. In the dashboard we use Lucide, which matches this weight.

Cup
Cart
Bean
Date
Guests
Time
Rating
Done

Motion

Liquid easing, one flourish per flow

Durations: fast 160ms (hover, press), base 280ms (state change), slow 520ms (entrance, confirmation). Ambient loops are slow and vertical. With reduced motion, durations collapse to 1ms and loops stop.

Pour (slow, ease-pour) for confirmations.

Slide in (800ms, ease-pour) for sheets and cards.

Steam (4.2s loop) is ambient only, off for reduced motion.

--ease-pour: cubic-bezier(.22,1,.36,1)

Product UI and dashboard

Same palette, quieter voice

The operator dashboard is built with shadcn (base-nova) and themed from these tokens in dashboard/src/index.css. It is an Operate surface: Fraunces appears only in page titles and big numbers; everything else is Inter. Light is the default; dark is a toggle. Expression lives in colour and detail, not decoration.

Token mapping

shadcn variableDoppio token
Colour (and dark-mode note)
--background--bg
Crema (Espresso-dark #2A1810 tint in dark mode)
--card, --popover--surface
Foam (Raised espresso in dark mode)
--foreground--ink
Espresso (Crema in dark mode)
--primary--c-copper-deep
Copper Deep (Lighter copper in dark mode for contrast)
--secondary, --accent--c-latte
Latte (Roast in dark mode)
--muted-foreground--ink-2
Bark (Warm stone in dark mode)
--destructive--c-berry
Berry (Lifted berry in dark mode)
--success / --warning--ok / --warn
Pistachio / Saffron (Used only for status badges)
--sidebar--c-espresso
Espresso (Always dark, in both themes)
--radius--r-md
14px (0.875rem; controls use radius scale)

Status language

Status is always colour plus a text label, never colour alone.

ConfirmedPendingCancelledCompleted On shiftAvailableOff today

Stat card and schedule block

Utilisation 65%
119 of 184 roster hours
Schedule block, one tint per barista
Product launch
Priya · 8:30 am
Level 4 morning
Tom · 9:00 am

Dark theme

doppio.
Background, card #2c1f18, primary #e0814f

Dashboard rules

Numbers first

Stat cards lead with the figure in Fraunces; the label is quiet Inter.

Act where you read

Pending rows carry Confirm and Cancel inline. No dead buttons.

Empty states say what to do

"No one rostered. Add a barista to start taking bookings."

Voice and copy

Warm, short, quietly expert

We sound like the head barista: knows the craft, never snobbish. Short sentences. Plain words. en-AU spelling, sentence case, no em-dashes, exclamation marks only for the confirmation moment.

Do

"Book a barista. We bring the bar."

Don't

"Leverage our premium beverage service solutions!"

Do

"That slot just got taken. Here are the closest times."

Don't

"Error 409: booking conflict."

Microcopy library