Skip to content

feat(site): search, an interactive hero and agent files - #392

Merged
byronwall merged 1 commit into
claude/landing-site-f6a5a4from
claude/landing-site-10x
Nov 20, 2026
Merged

byronwall merged 1 commit into
claude/landing-site-f6a5a4from
claude/landing-site-10x

Conversation

@byronwall

@byronwall byronwall commented Nov 20, 2026 •

Copy link
Copy Markdown
Owner

The site now serves the three people who arrive with a job. A visitor from a link can recolor the hero map and read any tile, and sees the version and supported languages in the first screen. A reader can search everything from the header and link to any metric. A coding agent gets llms.txt, a Markdown copy of every guide, and its own section with the report and explain loop and the repository's agent skill.

What you'll see

  • Hero map you can use: a Complexity / Commits / Findings switch recolors all 1,136 files from real scan data. Point at a tile and the strip below reads out its path, LOC, CCN, commits and findings. The readout strip has a fixed height, so nothing moves. The legend stops come from the metric catalog.
  • Facts in the first screen: the version (1.12.0), full analysis for TypeScript, JavaScript and Python, and size and complexity for the other languages Lizard reads.
  • Search in the header: press /, type, and use the arrow keys and Enter. It covers the guide sections, every docs heading, all 35 metrics and every command, and highlights the match.
  • Metric anchors: #metric-churn_lines jumps to that row and highlights it, so a report or a chat can link a definition.
  • For coding agents (agents/): the report → explain → compare loop with real commands, the skills/srcly-code-quality skill, the stdout contract, and links to the files below. It replaces the old "Give a coding agent a map" workflow tile, so the workflows are now a 2×2.
  • Files for models: /srcly/llms.txt (index), /srcly/llms-full.txt (all guides plus the metric reference, 843 lines), /srcly/metrics.md, and docs/<slug>/index.md beside each guide. Docs pages get a Markdown link next to Edit page and a rel="alternate" link in the head.
  • Header: Guide and Reference left the header, because the path bar under it already lists every section. It is now search, Docs, Agents and GitHub.
  • Narrow screens: below 1000px the hero puts the headline above the map. Before, at 800px, the headline block was taller than the map and covered the legend.

Proof

Commits view, with the pointer on viewModel.test.ts. The strip reads out the file:

Hero colored by commits with a hover readout

Search for "churn": the metric comes first, then the guide section that mentions it:

Header search results for churn

Findings view in dark mode:

Hero colored by findings in dark mode

The agents section:

For coding agents section

#metric-churn_lines lands on its row:

Metric anchor

Before (390px) After (390px)
Phone before Phone after

800px: headline above the map, no overlap:

800px after

llms.txt as an agent reads it (first lines):

# Srcly

> Srcly is a local codebase map for developers and coding agents. It scans a repository into folders, files, functions and nested scopes, ...

For an agent, the usual loop is:

1. `uvx srcly report . --out .srcly`, then read `.srcly/report.md`.
2. `uvx srcly explain . --at <folder | file | file::symbol>` to drill in. Each answer ends with a `Next:` command.
3. `uvx srcly compare --json` to see what a change did, and `uvx srcly check . --ratchet` to stop big files from growing.

## Guides

- [Understand a codebase with Srcly](https://byronwall.github.io/srcly/docs/overview/index.md): Srcly helps you move from a broad view of a repository to the exact code behind a signal.
...

Checks on this branch: pnpm build (12 pages, llms.txt, llms-full.txt, metrics.md and 11 Markdown guides) and pnpm test, 7 passed. A new test presses /, searches "churn", follows Enter to #metric-churn_lines, switches the map to Commits and checks that a tile changes color and the legend height stays fixed. It also fetches every agent file and every link inside llms.txt. Scroll width is 390 at 390px and 800 at 800px.

Limits

  • The docs pages keep their own sidebar search. The header search is on the landing page only, so a docs page never shows two search boxes.
  • Commits are the last 90 days at capture time, so they age until the next capture.mjs run.
  • On a touch screen, a tap on a tile reads it out; there is no hover.

Stack: Srcly site, layer 2 of 2

This slice: the 10x pass for three visitor jobs: an interactive hero, site search, agent files and section.
Why it is its own layer: #391 is the redesign and deploy and can merge alone. This layer adds behavior on top of it and depends on its layout and data files.
Full story: #391

🤖 Generated with Claude Code

- the hero map recolors by complexity, commits or findings and reads out
  the tile under the pointer; version and language facts in the hero
- header search over guide sections, docs headings, metrics and commands
  (/ to focus); every metric row has an anchor
- For coding agents section; llms.txt, llms-full.txt, metrics.md and a
  Markdown copy beside each guide; Markdown link on docs pages
- the hero stacks copy above the map below 1000px

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@byronwall
byronwall added this pull request to stack #393 November 20, 2026 23:02
@byronwall byronwall changed the title feat(site): make the site work for visitors, readers and agents feat(site): search, an interactive hero and agent files Nov 20, 2026
@byronwall
byronwall marked this pull request as ready for review November 20, 2026 23:03
@byronwall
byronwall merged commit c5f1434 into main Nov 20, 2026
10 of 11 checks passed
@byronwall
byronwall deleted the claude/landing-site-10x branch November 20, 2026 23:07
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