Skip to content

Record the apex flip in infra notes - #18

Merged
nimkimi merged 1 commit into
mainfrom
docs/apex-flip-recorded
Aug 20, 2026
Merged

nimkimi merged 1 commit into
mainfrom
docs/apex-flip-recorded

Conversation

@nimkimi

@nimkimi nimkimi commented Aug 20, 2026

Copy link
Copy Markdown
Owner

Records the apex flip that went live on 2026-08-20. Documentation only — no
code or config changes.

docs/infra.md had been written ahead of the flip with a placeholder date and
"by Nima", and it described the old state as merely "contradicting the code's
canonicals". Two corrections:

What the old state actually was. sitemap.xml fed Google the apex, the apex
308'd to www, and www served a page whose canonical pointed back at the apex.
Every submitted URL redirected away from itself onto a page pointing back at the
redirector, which Google resolves by discarding the canonical. That is a
different and worse failure than a host-preference mismatch, and it was live for
the whole window after the PR #16 SEO work shipped.

How to redo or revert it. The direction is a per-project domain setting and
vercel domains has no subcommand for it — it is API-only. Clearing the old
redirect must come before adding the new one, or the two hosts point at each
other in the gap between calls. DNS is not involved and does not need touching.

Verified live before writing this: apex 200, www 308 → apex with the path
preserved, all 7 sitemap URLs resolving in 0 redirect hops, and canonical /
og:url / JSON-LD @id all matching the host that serves them.

Fills the placeholder date and replaces "by Nima" with what actually
happened: the flip is a per-project domain setting reachable only through
the API, and the ordering matters — setting the new redirect before
clearing the old one points the two hosts at each other.

Also states the failure it fixed, since "contradicting the canonicals"
undersold it: every sitemap URL was redirecting away from itself onto a
page whose canonical pointed back at the redirector.
@vercel

vercel Bot commented Aug 20, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hackimi Ready Ready Preview Aug 20, 2026 9:11am

@nimkimi
nimkimi merged commit 068de22 into main Aug 20, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 52a145cf Deployed Aug 20, 2026 by vercel[bot]
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