Skip to content

docs(readme): retake the screenshots against the reworked pages - #93

Closed
Fl0p wants to merge 1 commit into
mainfrom
flo-592-readme-screenshots
Closed

docs(readme): retake the screenshots against the reworked pages#93
Fl0p wants to merge 1 commit into
mainfrom
flo-592-readme-screenshots

Conversation

@Fl0p

@Fl0p Fl0p commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

The README hero shot was taken before the Overview rework. It showed the user-search cloud that has since been deleted, Sessions at the top of the page, KPI labels hardcoded to (30d), and no range switcher — a picture of software that no longer exists.

What is in here

  • New hero — the current Overview: range switcher in the header, KPI row, the Users top-5 block, History.
  • New ## Screens gallery — Sessions, Costs, Users, Tools.
  • scripts/seed-demo.py — fills a throwaway instance with a synthetic team (7 users, 3 models, 90 days, ~485 sessions / ~25 600 spans). It goes in over the OTLP endpoint rather than writing to DuckDB, so the numbers on the page are what ingest, cost derivation and the roll-up actually produce. Fixed RNG seed, so a re-run against a fresh volume reproduces the same figures.
  • scripts/shoot-screenshots.mjs + docs/operations/screenshots.md — the retake recipe. Each page is cropped at the bottom edge of a named element, not at a pixel count, so a row-height or chart-size change cannot slice a card in half next time.

Two stale things the retake surfaced, fixed here: the logo <img src="assets/logo.svg"> pointed at a path that does not exist in the repo (broken image on GitHub) and the "current release" tag still read :0.2.

Why synthetic data

Real telemetry carries real user names and real spend, and a screenshot is forever. The seeder sends only the attributes Claude Code actually sends — in particular no command on Bash spans — so the Tools page shows the same "no command detail in this data" state a real install sees rather than advertising a view nobody gets.

Verification

  • docs/ VitePress build: vitepress buildbuild complete in 5.95s, no dead links (the Deploy Docs job fails fatally on those).
  • Screenshots taken from cotel:flo592 built from this branch's base (2ff50d4), seeded, then shot with the committed scripts/shoot-screenshots.mjs — the committed script is what produced the committed images.
  • No Go or frontend source touched.

🤖 Generated with Claude Code

The hero shot predated the Overview rework: it showed the user-search
cloud that has since been deleted, Sessions at the top of the page, KPI
labels hardcoded to (30d) and no range switcher. It is replaced by the
current Overview plus a Screens gallery of Sessions, Costs, Users and
Tools.

The images come from a throwaway instance seeded by scripts/seed-demo.py
rather than from production, so no real user name or real spend is
published. The seeder goes in over the OTLP endpoint instead of writing
to DuckDB, so the numbers on the page are what ingest, cost derivation
and the roll-up actually produce, and it sends only attributes Claude
Code sends — no command on Bash spans, so the Tools page keeps the same
"no command detail" state a real install has. scripts/shoot-screenshots.mjs
crops each page at the bottom edge of a named element, so a row-height
or chart-size change cannot slice a card in half on the next retake.

Also fixes two stale things the retake surfaced: the logo <img> pointed
at assets/logo.svg, a path that does not exist in the repo and rendered
broken on GitHub, and the current-release tag still read :0.2.

Co-Authored-By: Daedalus <daedalus@agents.flopbut.local>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Aug 20, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 74558c23-5f5c-4f0f-9c95-f7e5b470a1a5


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Fl0p

Fl0p commented Aug 20, 2026

Copy link
Copy Markdown
Contributor Author

Squash-merged to main as f0fd755 (locally, to keep author+committer = agent identity per the repo's merge rule). Board approved the visual review on FLO-592.

@Fl0p Fl0p closed this Aug 20, 2026
@Fl0p
Fl0p deleted the flo-592-readme-screenshots branch August 20, 2026 22:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant