Files
Noel Sabia 2bc52a314d
ci / check (push) Successful in 55s
feat: build the Cool City public route demo
- add /cool, /cool?vote=1, /cool/stage and /cool/city on the existing Nuxt/Onyx stack
- wire real route/shade metrics and OSM geometry from the route bundle; city-gap data for the city view
- show shade % and direct-sun minutes together; recommend Accessible for Ruth with the 15% ramp trade-off
- add in-memory time/scene/round state and one anonymous vote per session, polled every 2 s
- keep the retail module linked but out of the Cool City story
2026-11-14 13:49:22 +01:00

3.4 KiB

version, slug, primary_target, related_targets
version slug primary_target related_targets
1 cool cool
/cool/stage
/cool/city
/plan

Surface brief — Cool City decision demo

Scope

Primary: /cool (public, person-first route decision). Related: /cool/stage (projector keynote), /cool/city (cooling-gap module), /plan (retail module, linked only).

Audience and job

Ruth, 78, lives alone — a composite, not a real person. She needs bread from Marktplatz on a hot day. The phone answers which way now; the stage tells the room the same story. The audience votes; the model recommends Accessible for Ruth.

Success

  • /cool is minimal: Ruth card, time slider, three route cards with shade and direct-sun minutes, vote buttons. No map dashboard, sensor table, weather card or methodology paragraphs.
  • /cool?vote=1 is only the question and three buttons. No map, no PII.
  • /cool/stage is a keynote: Ruth card → Cool places → Data honesty → Find routes → 10:00→16:00 → Start vote → Lock vote → City view → Retail module → close. Quiet presenter controls, exact labels.
  • The key insight is visible: the shaded route is 732 m / 9.8 min, 50.0% shade but 4.9 direct-sun min versus the shortest 359 m / 4.8 min, 43.8% shade, 2.7 min, with a 15% ramp. The accessible route is 438 m / 5.8 min, 43.8% shade, 3.3 min, no ramp, water and benches.
  • Real route/city JSON only; missing values are hidden or TBD.

Constraints

Real data: public/cool-city/route.json (normalised from shade.json, routes.geojson, places.json) and public/cool-city/city-gap.json. No retail numbers on Cool City. Onyx stays, themed with the system UI stack. Shared time/phase state is in-memory Nitro; vote per round. No PII. Keep SSR, accessibility, reduced motion, build/tests.

Direction contract

THESIS: A live demo, not a dashboard. One decision: which way should Ruth go now? Apple-like clarity — less information, more confidence — with the map as stage content and a minimal phone flow.

OWN-WORLD: Warm off-white #F6F3EE, near-black #121212, heat #E4572E, shade/water #2F6FED, system UI stack, tabular numerals, 28 px translucent surfaces, soft shadows, generous 8-point space, subtle state motion. Stage inverts to #0B1114 with bright heat and shade.

STORY: Ruth card. The city has cool places but no route. Three routes; at 10:00 the shortest is fine; at 16:00 shade % and direct-sun minutes disagree. The shaded route takes twice as long for 4.9 sun minutes; the shortest has a 15% ramp; the accessible route is one minute longer with no ramp, water and benches. The room votes; the model recommends Accessible for Ruth. Close: "The pulse is not the people. But the city still has to protect them."

FIRST VIEWPORT: /cool — Ruth card, time slider, route cards with accessible first. /cool/stage — Ruth card first; then the dark route board at Find routes, with the exact labels and presenter strip.

FORM: Pinned by COOL_CITY_DESIGN.md and presentation/cool-city-demo-script.md; no roll. seed: none (pinned) — "The frontend is a live demo, not a dashboard. Less information, more confidence. ... Apple-like clarity, not an Apple skin. ... full-bleed map ... floating bottom sheet ... one typeface, one accent, subtle motion, immaculate finish."

FINISH: unreviewed and undocumented is unfinished; this build ends with the finish review, the verdict, DESIGN.md, and every shipping raster carrying its provenance.