Skip to content

Design system

Every part this template is built from

Tokens and components, drawn live from the code the pages run on: change a token or a control, and the sheet changes with it.

Foundations

The tokens every page reads

Colour, type, space, shape and motion, each written once and read everywhere.

The surface ladder

app/globals.css

Near-whites a step apart, the page near the top, so cards separate by tint.

Cards--card 
The page--background 
Bands and hovers--accent 
Rows and chips--muted 
The deepest well--secondary 
Hairlines--border 

Brand

One hue in three roles: what a control fills, the primary button, and the ink.

Fill—
A chosen state, progress, a chip--primary 
Action—
The primary button--action 
Ink—
Brand text, the focus ring, an edge--primary-ink 
Chip—
A tint of the fill, under ink--chip-alpha 

The Color row

app/globals.css

Every brand the preset panel offers, as fill, action and ink. Ink is always one.

    Text

    Two levels of text on every rung; anything quieter is set smaller, never fainter.

    Text--foreground 
    Quiet text--muted-foreground 

    Seven accents

    Seven hues that tell peers apart — a chip, a set, a mark — never a second brand.

    leaf
    sun
    coral
    iris
    lime
    sky
    peach

    Contrast

    Measured live in this mode, against the floors: 4.5:1 for text, 3:1 for a focus ring.

    PairRatio
    Text on the page—
    Quiet text on the page—
    Quiet text on a chip—
    A label on the fill—
    The primary button's label—
    Brand ink on the page—
    The focus ring on the page—
    The focus ring on a card—

    Typography

    app/globals.css · --font-heading, --font-sans

    Two faces at most, two weights, two ink levels. Size says how a line is read.

    Heading face 
    Body face 
    • Displayfont-heading · 36 to 60

      Plan less, arrive more

    • Section headingSectionHeading · 30 to 48

      The weekend, sorted

    • Tile titletext-xl · 20

      Free cancellation

    • Body copytext-base · 16

      Change plans up to a day before and the full amount comes back to you.

    • Product objecttext-sm · 14

      Two nights · Breakfast included · From $184

    • Captiontext-xs · 12

      Popular this week

    Spacing and size

    Space around a group exceeds space within it. Controls draw at 40, never under 36.

    Control heights
    36A small or header control
    40Every control by default
    44A section's one call to action
    Gaps
    12Inside a group
    24Between items of a row
    48The header gap, mt-head
    128Between sections, 160 from sm

    Radius and depth

    app/globals.css · --radius, --radius-control

    Corners read against the shortest side; depth is one cue — a hairline or a shadow.

    controlEvery control
    smUnder 48px
    mdA tile
    lgA card
    hairlineResting
    shadow-softLifted
    shadow-soft-lgFloating

    Icons

    HugeIcons for every glyph; Heroicons for arrows, chevrons, play and the rating star.

    Heroicons · four glyphs
    • Arrow
    • Chevron
    • Play
    • Rating star
    HugeIcons · every other glyph
    • Close
    • Check
    • Search
    • Add
    • Menu
    • Save
    • Date
    • Time
    • Place
    • Home
    • Person
    • Message
    • Order
    • Ticket

    Motion

    app/globals.css · --duration-*, --ease-*

    Four named curves, nothing written as a number. Point at a tile to run it.

    answerHover, a colour, a press
    springLetting go of a press
    sheetA drawer, a dialog
    arriveA section revealing once

    Components

    Every control the pages draw

    Each one shown in its variants and its states. A page takes its controls from here.

    Page roles

    components/site · Eyebrow, SectionHeading, Lede

    Every section opens with the same four parts, and a card that goes somewhere is one link.

    How it works

    Three steps from browsing to booked

    Pick what you want, choose a time that suits you, and pay once you are sure. Nothing is charged until you confirm the dates and the price.

    Actions

    Button

    components/ui/button.tsx

    Six variants, three heights, a tile round a picture and a row among a list's links. A press sinks it, and loading keeps its label.

    VariantRestHoverPressedFocusDisabledLoading
    Primary
    Secondary
    Outline
    Ghost
    Destructive
    Link
    Three heights
    sm · 40, compact
    default · 40
    lg · 44, main action
    With a glyph
    Press to load
    A row among links
    row · a command in a sidebar's list
    A tile round a picture
    tile · outline, opens a ticket's code

    Icon button

    components/ui/icon-button.tsx

    One glyph, named by a label its type requires. The 36 draw reaches 40.

    VariantRestHoverPressedFocusDisabledLoading
    Ghost
    Outline
    Secondary
    Primary
    Three sizes
    sm · 36, reaches 40
    default · 40
    lg · 44

    Save toggle

    components/ui/save-toggle.tsx

    Saved is a solid coral heart in every form, and the count moves with the press.

    VariantRestHoverPressedFocus
    Disc
    Disc, saved
    Count
    Count, saved
    Pill
    Pill, saved
    A festival crowd facing a stage lit orange at night
    On a photograph
    Sat 14 Nov · 5:45 AM
    In a card's footer
    Beside a page title

    Toggle button

    components/ui/toggle-button.tsx

    Pressed shows a tick and swaps the fill. Quiet inside a block, lead for a page.

    VariantRestHoverPressedFocusDisabled
    Quiet
    Quiet, pressed
    Lead
    Lead, pressed
    In use

    Share menu

    components/ui/share-menu.tsx

    A preview, Copy link, mail, messages, four networks and the phone's own sheet.

    VariantRestHoverFocus
    Glyph
    Labelled

    Quiraing sunrise hike

    Guided · 4 hours · from $68 a person

    Card corner

    components/ui/card-corner.tsx

    The arrow a whole-card link shows on hover and when its link has keyboard focus.

    VariantRestHoverFocus
    Link card
    Coastal stays214 places
    Coastal stays214 places
    Coastal stays214 places

    Badge

    components/ui/badge.tsx

    A hue's tint under its own ink on three grounds, and a count on a control's corner.

    On a card
    Guest favouriteAvailable tonightJust listedTop-rated host2 rooms leftGoing fastWeekend dealEco-certifiedSold out
    On a tinted band
    Guest favouriteAvailable tonight2 rooms leftSold out
    On a photograph
    A festival crowd facing a stage lit orange at night
    Guest favouriteGoing fastSold out
    A count on a control

    Tooltip

    components/ui/tooltip.tsx

    A few words of ink for an icon-only control. Never the only place a fact lives.

    Point at one

    Toast

    components/ui/toast.tsx

    One polite notice at a time for what a press just did. Dismiss it or let it clear.

    Raise one

    Fields

    Text field

    components/ui/text-field.tsx

    One box for every form. Its error or its counter stands on the label line.

    VariantRestHoverFocusErrorDisabled
    Empty
    Filled

    Your booking confirmation goes here.

    In US dollars, before taxes and the cleaning fee.

    One code a booking.

    Optional
    84 of 500 characters used

    Password field

    components/ui/password-field.tsx

    Show sits on the label line, and a four-step meter where a password is chosen.

    Good

    Eight characters or more. A phrase is easier to remember.

    Too short

    You sign in with Google, so there is no password to change.

    Select

    components/ui/select.tsx

    One select, dressed by a variant for the ground it stands on, never by a class.

    VariantRestHoverFocusDisabledError
    Outline
    Tonal
    Field

    Filled, on a tint

    Arrival

    Fri 14 Nov

    Getting there

    Lisbon airport, 25 min

    Photo, on a photograph

    The Austin skyline over the river at dusk

    Bare, in a bar that draws its own frame

    Tile, on a tint

    Field, beside the text fields of a form

    Room

    Facet select

    components/ui/facet-select.tsx

    Any number of options on. Each row counts its results, and the corner what is set.

    VariantRestHoverFocusDisabled
    Nothing set
    Two set
    3 filters on

    Search field

    components/ui/search-field.tsx

    Suggestions grouped by kind as it is typed into, and trending searches while empty.

    VariantRestHoverFocusDisabled
    Empty

    Try “li” or “ky”, or open it empty for what is trending.

    Checkbox

    components/ui/checkbox.tsx

    A 20px box whose edge holds at rest, with a 40px reach and a tick on the brand.

    VariantRestHoverPressedFocusDisabled
    Unchecked
    Checked
    Indeterminate
    Amenities

    Switch

    components/ui/switch.tsx

    On is the brand's fill with a tick in the thumb, off the deepest rung.

    VariantRestHoverPressedFocusDisabled
    Off
    On
    Off, small
    On, small

    Choice and range

    Radio tiles

    components/ui/radio-tiles.tsx

    Pick one of a few, each with a line and a price. The arrow keys move the pick.

    VariantRestHoverPressedFocusDisabled
    Tile
    Pay later
    Pay later
    Pay later
    Pay later
    Pay later
    Picked
    Pay later
    Pay later
    Pay later
    Pay later
    Pay later
    Choose a rate

    Prices are per night, before taxes.

    Non-refundable$184 / nightThe lowest rate. Paid today, and it cannot be changed.Free cancellation$206 / nightCancel up to 48 hours before check-in for a full refund.Pay at the property$212 / nightNothing charged now. Pay the host on arrival.
    Pay with
    CardDebit or creditBank transferClears in a working day
    When will you arrive?
    Before 6 pmMet by the hostAfter 6 pmLet yourself in
    Cover photo

    The media dress: each option is its picture, named by its alt text.

    A packed concert crowd under violet stage lightsA hand on a DJ deck lit in purpleHands on an acoustic guitar in low, warm light

    Segmented

    components/ui/segmented.tsx

    A few options in one track: it switches a panel as tabs, or sets a value as radios.

    VariantRestHoverPressedFocusDisabled
    Option
    Picked, outlined
    Picked, brand
    Option, raised
    Picked, raised
    Option, glass
    Picked, glass

    Three stays to a row, photo first, for browsing by eye.

    Prices shown

    Cabin by the lake · $206 a night

    Type of place

    Brand · Search for

    Homes, rooms and cabins, priced per night.

    Raised · How flexible are your dates?

    Check in any day from 11 to 13 June, for 3 nights.

    Glass · on a photograph

    Ticket 1 · General admission

    Filter rail

    components/ui/filter-rail.tsx

    Chips that narrow a list, each with its count. It scrolls sideways on a phone.

    VariantRestHoverPressedFocusDisabled
    Chip
    Picked
    Outline
    Framed
    Framed, picked

    Showing all 248 stays

    Amenities, any number of them

    Bedrooms

    2 bedrooms, at least

    Slider

    components/ui/slider.tsx

    One value or a range on a rail, with its reading in words above it.

    VariantRestHoverPressedFocusDisabled
    Single
    Rooms
    Rooms
    Rooms
    Rooms
    Rooms
    Range
    Budget
    Budget
    Budget
    Budget
    Budget
    Distance from the centre
    Walk to the beach, at most
    Price per night

    Range filter

    components/ui/range-filter.tsx

    A range over where the results sit, with typed ends, quick picks and a count.

    Price per night

    Before taxes and the cleaning fee.

    Price per night

    252 stays

    Distance from the centre

    As the crow flies, from the old town square.

    Distance from the centre
    km
    km

    139 stays

    Quantity stepper

    components/ui/quantity-stepper.tsx

    A number typed or stepped with − and +, held to its range and snapped to its step.

    VariantRestHoverPressedFocusDisabled
    Compact
    At the floor

    3 nights · 1 room · $540 before fees

    Who is coming?

    Ages 13 or above

    Ages 2 to 12

    Under 2

    Service animals are always welcome

    Add to your stay

    • Breakfast for two

      $24 a morning

      $48

    • Airport pickup

      $45 a ride

      $45

    • Extra bed

      $18 a night

      $0

    Navigation and display

    Pagination

    components/ui/pagination.tsx

    Seven slots at most, the page on show on the brand's tint, the ends drawn disabled.

    Stays 13–24 of 140

    Three pages need no gaps, and the first arrow waits disabled.

    VariantRestHoverPressedFocusDisabled
    Page
    Page on show
    Arrow

    Story bars

    components/ui/story-bars.tsx

    One bar a slide, the one on show filling; held by focus, off screen or a pause.

    Experience 1 of 4

    Sunrise kayak on the Tagus

    Paddle out under the bridge before the ferries start, then coffee and pastries on the slipway with the crew.

    Belém · 2 hours · $48 per person

    Experience 1 of 4: Sunrise kayak on the Tagus

    Ink, the default2 of 4

    Experience 2 of 4

    The brand, on its own tint2 of 4

    Experience 2 of 4

    Light, on a dark band or a scrim2 of 4

    Experience 2 of 4

    Autoplay off or reduced motion: a full bar, no pause.

    Accordion

    components/ui/accordion.tsx

    One answer open at a time, ruled by hairlines or with the open row on a tint.

    tone="line" numbered

    The room, cleaning and the service fee. Only the city tax is paid on arrival, and every listing shows its amount beside the price before you book.

    tone="tint"

    Before their first listing goes live, each host shows a government ID and a phone number. Their profile says when each was checked.

    tone="tint" weight="heading"

    Before their first listing goes live, each host shows a government ID and a phone number. Their profile says when each was checked.

    VariantHoverPressedFocus
    Line

    Tint

    Tint, open

    Yes, up to two.

    Yes, up to two.

    Yes, up to two.

    Dialog

    components/ui/dialog.tsx

    A sheet from the foot of a phone, centred from sm: header, scrolling body, footer.

    Open either one. On a phone it rises from the foot of the screen.

    Drawer

    components/ui/drawer.tsx

    A sheet from any edge, swiped away: snap points, a handle, a drawer inside one.

    From the foot with a handle and a second drawer inside it, from the end of the line, and with a snap point that holds a peek of the list.

    Avatar

    components/ui/avatar.tsx

    A face at four sizes, initials on the brand's tint until it loads, a status, a group.

    Four sizes: 24, 32, 40 and 56

    NANANANA

    Initials while the photo loads, or for someone with none

    MRMRMRMR

    A status, named to a screen reader

    PLGONA

    A group, with the rest counted

    Rating

    components/ui/rating.tsx

    A score out of five as stars, the last one filled to its fraction, read as one image.

    Small, inside a line of text

    4.87· 312 reviews

    Medium, beside a larger figure

    4.9
    from 1,204 stays

    Two tones only: the brand by default, or ink

    4.54.5

    A fraction fills the next star to its share

    3.54.24.75

    Input: a score given with a press or the arrow keys

    A great stay

    Input states: unrated, rated, ink, disabled

    Price

    components/ui/price.tsx

    Money in its currency and locale: a muted unit, cents only under ten, Free at zero.

    • $180 per nightUSD · en-USA stay, by the night
    • £4.50 per personGBP · en-GBUnder ten keeps its pence
    • 152 € per nightEUR · de-DEThe locale places the sign
    • ¥18,000 per nightJPY · ja-JPNo minor unit at any size
    • FreeUSD · en-USZero prints as Free

    Progress

    components/ui/progress.tsx

    How far along it is: a label and its value over a bar filling from the start.

    Your host profile
    x
    Photos uploaded
    x
    Booking
    x

    Skeleton

    components/ui/skeleton.tsx

    The resting shape of what is on its way, on the muted rung, with a slow pulse.

    Loading a stay
    Loading reviews

    Empty state

    components/ui/empty-state.tsx

    A designed screen for a list with nothing in it; its action brings results back.

    Stays in Lisbon, filtered by Pets allowed and Under $80

    No stays match both of these

    Drop Pets allowed and 14 stays under $80 come back.

    Tables and records

    Table

    components/ui/table.tsx

    Every list of records: sortable heads, linking rows, a ticked row and a totals line.

    1 selected

    Orders for Neon Harbor: Low Tide Tour, Fri, Oct 9
    OrderTier
    DL-37499

    Elena Castillo

    elena.castillo@fastmail.com

    Balcony2$104
    DL-37492

    Caleb Haddad

    caleb.haddad@fastmail.com

    Early entry + poster1$85
    DL-48217

    Maya Ortiz

    maya.ortiz@fastmail.com

    General admission2$72
    DL-37518

    Devon Reyes

    devon.reyes@outlook.com

    General admission2$72
    DL-37508

    Marcus Reyes

    marcus.reyes@gmail.com

    Balcony1$52
    DL-37511

    Andre Duarte

    andre.duarte@proton.me

    General admission1$36
    6 orders9$421

    A press anywhere on a row opens its order; the box ticks it instead. Refunded shows the empty row.

    VariantRestHoverPressedFocus
    Row that links
    Selected row
    Sorting head

    Description list

    components/ui/description-list.tsx

    One record in label and value rows: a heading per group, figures, chips and actions.

    Order
    Order number
    DL-48217
    Status
    Paid
    Customer
    Maya Ortiz

    maya.ortiz@fastmail.com

    Show
    Neon Harbor: Low Tide Tour

    Fri, Oct 9 at 8:00 PM, The Foundry

    Tickets
    General admission × 2at $36 each
    Payment
    Fan paid
    $84.00
    Fees the fan paid
    −$12.00
    Card processing 2.9%
    −$2.08
    Net to you
    $69.92
    Payout account
    Paid into
    Business checking

    Account ending 6411

    Schedule
    Every Friday, for the week before
    Next payout
    $41,753 on Fri, Oct 9Scheduled
    Last transfer
    PO-20261002-6411
    Tax form
    W-9 on file

    Command menu

    components/ui/command-menu.tsx

    Shows, orders, pages and actions in one search, each match marked, run by keyboard.

    Press it, or ⌘K anywhere on this page. Try “48217”, “tomas” or “scan”.

    VariantRestHoverPressedFocus
    Search button

    Dates and maps

    Calendar

    components/ui/calendar.tsx

    A month to pick a night or a stay from; taken and past nights are struck through.

    VariantRestHoverPressedFocusDisabled
    Day
    Today
    Picked

    One night, the past and sold-out ones struck through

    November 2026

    Month and year lists, for a date far off

    April 2027

    A stay over two months, a booked night closing the way

    Check in
    Sat, Nov 7
    Check out
    Tue, Nov 10
    Nights
    3
    November 2026
    December 2026
    Struck-through nights are booked; a stay can't run across one.

    Date picker

    components/ui/date-picker.tsx

    A field that opens presets beside a month; either one fills it and closes.

    VariantRestHoverPressed
    Card
    Field
    Bare
    VariantFocusDisabledError
    Card
    Pick a night first
    Field

    Pick a night first

    Bare

    Pick a night first

    A hero field, a form field and a stay; each opens on what it holds

    Slot picker

    components/ui/slot-picker.tsx

    Days and their open times, booked from a button that says what it books.

    VariantRestHoverPressedFocusDisabled
    Time
    4:00 PM
    4:00 PM
    4:00 PM
    4:00 PM
    4:00 PM
    Picked
    4:00 PM
    4:00 PM
    4:00 PM
    4:00 PM
    4:00 PM
    In a week
    4 PM
    4 PM
    4 PM
    4 PM
    4 PM
    Week, picked
    4 PM
    4 PM
    4 PM
    4 PM
    4 PM

    A card's day row, the same card once booked, and a page's week

    Talk to a host

    A 20-minute video call

    Open now
    Wed 4Thu 5Fri 6

    Times in your time zone

    9:00 AM10:30 AM1:00 PM2:30 PM4:00 PM5:30 PM

    Talk to a host

    A 20-minute video call

    Open now
    Wed 4Thu 5Fri 6

    Times in your time zone

    9:00 AM10:30 AM1:00 PM2:30 PM4:00 PM5:30 PM

    Call booked

    Wed, Nov 4, 9:00 AM with the host team. The video link arrives by email an hour before.

    Nov 9 – 15

    30 min60 min90 min
    9 AM4:30 PM6 PM
    4 PM7:30 PM
    10 AM3:30 PM5 PM6:30 PM
    4:30 PM
    9:30 AM1 PM5:30 PM
    10:30 AM12 PM
    No times

    Map

    components/ui/map.tsx

    Live tiles: price pins that gather and open a card, or the world with its cities.

    VariantRestHoverPressedFocus
    Price
    €148
    €148
    €148
    €148
    Saved
    €98
    €98
    €98
    €98
    Lit
    €172
    €172
    €172
    €172
    Gathered
    €98· 3 places
    €98· 3 places
    €98· 3 places
    €98· 3 places
    Area
    Lisbon· 6
    Lisbon· 6
    Lisbon· 6
    Lisbon· 6
    City
    Lisbon3:03 PM
    Lisbon3:03 PM
    Lisbon3:03 PM
    Lisbon3:03 PM
    City, picked
    Lisbon3:03 PM
    Lisbon3:03 PM
    Lisbon3:03 PM
    Lisbon3:03 PM
    Narrow
    Narrow, picked

    Loading the map

    As a picture: still, its pin part of the drawing, the page scrolling through it

    Loading the map

    The world: each city on its own clock, dots where chips would crowd, arcs by id

    Loading the map

    Lisbon answers from 8 AM to 8 PM, Monday to Saturday, on its own clock.