Repository navigation
feat(site): redesign the landing page around Srcly's own treemap - #391
Merged
Merged
Conversation
Each section is a treemap scope with the real LOC and complexity of the code behind it. Adds a repeatable capture script, a GitHub Actions Pages deploy, and dark mode. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- capture.mjs takes --ref (default origin/main) so every shot and data file comes from one revision, and waits for compare's summary - compare screenshot, real explain output, metric catalog backticks as code - docs captions match the new screenshots Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Srcly site at byronwall.github.io/srcly now looks like Srcly. The landing page is drawn as a scan of Srcly's own source, and it is a one-page user guide: install, how to read the treemap, every view, workflows, the command line, a reference generated from the metric catalog, and a short "How I built it". A GitHub Actions workflow now deploys the site, so the hand-run
gh-pagespush goes away.What you'll see
e4485453(1,136 files), colored with the app's own attention ramp, with the headline cut into it. It is HTML tiles laid out at build time fromsite/src/data/tree.json, not an image.start/,views/,cli/…). The strip names the part of Srcly that implements the section, with its real LOC and max CCN, linked to GitHub. No number on the page is typed by hand.hotspotsandexplainoutput, all 35 metrics with rollup, languages and definition (from/api/metrics/catalog), languages and analyzers, findings checkers,srcly.toml,.srcly/rulesand env vars.docs/CODE_MAP.md.Style choice. I asked Codex for three mockups grounded in the old page and a real treemap. I built "scope map" in light and used the "thermal" mockup for dark. The third mockup stayed too close to the old page. Both take their tokens from the app's DESIGN.md and
TREEMAP_RAMP, sampled with the app's Lab interpolation, so tiles match the app.Proof
Before, 1440px:
After, 1440px. The hero is Srcly's own source:
Dark mode:
390px phone: the map moves above the headline. Scroll width is 390, so nothing scrolls sideways:
How to read the treemap, with a real
client/srcmap beside the definitions:The views. All 8 screenshots come from
site/scripts/capture.mjs:Command line, with real output from Srcly scanning itself:
Reference tables generated from the metric catalog:
How I built it, light and dark:
A docs page in the new theme:
Checks on this branch:
The new test checks that the landing page renders as static HTML with more than 200 treemap tiles and all 7 sections, and that every image, local link and
#anchorresolves. All 10 external links (byroni.us page and posts, PyPI, uv, GitHub paths) returned 200.Deploy: what changes, and your steps
Today
gh-pagesholds a hand-deployed build of this same Vite site (site/scripts/deploy.mjs, three "Deploy site" commits on 2026-11-06):/,/docs/<slug>/for 11 guides,/screenshots/*.jpg,404.html,robots.txt,sitemap.xml. The new build serves every one of those paths,.nojekyllincluded, so no link breaks. This PR deletesdeploy.mjsandDEPLOY.md.After merge:
main. Later pushes tomainthat touchsite/deploy on their own.gh-pagesbranch once the new deploy is live.Limits
e4485453. Runcd site && node scripts/capture.mjsafter a UI release, then commit. A full run takes about 5 minutes.engine/examples/symbol-graph, because a trace over the whole repository timed out.Public sitecheck builds and tests the samesite/.Stack: Srcly site
What splits: the new Srcly site, in two parts: the redesign with its capture script and Pages deploy, then a pass that makes it work for three visitor jobs (a link click, a docs search, a coding agent).
Why it splits: this PR is a complete site that can deploy alone. The second adds behavior (search, an interactive hero, llms.txt) that a reviewer can judge apart from the look.
Why this split: a split by area (landing, docs, deploy) was the other option. I rejected it because the deploy and the content must ship together to replace
gh-pages, and each area layer would carry half of the new theme.capture.mjs, and the Pages workflow.🤖 Generated with Claude Code