docs: document Fastly/Deno/AWS/GCP host feasibility in README - #419
Conversation
Summarize the portability investigation (#369, spec/portability.md) in the root README's "Running it" section: call out home-server/NAS self-hosting and top indie hosts explicitly, add AWS/GCP container deployment notes, add an exploratory Deno Deploy subsection with its known gaps, and name Fastly Compute/Lambda@Edge/Puter as non-goals. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019f72oJFhroHY4eDKj5uF3M
|
The Generated by Claude Code |
davidwkeith
left a comment
There was a problem hiding this comment.
Reviewed against CONTRIBUTING.md. Verified locally on this branch: pnpm lint, pnpm format:check, and npx prettier --check README.md all pass; docs-only change so the rest of the CI gate (typecheck/build/test) is unaffected — no publishable package touched, confirmed no .changeset/ entry is needed per §"Record a changeset."
Checklist conformance: section headings (Summary, Packages affected, Checklist) kept verbatim, unchecked items each carry a one-line reason rather than being deleted — matches the "leave unchecked with a reason" rule. Commit/PR title (docs: document Fastly/Deno/AWS/GCP host feasibility in README) follows Conventional Commits with no scope, correct for a repo-wide docs change.
Content checks: the new packages/server/README.md#deploying-to-aws-gcp-or-any-other-cloud anchor and the spec/portability.md / spec/packages/deno-host.md / spec/deno-deploy-design.md links all resolve to real sections/files on this branch.
One thing worth a look before merge — left as an inline comment on the Deno Deploy gaps paragraph: it'll go stale if PR #418 (KV-backed queue emulation) merges first, since that PR closes the queue gap this paragraph describes as still open. Not a reason to hold this PR, just flag it for whichever of the two merges second.
Also noting for visibility, not this PR's problem: the github-advanced-security check is failing on both this PR and #418 with model_not_supported from the Copilot code-review agent's backend — an infra/config issue upstream of the diff, not something fixable from here.
Generated by Claude Code
#418 implemented the KV-backed queue emulation (#399), leaving only the object-storage adapter (#400) as the remaining gate for @dwk/deno-host. Follow-up to #419 per the review thread there. Claude-Session: https://claude.ai/code/session_019f72oJFhroHY4eDKj5uF3M Co-authored-by: Claude <noreply@anthropic.com>
Summary
spec/portability.md, docs: investigate multi-provider portability feasibility #378/Multi-provider portability: implementation plan (tracking) #384): document the final state in the root README's "Running it" section rather than leaving the provider picture scattered across spec docs only.@dwk/serverDocker image, no code changes — linking topackages/server/README.md's existing detailed per-provider notes.@dwk/deno-host's current state: SQL shim + actor/alarm emulation implemented, queue + object-storage shims still gated, external libSQL/Turso dependency trade-off unresolved.spec/portability.mdfor the full reasoning and re-evaluation triggers.spec/portability.mdto the Documentation list.No runtime code changed — this is a README-only documentation update summarizing conclusions that were already recorded in
spec/portability.md,spec/packages/deno-host.md, andpackages/server/README.md.Packages affected
None (root
README.mdonly — no publishable package touched).Checklist
spec/packages/and updated them if behaviour changed — not applicable, no behaviour changed; this summarizes existing spec conclusions in the READMEsrc/*.test.ts) — not applicable, no code changedpnpm lint && pnpm format:check && pnpm typecheck && pnpm build && pnpm test— rannpx prettier --check README.md(passes); full gate not run since no package code changedpnpm changeset) if this touches a publishable package — not applicable, no publishable package touchedcatalog.json/conformance/status.jsonif this adds a new mountable worker or changes conformance status — not applicable, no new worker or conformance changeGenerated by Claude Code