Skip to content

Add interactive Next.js dependency-graph explorer (/explore)#154

Merged
jayhack merged 7 commits into
developfrom
codex/docs-explore-visualization
Jun 22, 2026
Merged

Add interactive Next.js dependency-graph explorer (/explore)#154
jayhack merged 7 commits into
developfrom
codex/docs-explore-visualization

Conversation

@jayhack

@jayhack jayhack commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a single new page — /explore — on top of develop. It renders the
Next.js framework core (packages/next/src) as a force-directed module
dependency graph, parsed with the graph-sitter Rust backend (~4.9s, 1,680
files / 16k symbols).

This is the focused, net-new slice of the earlier docs branch — the docs-site
UI itself already lives on develop, so this PR only adds what's missing.

What's included

  • site/app/explore/page.tsx — the showcase page (graph + top import hubs + the uvx graph-sitter parse recipe).
  • site/components/visualizations/dependency-graph.tsxd3-force layout + hand-rolled HTML5 canvas renderer (Aura-themed, hover/drag/zoom, dark & light); no heavy charting deps.
  • site/lib/data/nextjs-depgraph.json — generated graph data (91 modules, 710 edges).
  • site/scripts/gen-nextjs-depgraph.py — reproducible generator (re-run to refresh the data).
  • site/app/page.tsx — adds an "Explore" link to the homepage nav.
  • d3-force added to site/package.json.

Test plan

  • npm --prefix site run build (Node 22) — clean, 305 static pages incl. /explore.
  • Review /explore in dark and light; confirm graph renders and hover/drag/zoom work.

Made with Cursor

Add a /explore page that renders the Next.js framework core
(packages/next/src) as a force-directed module dependency graph,
parsed with the graph-sitter Rust backend (~4.9s, 1,680 files).

- d3-force layout + hand-rolled HTML5 canvas renderer (Aura-themed,
  hover/drag/zoom, dark & light), no heavy charting deps
- reproducible data pipeline: scripts/gen-nextjs-depgraph.py emits
  lib/data/nextjs-depgraph.json (91 modules, 710 edges)
- homepage nav link to /explore

Co-authored-by: Cursor <cursoragent@cursor.com>
@jayhack jayhack requested a review from a team as a code owner June 22, 2026 16:15
@jayhack jayhack requested review from matthieualouis and removed request for a team June 22, 2026 16:15
@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
graph-sitter Ignored Ignored Preview Jun 22, 2026 4:45pm

Request Review

Resolves the Vercel build-time security gate flagging next-mdx-remote
5.0.0 as vulnerable. v6 is API-compatible with the existing
next-mdx-remote/rsc MDXRemote usage; docs build (305 pages) and render
unchanged.

Co-authored-by: Cursor <cursoragent@cursor.com>
Two coupled Vercel fixes for this subdirectory app:

- framework: "nextjs" — the project's framework preset was unset
  ("Other"), so Vercel ran the build but served the default static
  output dir instead of wiring up Next.js routing, producing a 404 on
  every route. Pinning the framework restores correct Next.js serving.
- ignoreCommand — only build/deploy when site/** or docs/** change
  (docs are sourced from the repo-root docs/ dir at build time), so
  unrelated Python edits no longer trigger preview deployments.

Root Directory is already site/ (root package.json has no build script;
build logs show the graph-sitter-site build running), so no dashboard
change is required.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jayhack jayhack merged commit 4c91c5b into develop Jun 22, 2026
3 of 6 checks passed
@jayhack jayhack deleted the codex/docs-explore-visualization branch June 22, 2026 16:42
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