Skip to content
RCSL

For developers and volunteers

Style guide

Every design token and component on the RCSL site. Values come from src/styles/tokens.css; use these, never one-off colors or sizes.

Color

Text on gold is navy, never white. Aqua and gold are never body text on light backgrounds. Gold means records and firsts only. No orange.

  • navy#0B1F3Atext, header, table head
  • primary#0F5FA8pool blue: buttons, links
  • aqua#38BDF8decorative only: lane stripe, rules, chart series. Never body text on light.
  • gold#F2B705records and firsts ONLY. Text on gold is navy.
  • gold-text#7A5600gold-colored text
  • gold-tint#FDF3D0record rows, record callout
  • background#F3F5F8page background
  • surface#FFFFFFcards, tables
  • muted#4B5A70secondary text
  • line#D9E0EAborders, dividers; nav link text on navy
  • success#1A7F4Bproposed
  • danger#B42318proposed
  • white#FFFFFFtext on primary/navy buttons (same as surface)

Contrast

WCAG AA needs 4.5:1 for normal text and 3:1 for large text. Every pair in use passes.

SampleText on backgroundUsed forRatioAA
Aa 25.31navy on backgroundBody text on page15.12:1Pass
Aa 25.31navy on surfaceBody text on cards16.52:1Pass
Aa 25.31primary on surfaceLinks on cards6.52:1Pass
Aa 25.31primary on backgroundLinks on page5.97:1Pass
Aa 25.31white on primaryPrimary button6.52:1Pass
Aa 25.31muted on backgroundSecondary text on page6.42:1Pass
Aa 25.31muted on surfaceSecondary text on cards7.01:1Pass
Aa 25.31line on navyNav links on header12.43:1Pass
Aa 25.31white on navyTable header, wordmark16.52:1Pass
Aa 25.31navy on goldRecord badge9.09:1Pass
Aa 25.31navy on gold-tintRecord row and callout14.87:1Pass
Aa 25.31gold-text on gold-tintGold text on tint5.99:1Pass
Aa 25.31gold-text on surfaceGold text on cards6.65:1Pass
Aa 25.31success on surfaceSuccess text5.02:1Pass
Aa 25.31danger on surfaceError text6.57:1Pass

Typography

font-sans

Roboto — Body text

'Roboto', system-ui, sans-serif

Regular 400 · Medium 500 · Bold 700

font-display

Bebas Neue — Headings

'Bebas Neue', Impact, sans-serif

Type scale

Fluid sizes: each step grows smoothly from phone (320px) to desktop (1240px). Resize the window to see it.

  • text-xs
    13px caption
    Swimmers dropped 2.4 seconds this week.
  • text-sm
    14 -> 15
    Swimmers dropped 2.4 seconds this week.
  • text-base
    16px body
    Swimmers dropped 2.4 seconds this week.
  • text-lg
    18 -> 20 lead
    Swimmers dropped 2.4 seconds this week.
  • text-xl
    22 -> 30 H3
    Rocket City Swim League
  • text-2xl
    30 -> 54 H2
    Rocket City Swim League
  • text-3xl
    40 -> 80 H1
    Rocket City Swim League
  • text-wordmark
    24 -> 32 header wordmark
    Rocket City Swim League

Headings and text

H1 City Meet 2026

H2 Weekly results

H3 Girls 9-10 50 free

H4 Body bold subheading

Body text is Roboto at 16px. Links are pool blue and turn navy on hover. Result times use tabular figures so columns line up: 31.42 · 1:02.11 · 11.11.

Caption text is 13px, muted.

Letter spacing

  • tracking-heading 0.02em
  • tracking-wordmark 0.04em
  • tracking-label 0.06em

Spacing

Only these nine values exist. Use them for padding, margin, gap, width and height (e.g. p-4, gap-6, mt-12).

  • 14px
  • 28px
  • 312px
  • 416px
  • 624px
  • 832px
  • 1248px
  • 1664px
  • 2496px

Radius

rounded-base8px · buttons, cards, tables, callouts
rounded-badge4px · small badges

Layout

Mobile-first, one centered column. Tailwind default breakpoints: sm 640px, md 768px, lg 1024px, xl 1280px.

  • max-w-page 72rem · max width of the main column (1152px)
  • max-w-reading 42rem · comfortable reading width for long text (max-w-reading)

Component tokens

  • --header-height 72px
  • --lane-stripe-height 8px
  • --lane-stripe-bar 40px · aqua lane-line length
  • --lane-stripe-gap 4px · navy gap between bars
  • --callout-border 6px · record callout gold left border
  • --map-height clamp(320px, 55vh, 480px) · Pools page map
  • --lane-rule-width 48px · aqua accent bar above dashboard section headings
  • --lane-rule-height 4px
  • --chart-max-width 28rem · SVG charts stop growing here so their text stays readable

Buttons

Real links when they go somewhere, real buttons when they do something. Press Tab to see focus states.

Badges

RecordOfficiatingNew

The gold Record badge is for records and firsts only.

Cards

Plain card

A white surface with a 1px border and 8px corners. Holds any content.

Linked card

The whole card is one link. Hover or tab to it to see the border change.

Document card

Document list row

For long lists on category pages. The title opens the document's page; "Open PDF" goes straight to the file.

Archived document banner

Shown at the top of a document page when its frontmatter has status: archived. The link appears when replacedBy is set.

Downloads

File chips and matchup cards for the weekly downloads area. Who may download each file kind is set insrc/lib/downloads.ts. Public files are links. Locked files show a lock and a "Request" link to the site's request form (/downloads/request/) with the file filled in.

File chip

Matchup card

Pool card

One team and its pool on the Pools page. Sample data below; real data lives in src/data/pools.ts.

NEWNew for 2027

NEW

Sample New Pool

Joining the league in 2027. Pool details are coming.

Callouts

Document text

Reading style for full-text documents (Markdown with textVersion: true), wrapped in<div class="doc-text">. List items that start with a bold label drop the bullet.

Article I. Sample Article

Section 1. Sample section

Plain paragraph text at body size, for rules and bylaws read on a phone.

  • A. A labeled item: the label replaces the bullet.
    • (1) A nested labeled item.
    • (2) Another nested item.
  • B. Second labeled item.
  • An ordinary bullet keeps its dot.
SampleHomeAway
Week 112
Week 234

Results table

Sample data with made-up names. Public pages show first name and last initial only, plus team code and age group. The two "Ella K." rows on one team show why each swimmer links by stable ID, not by name.

Girls 9-10 50 Freestyle (sample)
PlaceSwimmerTeamAge groupTimePoints
1Ava R.RecordBLUGirls 9-1031.426
2Maya T.GRNGirls 9-1033.084
3Ella K.REDGirls 9-1033.953
4Ella K.REDGirls 9-1034.602
5Nora S.BLUGirls 9-101:02.111

Relays list the four swimmers under the team relay name; a disqualified swim shows DQ and a struck-through time.

Girls 11-12 200 Medley Relay and a DQ (sample)
PlaceSwimmerTeamTimePoints
1BLU 'A'Ava R., Maya T., Ella K., Nora S.BLU2:31.087
2GRN 'A'Ruby P., Ivy L., Zoe M., Leah W.GRN2:36.40
DQMolly D.GRN41.12

Converted time (Analytics)

In the Analytics "All pools" views a time swum in the other kind of pool is converted (meters × 0.901 = yards), marked ≈, and shows the real time underneath. Official results, points and records never show converted times.

≈31.2034.63 meters

Meet score card

On the Results page each card links to the meet. The winner is bold with a "Won" label.

Sample data banner

Shown at the top of every results page until real results are connected (RESULTS_SOURCE=supabase).

Charts

Drawn at build time as SVG (src/components/charts/). One series color (primary) with gray for the rest; gold stays for records. Every chart has a caption or summary in words, hover tooltips, and a table view or text equivalent. Times are compared in yards (meters × 0.901) and say so. Sample data, made-up.

Scoreboard (dashboard headline numbers)

Navy panel with the lane stripe along the bottom and dark KPI tiles. White values, light-gray labels, aqua for the title and links, gold only for record numbers. Section headings on dashboards get the aqua lane rule (class lane-rule, as on this heading); hub cards get an aqua top line (<Card accent>).

Sample · 2026 at a glance

Dual meet record

5–0

5 meets

Points per dual meet

291

Average team score

League records set

2

In 2026

See details →

Swimmers

64

35 girls · 29 boys

Accent card

Hub and navigation cards carry the aqua top line.

Light stat tiles

Events swum in 2026

4

5 meets

Personal bests in 2026

6

New best times, all events

Time dropped this season

2.86 s

First swim to best, all events

Best event

Top 10%

50 Breaststroke · 9th of 81

50 FreestyleTime in yards · lower is faster
3334353620252026Best 33.20

Yards pool Meters pool, converted to yards

Show as table
DateMeetTime swumIn yards
Jun 4, 2025BLU vs GRN36.90 y36.90
Jun 11, 2025RED vs BLU40.18 m · PB≈36.20
Jun 18, 2025BLU vs GLD35.40 y · PB35.40
Jun 3, 2026GRN vs BLU34.10 y · PB34.10
Jun 10, 2026BLU vs RED38.40 m≈34.60
Jun 17, 2026City Meet33.20 y · PB33.20
Where Ava stands: Girls 9-10 50 FreestyleAva's 33.20 is 24th of 60, faster than 61% of the field.
30.00 fastestslower →

Team charts

BLU dual meets (sample)Points won or lost by, each week
−500+50+100+92Wk 1 WMNSO−36Wk 2 LLILY+2Wk 3 WGREN
Show as table
WeekOpponentScoreResult
1MNSO Monte Sano (home)296–204Won
2LILY Lily Flagg (away)232–268Lost
3GREN Greenwyche (home)251–249Won
Points by age group (sample)Per meet
  • 8&U52.6
  • 9-1043.8
  • 11-1268

League average per team

Records broken (sample)By week
1Wk 10Wk 26Wk 311City
BLU net points (sample)Our points minus opponents' points in the same events, all dual meets. Plus = gained, minus = gave away.
GroupFreeBackRelaysTotal
Girls 9-10+21−30+18
Boys 9-10−5−350−40
2026 season bestsFaster than this share of the age group
  • 50 Freestyle61% · 24th of 60
  • 50 Backstroke88% · 8th of 57
  • 50 Breaststroke12% · 47th of 53