01 · Principles
Built from the gym.
Material, not decoration
Every surface maps to something in a climbing gym: the wall is plywood with a hex-offset T-nut grid and panel seams; panels and cards are chalky card stock; labels are route-setter's tape; buttons are hand-shaped holds.
Colour means grade
Like a real gym circuit, a hold's colour tells you its difficulty. Colour is always paired with text (the grade) — it is a second signal, never the only one.
A deck you could print
Every card is a poker-size layout (63.5 × 88.9 mm, 5 : 7) that scales with its own width and prints true-size from the deck page.
Tells you why
A card you can't play says why — "Needs 46 END · you have 30", "Belayer 1 is taken" — instead of just fading out.
02 · Colour
The hold circuit.
Saturated hold colours for fills; a paired --on-* text colour that passes WCAG AA (≥ 4.5 : 1) on each; deeper --*-text colours for coloured text on paper. Raspberry, violet and cobalt were deepened in v2 so light text passes on them, and black (basalt) holds were added for project grades.
Grade circuit
Grades map to hold colours like a gym's circuit board (shared by the UI badge and the card art via AIAArt.circuit(grade)).
Card-art print inks
Illustrations print in pastel sandstone: each hold colour becomes a lit face (hold + 50% chalk) over a shade body; the climber is warm umber, never black.
03 · Typography
Chunky display, honest body.
Bricolage Grotesque for names and numbers, Hanken Grotesk for reading, Geist Mono for meta (set codes, labels). Every step is fluid with a rem floor, so browser zoom and user font settings always win; nothing in the UI goes below 12px, and card text never below 11px.
04 · Surfaces
Wall, paper, tape.
Hold shapes
Tape
05 · Components
Grippy controls.
Buttons .btn
44px minimum target · hold-shaped radius · overlay grit
Chips & dice .aia-chip · .aia-die-chip
Meters & time .aia-meter · .aia-pips
Requirement block .aia-reqs
Met / short is shown by ✓ / ✕ mark, outline and hatch — not colour alone
06 · Cards
The printed card.
Anatomy
- Frame — 3.2% border in the card type's colour (area for routes, category for gear, basalt for climbers, wood for training, foil gradient for milestone projects).
- Kind line — icon + type in mono; a status badge on the right (Attempted, Owned, Sent).
- Name — display face, two lines max, balanced wrap.
- Art window — 4 : 3 illustration with the grade hold (or price / bonus) top-right and route-type chips bottom-left.
- Requirements — four stat wells; in play they show ✓ met or ✕ short against your stats.
- Dice — buff (−, lime) and nerf (+, raspberry) dice chips, or "No dice — pure skill".
- Costs — time, endurance, and XP on a send / on a fall.
- Footer — set code (AIA · BLD 09/26) and moves or edition.
- Action — one real button stretched over the card, labelled by a tab hanging from the bottom edge; when unavailable, the reason sits on the art.
The card is a size container: the face's type is clamp(0.75rem, 5.6cqi, 1.4rem), so a card scales like a physical card. If text would get too small, the card grows taller instead.
One of each
07 · Card art
Pastel sandstone print.
Flat printed planes, two-tone holds, an anatomically proportioned climber with a cast shadow, grit specks and chalk dust where hands have been. Route art is generated from the route's own data, so the picture always matches the rules:
Gear, climbers and training stations each have a hand-built still life or portrait in the same inks. See all 98 on the deck page; earlier explorations are in art-styles.html.
08 · Accessibility
Everyone tops out.
| Area | What the system does | WCAG |
|---|---|---|
| Contrast | Every text/background pair is a named token pair (≥ 4.5 : 1). Coloured text uses --*-text; text on holds uses --on-*. prefers-contrast: more darkens secondary ink and removes grit. | 1.4.3, 1.4.11 |
| Not colour alone | Grades are always written; met/short requirements carry ✓/✕ and a hatch; disabled cards state their reason in text. | 1.4.1 |
| Keyboard | Every card is one real <button>; radio groups for player count and card size; skip link; visible cobalt + chalk focus ring on every surface. | 2.1.1, 2.4.1, 2.4.7 |
| Dialogs | Climb results, level-ups, stat shifts and victory are role="dialog" aria-modal: focus moves in, Tab is trapped, Escape closes, the page behind is inert, focus returns afterwards. | 2.4.3, 4.1.2 |
| Announcements | Turn status is a polite live region; the game log is role="log"; meters expose role="meter" with values. | 4.1.3 |
| Resize & reflow | Fluid type with rem floors; card size control (S–XL); single-column at 320px with no page-level horizontal scroll (card rows scroll inside themselves on phones). | 1.4.4, 1.4.10 |
| Targets | Buttons ≥ 44px; whole cards are the target. | 2.5.5, 2.5.8 |
| Motion | prefers-reduced-motion removes transforms, hover lifts and effects animations. | 2.3.3 |
| Forced colours | Textures drop out; cards, chips and meters get system-colour borders. | 1.4.11 |
| Images | Illustrations are decorative (aria-hidden) because every rule they depict is also text on the card. | 1.1.1 |
09 · In code
Reusable pieces.
design/tokens.css— colour, type, space, shape, depth, motion, card and texture tokens.design/surfaces.css—.wall,.paper,.tape,.hold,.chalk-smudge.design/components.css— base, focus,.btn, chips, meters, pips, the card anatomy, dialogs, reduced-motion and forced-colour rules.design/board.css— the game board layout (HUD, climber rail, walls, stations, shop, log, dialogs, online lobby).design/icons.js—AIAIcons: 24px line icons and the route-name → motif map.design/card-art.js—AIAArt: route, gear, climber and training illustrations; the grade circuit.design/cards.js—AIACards: builders that return a ready card element with its action wired.design/a11y.js— dialog focus management, player-count and card-size controls, HUD sizing.
<script src="design/icons.js"></script>
<script src="design/card-art.js"></script>
<script src="design/cards.js"></script>
AIAArt.mount(); // once: shared SVG defs
const card = AIACards.route(route, {
area: 'bouldering',
stats: playerStats, // shows ✓ / ✕ per requirement
status: 'Attempted',
action: {
label: 'Climb',
disabled: !!reason, reason, // e.g. "Needs 46 END · you have 30"
onClick: () => attemptClimb(route, 'bouldering'),
},
});
wallEl.appendChild(card);