COMPLETE DISSEMINATION

Every element, component, style — and where the build stands

The living reference for Reps With Friends: design system, feature inventory, progress metrics, and system map. If it exists, it's on this page.

90+tests green

36elements catalogued

16components

9public pages

7systems

CI/CDpush → live

01 · Design tokens

Single source of truth: design/tokens.css. Every page, app and bot card consumes these — nothing hardcodes colour.

Colour

Rule: lime is earned — it marks effort, verification, winning, action. Coral is heat (comeback, HR, down-states). Amber is pending. Sky is information.

Type

TRAIN TOGETHERdisplay · 700 · clamp 30–44px · −0.02em

Win on effortheading · 700 · 22–26px

Any reps, any order — first to 300 closes it.body · 400 · 14–15px

KX4T9C · 285.0 · 63.3%mono · tabular numerals · codes & scores

STANDINGSlabel · 700 · 11–12px · 0.14em tracking · uppercase

Space · radius · motion

4 / 8 / 12 / 16 / 22 / 30spacing scale (px)

9 / 14 / 999radius: sm / card / pill

160msease-out interactions

700msprogress-bar fills

44pxminimum touch target

reduced-motionall motion guarded

02 · Component library

16 primitives, rendered live. Every screen in the app, site, hub console and bot cards composes from these.

Buttons

Actions. Primary = one per view, lime, earned.

Tags & status dots

live idle down

System + match status. Dots carry glow when healthy.

Tier pills

couch ×1.5 casual ×1.25 fit ×1.0 athlete ×0.85

Handicap identity. Colour-coded, multiplier on the face.

Comeback badge

⚡ comeback ×1.2 armed

Appears when >30% behind leader. Pulses until used.

Progress bar

Raw-rep progress to target. 700ms fill, lime; coral when comeback-armed.

Standings row

🥇

Davecouch ×1.5

285

190 raw · 63%

The core game surface — medals, tier, bar, adjusted vs raw.

Chat bubbles

Dave · log pushups 40!

💪 Dave logs 40 push-ups ✅camera

Bot ↔ player surface (demo page, app feed). Bot bolds in lime.

Taunt card

😤 Dave is saving their reps for the off-season, apparently.

AI-generated with canned fallback. Cheeky, never mean.

Charity pot card

💰 Charity pot$20.00Dave picks — Beyond Blue

Winner directs, never receives. Employer-fundable.

Ladder row

1Dave🔥 ×413 pts

Season standings: position, streak, points.

Command chips

newjoin couchlog pushups 25!s

The chat grammar — identical on WhatsApp and Slack.

Result card

match completeDave takes itadjusted 285 · Ben closed at 300 raw

Generated as branded 1200×675 SVG/PNG — the shareable artefact.

Stat card

285adjusted score

Numbers with meaning. Mono numerals, lime emphasis.

Status pill

install pendingcomplete

Lifecycle states across hub console + matches.

QR connect

▨ scan → link crew

wa.me deep link as QR — gym-floor onboarding.

Empty state

No matches yet — start one

Friendly copy + one action. Never a blank screen.

03 · Feature families — all 36 elements

Full backlog with status. Families A–F approved and largely built; G is the proposed second wave.

04 · Progress & roadmap

Phase 0due diligence · research · plan✓ complete

Prototypeengine · bots · app · site · hub · AI · live hosting● you are here — feature-complete demo

MVPunified API wired to app + bots · auth · first real crewsnext

PilotWhatsApp Cloud API · Stripe pots · Slack directory · legal opiniongated

Publicnative apps · wearables v2 · corporate scalegated

What's working today

90+ tests green across engine, bots and API — CI-gated on every push
Push-to-deploy: GitHub → Cloudflare Pages, live in ~20s
Full game loop playable: match → handicap → comeback → close → MVP vote → charity pot → season
WhatsApp bot (via Qalarc Hub) + Slack bot (Bolt) on one command grammar
AI layer live on the public site (guide, narrator, taunts) with graceful fallbacks
Ops + corporate console with live state polling

Top blockers (full register: docs/15)

Slack app needs 5-min human creation → then install link is permanent

WhatsApp Cloud API group support unverified — shapes pilot architecture

Charity-wager legal opinion before real money moves

Bots always-on: minirig kit ready, one SSH command to install

App ↔ API ↔ bots state unification (API built, wiring is mechanical)

05 · Systems map

CLIENTS

Site Three.js + AI guide

App PWA · localStorage

Hub console ops + corporate

Chat WhatsApp · Slack

→

EDGE

Cloudflare Pages rwf.qalarc.com · CI/CD

Pages Functions /api/ai · /api/state

Local serve :4173 · sim · cards

→

CORE

game-core pure TS · 44 tests

bot-core command bus · 22 tests

apps/api unified REST · 24 tests

Qalarc Hub WhatsApp session owner

Full detail: docs/11_SYSTEMS_OVERVIEW.md · hosting decision: docs/16_HOSTING.md