feat(docs-next): rebuild homepage to sell the product#301
Merged
Conversation
Every workflow was broken after the Fumadocs migration and the Node 25
Docusaurus breakage. Fixing in one pass.
Problems that were live on main:
- ci.yml, coverage.yml, size.yml, release.yml all ran 'pnpm build'
(no filter). Turbo tries to build every workspace project including
@agentskit/docs, which is Docusaurus-on-Node-25 and crashes on
'mdxCrossCompilerCache'. Every one of these jobs failed in CI.
- docs.yml still deployed @agentskit/docs (old Docusaurus) to GitHub
Pages. That site is a) retired, b) doesn't build anyway. The
replacement lives at apps/docs-next (Fumadocs) and deploys via
Vercel's GitHub integration, not GitHub Pages.
- ci.yml duplicated bundle-size enforcement by hand-rolling a
check_size bash function — size.yml already does this properly
via size-limit with the .size-limit.json budget. Paths were wrong
too (no packages/react/dist/index.js without the preceding build).
- Version drift across workflows: checkout@v4 vs v6, pnpm@v4 vs v5,
node 20 vs 22. doctor's recommendation is Node 22+.
What this does:
1. Standardize every workflow to:
actions/checkout@v4
pnpm/action-setup@v4
actions/setup-node@v4
node-version: 22
2. Replace every 'pnpm build' with 'pnpm --filter "./packages/*" build'.
Legacy docs is not in scope for CI until it's retired.
3. ci.yml — drop the hand-rolled size check. size.yml is the single
source of truth for bundle-size gates.
4. docs.yml — convert from 'deploy Docusaurus to GH Pages' to
'build @agentskit/docs-next on every relevant PR/push'. Deploy
is Vercel's job via the repo's GitHub App integration. Workflow
is now validation-only + path-filtered so it doesn't run for
unrelated changes.
5. release.yml — same filter fix, same version bumps. Changesets
action itself is unchanged.
No i18n wiring — per the i18n strategy RFC, translated content is
frozen during the Fumadocs migration, so the workflow has nothing
to do for locales.
Verified locally:
- pnpm --filter './packages/*' lint → 28/28 passing
- pnpm --filter './packages/*' build → 22/22 passing
- pnpm test → 22/22 passing, 538 tests
- pnpm exec size-limit → every package under budget
- pnpm --filter @agentskit/docs-next build → 74 routes clean
Refs #211
Vercel auto-detected Turbo and started adjusting defaults, which ended up running 'turbo build' at the repo root — that fans out to every workspace including @agentskit/docs (legacy Docusaurus, broken on Node 25). Explicit config pins framework = Next.js, builds packages first so workspace:* resolutions work, then builds the docs site. Skips unrelated commits via ignoreCommand to save build minutes. Paired with this file, the Vercel dashboard should set: Root Directory: apps/docs-next Framework: Next.js (auto-detected from this file) Node.js: 22.x
- Replace minimal hero with full 7-section landing (hero + demo, social proof, problem, solution, benefits, provider strip, CTA) - Add live hero demo: auto-cycling agent conversation that renders real React widgets (weather card, BTC price chart, order tracker, flight list) via tool calls — sells the "agents render components, not markdown" angle - Restore interactive example components (BasicChat, ToolUse, RAG, Multi-Agent, etc.) ported from the legacy Docusaurus site; wire them into each /docs/examples mdx - Fix /docs/examples index links (relative -> absolute) - Make package grid clickable; each card links to its package docs - Add live npm downloads + GitHub stars social-proof bar - Brand tokens (direction B: midnight/foam) applied throughout
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
9 tasks
EmersonBraun
added a commit
that referenced
this pull request
Apr 15, 2026
Main received the squash-merged #301 homepage rebuild; this branch already contains that work plus follow-up polish (contribute hub, animated brand, light mode, SEO, OG per-page, hero-demo scroll fix, domain normalization). Keeping HEAD resolves every conflict since HEAD is strictly newer.
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.
Summary
/docs/examples/*mdx/docs/examples/<slug>)Test plan
pnpm --filter @agentskit/docs-next dev— homepage loads, hero demo cycles through 4 scenes without flicker/docs/...routes/docs/examplesindex links land on the correct example pages/docs/examples/<slug>page renders its live demonpx tsc --noEmitpassesprefers-reduced-motionskips typing/streaming animations