Design system

Style guide

Every token in css/tokens.css, every component in css/components.css and the newer pieces in css/fx.css on one page, in light and dark mode (the button at the top), for checking the site against docs/DESIGN.md (v1.1.4).

Text on surfaces

Each text colour on the surfaces DESIGN.md allows it on. mute is for white surfaces only.

canvas

ink: headings and body text

body: captions and descriptions

mute: timestamps, "data through"

error: what went wrong

canvas-soft

ink: headings and body text

body: captions and descriptions

error: in an error message box

canvas-softer

ink: headings and body text

body: captions and descriptions

ink

on-ink: all text on ink

mute-on-ink: secondary text on ink

A link on ink

Typography

Inter at 400, 500 and 700; tabular numerals for numbers; the system monospace stack for code.

Eyebrow · display-xxl

See the Bay Area move

display-xl (section headline)

How the Bay Area rides

display-lg · display-md · display-sm

Answer panel heading

Card title

Sub-card heading

stat

115,501

body-lg: hero sub-text and lead paragraphs.

body-md: paragraphs never go below 16 px. Numbers carry units: 18,240 entries, 61% of 2019, 8:15 AM.

body-sm: tooltips, table body, legends.

caption: chart axes and fine print, in mute on white.

SELECT station_name, SUM(entries) FROM marts.fct_station_daily GROUP BY 1

Tokens

Read from the stylesheet's :root rules, so this list is always the one the site uses.

Icons

Lucide (ISC), 20 px, 1.75 px stroke, from the page's sprite.

    Components

    Pills for anything you can press, 16 px cards for anything that holds content.

    Buttons

    Icon buttons

    Chips

    Segmented control

    Text input

    Cards

    card

    White, 1 px hairline, 16 px corners.

    card--soft: empty and error states.

    card--ink: the Findings band.

    Ask launcher and panel

    Fixed in the bottom-right corner on the site; the panel is a side panel from 768 px, full screen below.

    Ask BayRidership

    BART and Bay Wheels data, in plain English

    Hi! I look answers up in this site's BART ridership, Bay Wheels trips and station forecast. Try one:

    Stat tiles

    Average daily entries

    115,501

    ▲ 3.1% vs a year earlier

    Busiest station

    Powell Street

    9.9% of all entries

    Tooltip and swatches

    MacArthur
    Yellow, Red
    Entries on Dec 31, 2025: 3,041 (48% of 2019)
    See its forecast

    Legend

    • Yellow line · Antioch – SFO / Millbrae
    • Orange line
    • Red line
    • Green line
    • Blue line
    • Airport connector

    Messages

    Ridership numbers will appear here once the data pipeline is connected.

    Ridership numbers didn't load. Check your connection and try again.

    SQL block

    SELECT station_name AS station, SUM(entries) AS entries
    FROM marts.fct_station_daily
    GROUP BY 1 ORDER BY 2 DESC LIMIT 5

    Data table

    Example table
    StationEntriesShare of 2019
    Powell Street11,40252%
    Embarcadero10,97748%

    Skeleton

    Toast

    Copied

    FAQ row

    Where do the train positions come from?

    From BART's published GTFS timetable.

    v1.1

    Newer pieces

    From css/fx.css. The dot before this section's eyebrow is the section accent (data-accent, one line colour per band).

    Pulse stripe

    The six line colours under the nav, with a light sweeping along it (off with reduced motion).

    Hero: headline highlight and live strip

    See the Bay Area move

    • 54 trains moving
    • 38% of 2019 ridership
    • Data through Dec 31, 2025

    Departure board

    Fed by the map every 10 seconds (tp:arrivals); an ink surface, dark grey in dark mode.

    Mascot

    mascot, and mascot--lg in a mascot-btn (it hops when poked)

    Legend toggles

    Chips: surprise me, what-if stations

    Chart readout and forecast badges

    Dec 2025 BART entries121,578

    Busiest Tue, Jan 13 · 14,889 Quietest Sun, Jan 4 · 3,633

    Station closures: verdict pills, a station card, the cost card

    Case to keep: strong Case to keep: mixed Case to keep: weak

    Antioch

    Concord to Antioch segment

    Case to keep: strong

    Weekday trips in 2025
    3,704, rank 16 of 50 from the fewest
    Nearest station still open
    Concord, 13.6 mi

    Top destinations

    1. Embarcadero
    • Riders: Met
    • Recovery: Not met

    What closing would cost

    • Traffic. A cited finding, with the study in brackets.

    A caption with the caveat.

    What-if picker

    What if stations close?

    Presets, then a chip per station; a closed station is crossed out and pressed.

    10 of 50 stations closed. The same trains run through them without stopping.