Skip to content

Commit 9e2ffa4

Browse files
t3dotggclaude
andcommitted
docs(release): say which Vercel hostnames move before the release
--skip-domain keeps the custom domains on the previous deployment, but it still moves each project's own *.vercel.app production hostname at build time. The web app's hostname is behind Vercel SSO, so users still only receive a client after its npm package exists. Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
1 parent d0a7a5a commit 9e2ffa4

2 files changed

Lines changed: 12 additions & 5 deletions

File tree

‎.github/workflows/release.yml‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -949,9 +949,11 @@ jobs:
949949
AUR_SSH_PRIVATE_KEY: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
950950

951951
# Vercel builds the hosted web app while the desktop jobs run. `--skip-domain`
952-
# stages a production deployment without assigning any domain, so nothing is
953-
# live until deploy_web aliases it after the GitHub Release is published. A
954-
# failed release leaves the staged deployment unaliased.
952+
# keeps the custom domains (the channel and router domains) on the previous
953+
# deployment until deploy_web aliases them, after the GitHub Release. It does
954+
# still move the project's own *.vercel.app production hostname at build time.
955+
# That hostname sits behind Vercel SSO and is not a user channel, so the
956+
# npm-before-client order in docs/operations/release.md holds for users.
955957
build_web:
956958
name: Build hosted web app
957959
needs: [preflight, relay_public_config]
@@ -1122,8 +1124,9 @@ jobs:
11221124
"${vercel_scope_args[@]}"
11231125
fi
11241126
1125-
# Same split as the web app: build a staged production deployment early,
1126-
# then promote it once the release it links to exists.
1127+
# Same split as the web app: build a production deployment early, then
1128+
# promote it to t3.codes once the release it links to exists. As above, the
1129+
# project's own *.vercel.app hostname moves at build time.
11271130
build_marketing:
11281131
name: Build marketing site
11291132
needs: [preflight]

‎docs/operations/release.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,10 @@ The workflow enforces this ordering:
306306
1. `publish_cli` publishes the exact release version to npm, on every channel.
307307
2. `release` depends on `publish_cli` before exposing desktop artifacts in GitHub Releases.
308308
3. `deploy_web` depends on `release` before moving the hosted channel to the new client.
309+
`build_web` builds that client earlier with `vercel deploy --prod --skip-domain`, which
310+
leaves the custom domains alone but moves the project's own `*.vercel.app` production
311+
hostname. That hostname is behind Vercel SSO, so users only get the client through the
312+
custom domains.
309313

310314
Preserve these dependencies when changing the release graph. Publishing a client first would leave
311315
the **Update server** action targeting a package version that does not exist yet.

0 commit comments

Comments
 (0)