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 headprimary#0F5FA8pool blue: buttons, linksaqua#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 textgold-tint#FDF3D0record rows, record calloutbackground#F3F5F8page backgroundsurface#FFFFFFcards, tablesmuted#4B5A70secondary textline#D9E0EAborders, dividers; nav link text on navysuccess#1A7F4Bproposeddanger#B42318proposedwhite#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.
| Sample | Text on background | Used for | Ratio | AA |
|---|---|---|---|---|
| Aa 25.31 | navy on background | Body text on page | 15.12:1 | Pass |
| Aa 25.31 | navy on surface | Body text on cards | 16.52:1 | Pass |
| Aa 25.31 | primary on surface | Links on cards | 6.52:1 | Pass |
| Aa 25.31 | primary on background | Links on page | 5.97:1 | Pass |
| Aa 25.31 | white on primary | Primary button | 6.52:1 | Pass |
| Aa 25.31 | muted on background | Secondary text on page | 6.42:1 | Pass |
| Aa 25.31 | muted on surface | Secondary text on cards | 7.01:1 | Pass |
| Aa 25.31 | line on navy | Nav links on header | 12.43:1 | Pass |
| Aa 25.31 | white on navy | Table header, wordmark | 16.52:1 | Pass |
| Aa 25.31 | navy on gold | Record badge | 9.09:1 | Pass |
| Aa 25.31 | navy on gold-tint | Record row and callout | 14.87:1 | Pass |
| Aa 25.31 | gold-text on gold-tint | Gold text on tint | 5.99:1 | Pass |
| Aa 25.31 | gold-text on surface | Gold text on cards | 6.65:1 | Pass |
| Aa 25.31 | success on surface | Success text | 5.02:1 | Pass |
| Aa 25.31 | danger on surface | Error text | 6.57:1 | Pass |
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 captionSwimmers dropped 2.4 seconds this week.text-sm
14 -> 15Swimmers dropped 2.4 seconds this week.text-base
16px bodySwimmers dropped 2.4 seconds this week.text-lg
18 -> 20 leadSwimmers dropped 2.4 seconds this week.text-xl
22 -> 30 H3Rocket City Swim Leaguetext-2xl
30 -> 54 H2Rocket City Swim Leaguetext-3xl
40 -> 80 H1Rocket City Swim Leaguetext-wordmark
24 -> 32 header wordmarkRocket 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-heading0.02emtracking-wordmark0.04emtracking-label0.06em
Spacing
Only these nine values exist. Use them for padding, margin, gap, width and height (e.g. p-4, gap-6, mt-12).
14px28px312px416px624px832px1248px1664px2496px
Radius
rounded-base8px · buttons, cards, tables, calloutsrounded-badge4px · small badgesLayout
Mobile-first, one centered column. Tailwind default breakpoints: sm 640px, md 768px, lg 1024px, xl 1280px.
max-w-page72rem · max width of the main column (1152px)max-w-reading42rem · comfortable reading width for long text (max-w-reading)
Component tokens
--header-height72px--lane-stripe-height8px--lane-stripe-bar40px · aqua lane-line length--lane-stripe-gap4px · navy gap between bars--callout-border6px · record callout gold left border--map-heightclamp(320px, 55vh, 480px) · Pools page map--lane-rule-width48px · aqua accent bar above dashboard section headings--lane-rule-height4px--chart-max-width28rem · SVG charts stop growing here so their text stays readable
Header and lane stripe
The header at the top of this page: navy bar, 72px tall, with the 8px lane-line stripe underneath (repeating 40px aqua bars with 4px navy gaps). Below 768px the links fold into a Menu button. Use the lane-stripe class to reuse the stripe as a divider:
Badges
The gold Record badge is for records and firsts only.
Cards
Linked card
Document card
Sample Meet Checklist
Example summary for a document in the hub.
PDF · May 12, 2026
Sample Stroke and Turn Guide
PDF · 2026
Sample Proposal Template
Word
Document list row
For long lists on category pages. The title opens the document's page; "Open PDF" goes straight to the file.
- Sample Board MinutesJun 18, 2026Open PDF: Sample Board Minutes, Jun 18, 2026
- Sample Dual Meet Guide2011Open PDF: Sample Dual Meet Guide, 2011
- Sample External Rulebook2026Open PDF: Sample External Rulebook, 2026 (opens a new tab)
- Sample Old GuidelinesArchived2011Open PDF: Sample Old Guidelines, 2011
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
- Team Manager meet events (yards)
- Results (PDF)Request(opens the request form)
- Meet Manager backupRequest(opens the request form)
Matchup card
BLU vs GRN
- BLUWonBLU
- 312
- GRNGRN
- 248.5
RED vs GLD
- REDRED
- GLDGLD
No files posted.
Pool card
One team and its pool on the Pools page. Sample data below; real data lives in src/data/pools.ts.
BLU
Sample Swim Club
Dual meets: home team lanes 4–6, visitors lanes 1–3
NEW
Sample New Pool
Joining the league in 2027. Pool details are coming.
Modal
Pop-up built on the browser's native dialog: traps focus, closes with Esc, the close button or a click outside. Used for "Request sent" on the request form.
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.
| Sample | Home | Away |
|---|---|---|
| Week 1 | 1 | 2 |
| Week 2 | 3 | 4 |
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.
| Place | Swimmer | Team | Age group | Time | Points |
|---|---|---|---|---|---|
| 1 | Ava R.Record | BLU | Girls 9-10 | 31.42 | 6 |
| 2 | Maya T. | GRN | Girls 9-10 | 33.08 | 4 |
| 3 | Ella K. | RED | Girls 9-10 | 33.95 | 3 |
| 4 | Ella K. | RED | Girls 9-10 | 34.60 | 2 |
| 5 | Nora S. | BLU | Girls 9-10 | 1:02.11 | 1 |
Relays list the four swimmers under the team relay name; a disqualified swim shows DQ and a struck-through time.
| Place | Swimmer | Team | Time | Points |
|---|---|---|---|---|
| 1 | BLU 'A'Ava R., Maya T., Ella K., Nora S. | BLU | 2:31.08 | 7 |
| 2 | GRN 'A'Ruby P., Ivy L., Zoe M., Leah W. | GRN | 2:36.40 | |
| DQ | Molly D. | GRN | 41.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.
Meet score card
On the Results page each card links to the meet. The winner is bold with a "Won" label.
- MNSOWonMonte Sano
- 268
- LILYLily Flagg
- 232
Full results · at Monte Sano · meters
- GRENGreenwyche
- 250
- BLOSBlossomwood
- 250
Tie
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
Yards pool Meters pool, converted to yards
Show as table
| Date | Meet | Time swum | In yards |
|---|---|---|---|
| Jun 4, 2025 | BLU vs GRN | 36.90 y | 36.90 |
| Jun 11, 2025 | RED vs BLU | 40.18 m · PB | ≈36.20 |
| Jun 18, 2025 | BLU vs GLD | 35.40 y · PB | 35.40 |
| Jun 3, 2026 | GRN vs BLU | 34.10 y · PB | 34.10 |
| Jun 10, 2026 | BLU vs RED | 38.40 m | ≈34.60 |
| Jun 17, 2026 | City Meet | 33.20 y · PB | 33.20 |
Team charts
Show as table
| Week | Opponent | Score | Result |
|---|---|---|---|
| 1 | MNSO Monte Sano (home) | 296–204 | Won |
| 2 | LILY Lily Flagg (away) | 232–268 | Lost |
| 3 | GREN Greenwyche (home) | 251–249 | Won |
- 8&U52.6
- 9-1043.8
- 11-1268
League average per team
| Group | Free | Back | Relays | Total |
|---|---|---|---|---|
| Girls 9-10 | +21 | −3 | 0 | +18 |
| Boys 9-10 | −5 | −35 | 0 | −40 |
- 50 Freestyle61% · 24th of 60
- 50 Backstroke88% · 8th of 57
- 50 Breaststroke12% · 47th of 53
Page header
The block at the top of this page: optional eyebrow, the H1, optional lead paragraph.