blog(deployment): "Going Live: A Static Next.js App on a Custom Domain"#237
Merged
Conversation
A go-live runbook: pick a canonical domain (when you own several), GitHub Pages vs Vercel, DNS + the basePath drop (public/CNAME as the switch), the Supabase auth-redirect allow-list gotcha that silently breaks sign-up, PWA manifest scope, and the "CNAME must not exist" invariant that inverts at go-live. Written as the runbook for the Held Paws custom-domain launch (RescueDogs #25-#30). - public/blog/custom-domain-go-live.md (~1,700 words) - public/blog-images/custom-domain-go-live/featured-og.{svg,png} - regenerated blog-data.json (now 11 posts) Verified: type-check + lint clean; build (NEXT_DIST_DIR=.next-ci) generates the post with full content. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
A go-live runbook blog post — the tutorial Jon (schlajo) follows tonight to take Held Paws to a custom domain, written so he corrects it in practice and it becomes the published post.
Covers, in order: pick a canonical domain (when you own several), GitHub Pages vs Vercel (both paths documented), DNS + the basePath drop (
public/CNAMEas the load-bearing switch), the Supabase auth-redirect allow-list gotcha that silently breaks sign-up on launch day, PWA manifest scope, and the "public/CNAMEmust not exist" invariant that inverts at go-live. Ends with a launch checklist.Grounded in the real RescueDogs setup (static export, basePath auto-detect, Supabase redirect coupling). Pairs with the RescueDogs go-live tickets #25–#30.
Files
public/blog/custom-domain-go-live.md(~1,700 words / ~9 min runbook)public/blog-images/custom-domain-go-live/featured-og.{svg,png}src/lib/blog/blog-data.json— regenerated, now 11 postsVerification
NEXT_DIST_DIR=.next-ci) exits 0, statically generates the post with full content (title, basePath section, Supabase auth-redirect section)Live after merge:
https://tortoisewolfe.github.io/ScriptHammer/blog/custom-domain-go-live🤖 Generated with Claude Code