chore(docs): publish docs site to GitHub Pages#49
Merged
Conversation
Setup: - next.config.ts: add output='export', basePath='/next-shell', and images.unoptimized when GITHUB_PAGES=true; Vercel is unaffected since it doesn't set that env var - app/page.tsx: convert server redirect() to client-side useRouter.replace so it works in both static export and server-rendered contexts - .github/workflows/deploy-docs.yml: build library → static export docs → upload to GitHub Pages artifact → deploy; triggered on every main push and via workflow_dispatch - eslint.config.js: ignore **/out/** (static export output dir) - apps/docs/.gitignore: ignore out/ directory Docs will be live at https://jonmatum.github.io/next-shell/docs once GitHub Pages source is configured to "GitHub Actions" in repo settings. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
jonmatumdev
approved these changes
Apr 17, 2026
Collaborator
jonmatumdev
left a comment
jonmatumdev
left a comment
There was a problem hiding this comment.
All checks passed. AI review found no issues. Auto-approved.
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
2 participants
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
output: 'export'+basePath: '/next-shell'innext.config.tswhenGITHUB_PAGES=true— Vercel stays on SSR modeapp/page.tsxconverted from serverredirect()to client-sideuseRouter.replace(static export doesn't support server redirects).github/workflows/deploy-docs.yml— builds library → runs fumadocs static export → uploads artifact → deploys to Pages on everymainpusheslint.config.jsadds**/out/**ignore (static export output)apps/docs/.gitignoreignoresout/What is intentionally NOT in this PR
One-time GitHub setup required
Go to Settings → Pages → Source and set it to "GitHub Actions" (not the default branch/folder option). The workflow will handle the rest automatically.
Docs will be live at: https://jonmatum.github.io/next-shell/docs
Verification