Skip to content

chore: fumadocs + release workflows + homepage#1

Merged
ericallam merged 3 commits intomainfrom
chore/release-workflow
Mar 9, 2026
Merged

chore: fumadocs + release workflows + homepage#1
ericallam merged 3 commits intomainfrom
chore/release-workflow

Conversation

@ericallam
Copy link
Member

Summary

  • Migrate docs from Mintlify to fumadocs (Next.js 16, Tailwind v4, fumadocs v16)
  • Merge landing page into the same Next.js app (homepage at /, docs at /docs)
  • Add llms.txt, llms-full.txt, and per-page .mdx endpoints for AI agents
  • Add changesets release workflows (version PR + npm publish with OIDC provenance)
  • Add pnpm workspace so pnpm docs:dev works from root
  • Delete standalone website/ directory

Setup required

  • Add NPM_TOKEN secret and npm-publish environment to the repo for npm publishing
  • Connect to Vercel for docs deployment

Test plan

  • pnpm --filter agentcrumbs-docs dev starts docs at localhost:3100
  • Homepage renders at /
  • All doc pages render at /docs/*
  • /llms.txt returns page index
  • /llms-full.txt returns all docs as markdown
  • /docs/quickstart.mdx returns raw markdown
  • Code syntax highlighting renders correctly in dark mode

Changesets action creates a "version packages" PR when changesets are
present on main. Merging that PR triggers npm publish with OIDC
provenance. Requires NPM_TOKEN secret on the repo.
Two workflows:
- changesets-pr.yml: creates/updates a "version package" PR when
  changesets land on main
- release.yml: publishes to npm with OIDC provenance when the
  version PR is merged

Uses npm 11.6.4 for OIDC support. Requires npm-publish environment
and NPM_TOKEN secret on the repo.
- Replace Mintlify with fumadocs (Next.js 16 + Tailwind v4)
- Move landing page into the same Next.js app at /
- Docs at /docs with fumadocs v16 layout and navigation
- Add llms.txt, llms-full.txt, and per-page .mdx endpoints
- Add pnpm workspace for docs
- Add changesets release workflow and GitHub Pages workflow
- Delete standalone website/ directory
@ericallam ericallam merged commit 8d31c34 into main Mar 9, 2026
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.

2 participants