Skip to content

feat(site): add illustrated product tour and practical guides - #372

Merged
byronwall merged 2 commits into
codex/public-sitefrom
codex/product-guide
Nov 7, 2026
Merged

byronwall merged 2 commits into
codex/public-sitefrom
codex/product-guide

Conversation

@byronwall

@byronwall byronwall commented Nov 7, 2026 •

Copy link
Copy Markdown
Owner

Srcly now has an illustrated product tour and a practical user guide. Real app captures connect the repository map to source inspection, symbol references, and data-flow evidence.

What you'll see

  • Eleven guides grouped into Discover, Use Srcly, and Automate & configure.
  • Six app screenshots, with zoom and keyboard controls.
  • Design decisions grounded in Srcly's own source and a reproducible report example.
  • Section-linked search on desktop and mobile, clear copy feedback, and stable mobile navigation.

Proof

Landing page
The landing page shows the real app and a direct setup action.

Product guide
The guide gives product discovery and first use separate entry points.

Design decisions
The case study connects a real self-inspection scan to the map, ranked list, and source witness.

Before After
Previous mobile guide Updated mobile guide

Mobile readers can search the guide and open Topics without shifting the article.

Mobile search
Search highlights its match and links to the section that contains it.

Screenshot viewer
Readers can enlarge app images and inspect source details without leaving the guide.

pnpm -C site build passes typecheck and creates static HTML for the landing page and eleven guides. All five site browser tests pass. They check static content, local links and images, screenshot zoom and keyboard close, section-linked search, mobile navigation, and copy feedback.

The screenshots come from a local Srcly run at revision 653037aa, using public source and checked-in fixtures. The data-flow capture keeps its real Partial result. A separate content review checked commands, source links, report artifacts, and outcome names against code and real CLI output.

Limits

Screenshots show a fixed source revision. The website does not run repository analysis. Source changes remain in the stack until review; the built site deploys separately to GitHub Pages.

Stack: Srcly public site, layer 2 of 2

This slice: Illustrated product tour, design decisions, expanded task guides, and documentation interactions.
Why it is its own layer: The first layer establishes the static site and deployment. This layer adds real product evidence and a deeper guide.
Full story: #371

@byronwall
byronwall added this pull request to stack #373 November 7, 2026 00:02
@byronwall
byronwall marked this pull request as ready for review November 7, 2026 00:07
@byronwall
byronwall merged commit 0bfb05b into main Nov 7, 2026
8 checks passed
@byronwall
byronwall deleted the codex/product-guide branch November 7, 2026 04: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