Skip to content

Commit 8d9edac

Browse files
committed
docs(web): document Phase 0 deployment state
Record each site's custom domain, CF Pages project, and canonical *.pages.dev URL. Note that the apex wheels.dev is still served by the CFWheels wheels.dev app and cutover is deferred to Phase 4. Also adds .wrangler/ (at repo root) to .gitignore — local wrangler invocations from the wheels repo root create it.
1 parent 875799b commit 8d9edac

1 file changed

Lines changed: 32 additions & 2 deletions

File tree

web/README.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,5 +26,35 @@ pnpm build # builds all four sites
2626

2727
## Deploy
2828

29-
Cloudflare Pages watches this repo and builds each site when files under its
30-
path change. See the project dashboard for per-site build settings.
29+
Deploys are driven by `.github/workflows/web-deploy.yml`, a matrix job that
30+
runs on push to `develop` (production) and on pull requests (preview). Each
31+
site uploads to its own Cloudflare Pages project via `wrangler pages deploy`.
32+
Path filters ensure the workflow only runs when `web/**` or the workflow
33+
file itself changes.
34+
35+
## Deployed environments
36+
37+
| Site | Custom domain | Cloudflare Pages project | Canonical Pages URL |
38+
| ------- | ------------------- | ------------------------ | -------------------------- |
39+
| Landing | _(Phase 4 cutover)_ | `wheels-landing` | `wheels-landing.pages.dev` |
40+
| Blog | `blog.wheels.dev` | `wheels-blog` | `wheels-blog.pages.dev` |
41+
| Guides | `guides.wheels.dev` | `wheels-guides` | `wheels-guides.pages.dev` |
42+
| API | `api.wheels.dev` | `wheels-api` | `wheels-api.pages.dev` |
43+
44+
Production deploys (on push to `develop`) update each site's canonical URL
45+
and corresponding custom domain. PR preview deploys get a unique
46+
`<hash>.<project>.pages.dev` URL and a persistent branch alias of the form
47+
`<slugified-branch>.<project>.pages.dev`.
48+
49+
The apex domain (`wheels.dev`) continues to serve the CFWheels wheels.dev
50+
app until Phase 4 of the static-site migration. The `wheels-landing`
51+
project exists and deploys on every push, but no custom domain is attached
52+
yet — preview via the `*.pages.dev` URL.
53+
54+
## CI secrets required
55+
56+
The deploy workflow needs two repo secrets (see
57+
`.github/workflows/web-deploy.yml`):
58+
59+
- `CLOUDFLARE_API_TOKEN` — Pages:Edit on the wheels.dev CF account
60+
- `CLOUDFLARE_ACCOUNT_ID``511d04f367103ec276d875ab41a24dea`

0 commit comments

Comments
 (0)