# `docs/benchmarks-site/` — source for `https://benchmarks.weeyuga.com`

> **Scope-isolated mini-project.** This directory builds the public-
> facing benchmarks site at `benchmarks.weeyuga.com`. **Sister-site
> to `weeyuga.com`, NOT a fork or shared-stylesheet.** Files in
> `docs/landing/` are off-limits to anyone working in this tree —
> see [scope-isolation broadcast (2026-05-05T23:30Z)](../../coordination/messages/2026-05-05T233000Z-landing-page-developer-tomas-broadcast-benchmarks-site-scope-isolation-from-weeyuga-com.md).

## What's here

| Path | What |
|---|---|
| `index.html` | `/` calm landing — three-hardware walk |
| `benchmarks/index.html` | `/benchmarks` browse + filter |
| `benchmarks/<slug>.html` | per-benchmark detail (rendered from catalogue) |
| `findings/index.html` | `/findings` synthesis-posts list |
| `findings/<slug>.html` | individual synthesis post (Janie's J1 first) |
| `methodology.html` | how-we-measure |
| `data.html` | GitHub archive + bulk download links |
| `about.html` | 1-page intro |
| `compare.html` | Phase 2 placeholder — "Coming soon" |
| `style.css` | own stylesheet, copies tokens from `weeyuga.com` |
| `catalogue.json` | dummy until Ben's B1 lands |
| `assets/photos/` | hardware photos (Andre's A2 dispatch) |
| `assets/charts/` | pre-rendered SVG charts (build-time) |

## Track

`benchmarks-weeyuga-com` track, started 2026-05-05 17:30Z by Sloba's
[broadcast kickoff](../../coordination/messages/2026-05-05T173000Z-sloba-broadcast-benchmarks-weeyuga-com-kickoff.md).

- **Lane A (this directory):** Tomas — IA + design + build + deploy
- **Lane B:** Ben — `catalogue.json` + public GitHub archive
- **Lane C:** Bane — DNS / nginx vhost / TLS / deploy plumbing
- **Lane D:** Miljan + Stevan — pre-launch security audit (gate)

Phase 1 = MVP without compare dashboard. Phase 2 adds `/compare`.

## Building

Phase 1 is hand-rolled HTML/CSS, minimal JS. **No build pipeline** —
edit, save, push, Bane's rsync syncs to cicd. Per-bench detail pages
get rendered server-side at deploy time by a small Python script
(`build.py`, lands once schema is locked with Ben).

## Style

Aesthetic guardrails from Sloba (verbatim): *"a nice calm landing
page that doesnt look like a spaceship with millions of gadgets but
is in fact a nice pleasant place that slowly introduces them to how
the benchmarks are organised."*

- Whitespace-heavy. No spaceship.
- One concept per screen on landing.
- Real hardware photos > stock illustrations.
- Body 18-20px+, generous line-height.
- Reuse `weeyuga.com` brand language (palette, type, chip motif) —
  copied tokens, not shared stylesheet.

## Stewardship

`mac/landing-page-developer-tomas` is the owner. Coordination via
the bus (`coordination/`). Sloba ratifies at three checkpoints:
wireframe (✓ greenlit 2026-05-05T23:35Z), landing first cut, pre-
launch dry-run.