From a72d53de51ac3cfbef140764f5f5b48a755ec174 Mon Sep 17 00:00:00 2001 From: "claude@clouddev1" Date: Thu, 11 Jun 2026 15:37:11 +0000 Subject: [PATCH] docs(website-adr): hosting target Vercel -> Cloudflare via Gitea Actions Record the deployment decision (2026-06-11): static build deploys to Cloudflare (Workers static assets or Pages; no Astro adapter needed), driven by a planned Gitea Actions pipeline. Update the ADR-website-001 index entry to match. --- docs/website/adr/20260604-adr-website-001.md | 16 +++++++++++----- docs/website/adr/README.md | 2 +- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/website/adr/20260604-adr-website-001.md b/docs/website/adr/20260604-adr-website-001.md index 6b180e1..a03011b 100644 --- a/docs/website/adr/20260604-adr-website-001.md +++ b/docs/website/adr/20260604-adr-website-001.md @@ -74,11 +74,17 @@ planning + `/runda` pass with the user and are recorded below. and the rusqlite **backup-API** undo (ADR-0006) → a SQL dump/restore. When taken up, this becomes its own ADR + iteration plan. -4. **Hosting — portable static build; Vercel is the likely target.** Astro 6 - builds to static HTML/CSS with no adapter, so the output deploys equally - to Vercel, Cloudflare Pages, Netlify, or GitHub Pages. We avoid coupling - to any one host. **No CI yet** — the site is tested locally (`pnpm dev` / - `pnpm build`) until the repo reaches its public home. +4. **Hosting — portable static build; Cloudflare is the target (decided + 2026-06-11).** Astro 6 builds to static HTML/CSS with no adapter, so the + output deploys equally to Cloudflare, Vercel, Netlify, or GitHub Pages — we + stay uncoupled from any one host. **Planned pipeline: Gitea Actions → + Cloudflare.** Cloudflare now steers new projects to **Workers (static + assets)** over Pages; either serves the static `dist/` and needs no Astro + adapter (the `@astrojs/cloudflare` adapter is only for SSR, which the site + does not use). The future in-page WASM playground (§3), if it needs + COOP/COEP headers, can get them from Cloudflare `_headers`. **No CI yet** — + the site is tested locally (`pnpm dev` / `pnpm build`) until the repo reaches + its public home, when the Gitea Actions workflow lands. 5. **Repo topology — monorepo.** The site lives under `website/` in the playground repo; the crate stays at the repo root. The repo as a whole diff --git a/docs/website/adr/README.md b/docs/website/adr/README.md index 5fcc977..8d03b3c 100644 --- a/docs/website/adr/README.md +++ b/docs/website/adr/README.md @@ -16,4 +16,4 @@ applies here too). ## Index -- [ADR-website-001 — Public website and documentation site](20260604-adr-website-001.md) — **Accepted 2026-06-04** (formerly ADR-0044 in the main index; moved here 2026-06-10 to end recurring cross-branch number collisions). The first public website: a marketing landing page plus the **canonical** user docs. Stack **Astro 6 + Starlight + Tailwind v4** (chosen over SvelteKit + Tailwind for a docs-heavy + marketing site; interactive bits as Astro islands). Showcase demos are **asciinema** `.cast` recordings (scripted-input driver for paced, re-recordable sessions — *not* `history.log` replay), reused inline in docs. The **in-page WASM playground is deferred** (OOS: deferred) behind a stable `Demo` seam, with the portable-core vs native-edge boundary recorded for a future ADR + iteration plan. Portable **static build** (Vercel target, but host-agnostic); **no CI yet**; **monorepo** (`website/`). Docs cover the **full supported feature set** with "planned" callouts for the unshipped minority; two wording rules bind user-facing copy — **no engine name** (continues ADR-0002) and **no "DSL"** ("simple mode" / "advanced mode"). Install docs cover **prebuilt binaries + package managers** (D1–D3 track the release tooling). Plan: [`docs/website/plans/20260604-website-implementation-plan.md`](../plans/20260604-website-implementation-plan.md) +- [ADR-website-001 — Public website and documentation site](20260604-adr-website-001.md) — **Accepted 2026-06-04** (formerly ADR-0044 in the main index; moved here 2026-06-10 to end recurring cross-branch number collisions). The first public website: a marketing landing page plus the **canonical** user docs. Stack **Astro 6 + Starlight + Tailwind v4** (chosen over SvelteKit + Tailwind for a docs-heavy + marketing site; interactive bits as Astro islands). Showcase demos are **asciinema** `.cast` recordings (scripted-input driver for paced, re-recordable sessions — *not* `history.log` replay), reused inline in docs. The **in-page WASM playground is deferred** (OOS: deferred) behind a stable `Demo` seam, with the portable-core vs native-edge boundary recorded for a future ADR + iteration plan. Portable **static build** (**Cloudflare** target via **Gitea Actions**, host-agnostic); **no CI yet**; **monorepo** (`website/`). Docs cover the **full supported feature set** with "planned" callouts for the unshipped minority; two wording rules bind user-facing copy — **no engine name** (continues ADR-0002) and **no "DSL"** ("simple mode" / "advanced mode"). Install docs cover **prebuilt binaries + package managers** (D1–D3 track the release tooling). Plan: [`docs/website/plans/20260604-website-implementation-plan.md`](../plans/20260604-website-implementation-plan.md)