Skip to content

Docs site (Next/Vercel migration) + interactive Next.js dependency explorer#152

Closed
jayhack wants to merge 196 commits into
developfrom
codex/docs-cleanup-usecases
Closed

Docs site (Next/Vercel migration) + interactive Next.js dependency explorer#152
jayhack wants to merge 196 commits into
developfrom
codex/docs-cleanup-usecases

Conversation

@jayhack

@jayhack jayhack commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Lands the migrated Vercel/Next.js docs site (in site/) plus a new
interactive dependency-graph explorer, on top of the rust-rewrite base.

Important

This branch is based on rust-rewrite, so the diff into develop includes
the full rust-rewrite history (~196 commits). The net-new work specific to
this branch is the docs-site polish and the /explore visualization.

Docs site

  • Mintlify → Next.js (App Router) migration, content sourced from root docs/ at build time.
  • shadcn + Aura Dark design pass: tighter layout, no decorative icon "eyebrows", readable system fonts, working dark/light toggle.
  • Syntax highlighting via rehype-pretty-code on the Aura Dark palette.

Next.js dependency explorer (/explore)

  • Force-directed module graph of the Next.js framework core (packages/next/src), parsed with the graph-sitter Rust backend (~4.4s, 1,680 files / 16,003 symbols).
  • d3-force layout + hand-rolled HTML5 canvas renderer (Aura-themed, hover/drag/zoom, dark & light), no heavy charting deps.
  • Reproducible data pipeline: site/scripts/gen-nextjs-depgraph.py emits site/lib/data/nextjs-depgraph.json (91 modules, 710 edges).

Test plan

  • npm --prefix site run build (Node 22) succeeds — 305 static pages.
  • Review /docs, /, and /explore in dark and light.
  • Confirm the dependency graph renders and interactions work.

Made with Cursor

jayhack added 30 commits June 18, 2026 11:46
jayhack and others added 22 commits June 19, 2026 17:37
Polish the migrated Next.js docs site with a tighter, shadcn-based
layout on the Aura palette. Drop the stacked icon "eyebrow" chips on
cards in favor of title-led, hairline-divided grids, condense section
rhythm across the homepage, and clean up the MDX Card. Dark mode is the
default with a working light-mode toggle; code surfaces stay Aura-dark
in both. Uses system fonts throughout.

Co-authored-by: Cursor <cursoragent@cursor.com>
# Conflicts:
#	site/app/docs/[[...slug]]/page.tsx
#	site/app/globals.css
#	site/content/docs/pages.ts
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. Includes a d3-force +
canvas client component (Aura-themed, hover/drag/zoom, light & dark),
a generator script that emits the module graph JSON, and a homepage
nav link.

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

codecov Bot commented Jun 22, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@jayhack

jayhack commented Jun 22, 2026

Copy link
Copy Markdown
Contributor Author

Superseded by #154. The docs-site UI already landed on develop, so this branch's full rust-rewrite-based merge was redundant and conflict-heavy. #154 adds only the net-new /explore visualization cleanly on top of develop.

@jayhack jayhack closed this Jun 22, 2026
@mintlify

mintlify Bot commented Jun 22, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
graph-sitter 🟢 Ready View Preview Jun 22, 2026, 4:27 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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