Skip to content

docs(website): overhaul docs and information hierarchy - #721

Merged
sam-goodwin merged 51 commits into
mainfrom
claude/nifty-carson-b4fd1f
Jul 3, 2026
Merged

docs(website): overhaul docs and information hierarchy#721
sam-goodwin merged 51 commits into
mainfrom
claude/nifty-carson-b4fd1f

Conversation

@sam-goodwin

@sam-goodwin sam-goodwin commented Jul 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Restructure the docs into per-provider hubs behind a bun.com-style horizontal tab bar, redesign the docs chrome, and build out provider-scale content across seven tabs (~100 new/reworked pages through research → design → review → write agent pipelines).

Navigation

  • Tab bar: Core · CLI · Cloudflare · AWS · PlanetScale · Neon · More ▾ left, Reference · Blog right. Official brand marks for provider tabs; the More ▾ dropdown holds attach providers by category (Observability → Axiom, Source & CI → GitHub) and renders as the current provider inside its hub.
  • Per-tab scoped sidebars (route middleware), tab-scoped prev/next, custom sidebar renderer (small-caps iconed groups, accent-bar active state), shell capped at 96rem, one surface with hairline dividers and a page-wide accent wash.
  • Sidebars are hub-native: cross-provider links live in page content only; composition guides home in the runtime provider's hub.

Core tab

  • Infrastructure as Code — Stacks / Resources / Actions / Inputs & Outputs / References / Resource lifecycle / Providers / Custom Provider. The Custom Provider guide teaches the full lifecycle (reconcile observe→ensure→sync, delete, diff, read/Unowned, list) with auth reduced to a pointer.
  • Infrastructure as Effects — reordered around a new Overview (/infrastructure-as-effects) that owns the thesis and the one canonical annotated Worker snippet: Overview → Functions & Servers → Bindings → Event Sources → Sinks → APIs → Phases → Layers → Building with Layers → Circular Bindings → Custom Runtime. Functions & Servers (renamed from platform, 301'd) teaches the Effectful Constructor pattern (bind what you need, return what you expose) and the three declaration variants (inline, inline class, tagged Tag/.make() split). The contract-vs-implementation-Layer duality of Bindings (ReadWriteBucket satisfied by ReadWriteBucketBinding or ReadWriteBucketHttp; cross-cloud provides are type errors) is woven through the whole category with the deep treatment on Bindings.
  • APIs (new section) — Overview + Schemaless RPC + Effect RPC + Effect HTTP, mirrored as {} APIs groups in the Cloudflare and AWS hubs (each with its own Schemaless RPC usage page). Doctrine: schemaless typed calls (bind the class, get the client; Streams and tagged errors cross the wire) are the default for internal communication; Effect RPC / Effect HTTP are for trust boundaries, with the per-request Schema cost stated plainly. Hub apis pages keep the cloud wiring and now defer to these.
  • Environments (moved above State Store) — Stages / Profiles / Auth Providers / Custom Auth Provider / Secrets & Config / Local development / CI. Auth Providers documents the lazy credential contract (an Effect resolved at point of use, enabling OAuth/IAM-session auto-refresh) and the per-cloud Environment tags; the guide builds a Stripe auth provider on the real Neon/Planetscale pattern.
  • State Store / Project structure / Testing & observability — File layout, Monorepo → Single Stack / Multiple Stacks (tree-first); Testing concept + Testing a Stack + Testing Providers + Test harness reference.

CLI + provider hubs

  • CLI hub: 15 pages by role — Deploy (deploy/plan/destroy/nuke — first-ever docs for alchemy unsafe nuke — plus Adopting Resources), Develop (dev/tail/logs), Auth, State (+ Inspecting State), Providers; the interactive TUI documented; stale flag tables fixed against command source.
  • Cloudflare / AWS hubs: setup, five-part tutorials, ~12 block pages each grouped by role (Compute/Frontend/APIs/Data/Messaging & events/Email/AI/Security & secrets/Observability/Networking), ~30 guides filed under their categories; schemaless RPC is the recommended Worker/DO pattern (old RPC tutorials 301'd); the Cloudflare Frontend category is a support matrix + per-framework landing pages (Vite as the general resource, TanStack Start/React Router/Vue/SolidStart verified, Astro/Nuxt as TODO pages with honest workarounds).
  • PlanetScale / Neon / Axiom / GitHub hubs: block pages + native guides that own the provider-side pattern and delegate runtime wiring; flattened reference trees.
  • Every page written against source/tests/fixtures with unverifiable claims omitted; adversarial verify passes corrected real API errors (e.g. compatibility: { date } prop shape, BatchGetItem vs multi-table GetItem, required state: on every Stack snippet, sink batching semantics).

File layout

Content files mirror the sidebar taxonomy on disk: Core sections (infrastructure-as-code/, infrastructure-as-effects/, apis/, environments/, state-store/, project-structure/, testing/) and hub categories (compute/, data/, messaging/, email/, ai/, security/, observability/, networking/, …) are real folders — concepts/ and all guides/ dirs dissolve. URLs follow files (100+ changes, all 301'd); llms.txt enumerates the full taxonomy. CLI stays flat so /cli/<command> mirrors command names.

Fixes

  • Duplicate "Workers" reference sections (generator now merges by product, inherits categories, fails on duplicate labels); small providers render flat resource lists.
  • 301 map in worker.ts for every moved URL (markdown-aware), including /infrastructure-as-effects/platform → /infrastructure-as-effects/functions-and-servers.

Screenshots
Landing — pick your provider landing Core tab docs
Cloudflare hub cloudflare Cloudflare hub (dark) cloudflare-dark
AWS hub aws PlanetScale hub (flat Resources) planetscale
Axiom via More ▾ (contextual tab) axiom Reference tab reference

🤖 Generated with Claude Code

sam-goodwin and others added 2 commits July 1, 2026 18:20
@sam-goodwin @claude
feat(website): restructure docs into per-cloud hubs with horizontal t…
d35e614 
…ab bar

- Horizontal docs tab bar (Docs | Cloudflare | AWS | Integrations |
  Reference | Blog); each tab swaps in its own scoped sidebar via route
  middleware, with prev/next pagination kept within the tab
- Cloudflare + AWS hubs: overview (building blocks + recipes), setup,
  building-block pages; tutorial parts 1-5 move to /cloudflare/tutorial
- Schemaless RPC documented as the recommended pattern on the Worker and
  Durable Object pages; rpc-worker/rpc-durable-object tutorials removed
- Integrations tier: PlanetScale, Neon, Axiom, GitHub one-pagers with
  verified credential mechanics
- 301 redirect map in worker.ts for every moved URL (md-aware)
- Fix duplicate "Workers" sidebar groups: @Product typo on Workflow.ts,
  generator now merges service groups by product, inherits per-service
  categories, and fails on duplicate sibling labels
- Landing page: "Pick your cloud" cards + integrations chip strip below
  the hero (hero copy unchanged); llms.txt regenerated to the new tree

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
feat(website): mockup-fidelity docs chrome + AWS tutorial and runtime…
2328dea 
… pages

- Tab bar: left group (Docs, Cloudflare, AWS, Integrations) + right group
  (Reference, Blog), official brand marks for cloud tabs (simple-icons)
  and lucide outlines elsewhere
- Sidebar override: small-caps group headings with monochrome icons,
  flat always-open sections on hub tabs (Reference keeps its collapsible
  tree), active page = accent bar + tint instead of the filled pill
- Cap the docs shell (sidebar + content + TOC) at 96rem and center it
- Cloudflare/AWS sidebars regrouped by role: Compute / Data / Messaging /
  Networking (no more flat "Building Blocks")
- AWS depth: five-part tutorial spine (part 4 is Stages — alchemy dev is
  Workers-only, verified), plus ECS, EC2, and VPC & networking block pages
  grounded in source JSDoc and smoke tests

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@alchemy-version-bot

alchemy-version-bot Bot commented Jul 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Install the packages built from this commit:

alchemy

bun add alchemy@https://pkg.ing/alchemy/2fa8404

@alchemy.run/better-auth

bun add @alchemy.run/better-auth@https://pkg.ing/@alchemy.run/better-auth/2fa8404

@alchemy.run/pr-package

bun add @alchemy.run/pr-package@https://pkg.ing/@alchemy.run/pr-package/2fa8404

sam-goodwin and others added 27 commits July 1, 2026 19:05
@sam-goodwin @claude
fix(website): flatten docs chrome onto one surface
5cfaf72 
Sidebar and docs header now share the page background — division comes
from hairlines plus a faint accent wash at the top of the sidebar,
instead of contrasting panel colors.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
fix(website): page-wide accent wash instead of sidebar-only gradient
f429d71 
The gradient now paints the whole docs page (sidebar, content, TOC)
and fades down bun.com-style; the fixed sidebar goes transparent on
desktop so the wash shows through it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
feat(website): per-cloud Resources section in hub sidebars
29d3208 
Each cloud hub sidebar (Cloudflare, AWS) gains a collapsed "Resources"
group below Guides containing that provider's slice of the generated
reference tree, so a hub tab covers everything from setup to API docs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
fix(website): nested sidebar group labels use entry typography
f9cc65c 
Categories/services inside Resources and the Reference tree rendered
with Starlight's large bold group style; they now match the 13px
regular entries, leaving the heading treatment to top-level groups only.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
feat(website): auto-expand the hub Resources section
d4c7438 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
fix(website): drop "pick one" from the AWS Compute sidebar group
6d74c2f 
Runtimes compose — apps can run any number of them.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
feat(website): provider hubs for PlanetScale, Neon, Axiom, GitHub + M…
6465478 
…ore menu

- PlanetScale and Neon promoted to top-level tabs; Axiom and GitHub live
  in a categorized "More" dropdown (Observability, Source & CI) that
  renders as the current provider when you're inside its hub
- Each gets the full hub skeleton at /{provider}: Overview, Setup,
  Guides (cross-listed from the runtime provider's hub), Resources
- Integrations tab retired: pages split into hub index + setup, 301s
  from /integrations/*, landing page now shows four provider cards
- Mobile: dropdown residents flatten into the scrollable tab row

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): wave 1 — P0 pages from the content plan
f365d7b 
- New block pages: Cloudflare KV, Domains & DNS; AWS Websites; Neon
  Migrations — all grounded in source JSDoc, tests, and examples/
- New guides: custom domains & routes, Worker telemetry to Axiom,
  AWS static site, Effect HTTP API on Lambda
- Accuracy rework of concepts/observability: replaced nonexistent
  AxiomExporter / CloudWatch widget helpers / api.metrics.* with the
  real OTLP layers, DashboardBody shape, and PascalCase alarm props
- Workers page gains custom-domains + InferEnv sections; Hyperdrive
  documents pooledOrigin; hub indexes and sidebars updated

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): wave 2 — P1 pages from the content plan
6394906 
- Cloudflare guides: cron triggers, Secrets Store & auth tokens,
  send & receive email, react to GitHub events; setup documents the
  API key+email CI alternative and OAuth scope customization
- Drizzle and shared-database guides gain PlanetScale Postgres/MySQL
  variants alongside Neon
- AWS block pages: SNS, EventBridge & Scheduler, RDS & Aurora,
  CloudWatch (absorbing their planned guides), plus Route53+ACM
  custom domains and Effect RPC on Lambda guides
- PlanetScale hub: Postgres, MySQL, Migrations block pages; setup
  documents fromToken, base-URL override, CI behavior
- Neon hub: Branching and Connections block pages (pooled vs direct)
- Axiom hub: Datasets & ingest (replacement-deletes-data caution,
  token-in-state note), alerting and dashboards guides
- GitHub hub: Repositories, Actions secrets & variables, Webhooks &
  events block pages; setup documents scopes and env precedence
- All five attach-provider hub indexes reworked; sidebars + llms.txt

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): wave 3 — long tail + native database-provider guides
4f0dc13 
- Test-grounded Cloudflare guides: Vectorize, browser rendering,
  Turnstile, Analytics Engine, Tunnel, Workers for Platforms, and the
  release-agent case study (cloudflare-agent example)
- AWS: EKS block page, Lambda MicroVMs and Secrets Manager guides
- PlanetScale: Credentials and Backups block pages
- Axiom: annotations guide; GitHub index folds in the Comment resource
- Attach-provider sidebars no longer cross-link into other tabs:
  PlanetScale and Neon gain native "Preview branches per PR" and
  "Drizzle ORM" guides that own the provider-side pattern and link out
  to the runtime walkthroughs in content

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
fix(website): flatten small providers' reference trees
470e39c 
Uncategorized providers with ≤16 pages (Neon, PlanetScale, Axiom,
GitHub, Docker, Kubernetes, Command, Drizzle) render as a flat
resource list — per-service folders around one or two pages
("Branch > Branch") were redundant nesting, and prefixed names
(MySQLBranch/PostgresBranch) already carry the grouping.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): Containers building-block page in Cloudflare Compute
836585a 
New /cloudflare/containers block page (what/when vs Workers and DOs,
tagged Container class, DO wiring via Containers.layer, image sources,
ContainerApplication) grounded in the guide, source JSDoc, and test
fixtures; the "Run a Container" guide stays as the deep walkthrough.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): PR screenshots for the docs redesign
9a279d7 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): drop the "Building blocks" grouping
9baeb44 
Compute, Data, Messaging, and Networking are top-level sections on the
hub overviews now; the GitHub sidebar group is flattened; block pages'
"Related building blocks" footers become "Related"; llms.txt sections
renamed to "primary resources".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): script to refresh PR screenshots
65081f9 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
9a92440 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): add Containers to the Cloudflare overview Compute section
178e83a 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
3f1c0cf 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): shared category taxonomy across hubs — guides dump dis…
85282d6 
…solved

- Cloudflare and AWS sidebars share one category set (Compute, Frontend,
  APIs, Data, Messaging & events, Email, AI, Security & secrets,
  Observability, Networking); every guide files under the category it
  serves — the flat Guides group is gone, URLs unchanged
- New block pages from the design→review→write workflow: Workflows and
  Email (Cloudflare) and Secrets & env twins (both hubs, identical
  skeletons) — all snippets source-grounded
- Reviewer-driven connection map applied: 21 cross-link edits across
  existing pages; /guides/secrets and /aws/guides/secrets absorbed into
  the Secrets & env pages with 301s in worker.ts
- Group icons for the new categories; llms.txt updated

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
3512cb7 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): Docs tab taxonomy — Concepts and Guides groups dissolved
437cc63 
- Four categories in reading order: Stacks (write your program), Deploys
  (the engine), Environments (same app in many places), Testing &
  observability; each former guide files beside the concept it extends
- Migrating from v1 and CLI promoted to top links
- 21 pages got reviewed surgical edits: category framing, concept/guide
  pair acknowledgements, Where-next footers forming a coherent tour,
  plural retitles (Stacks, Resources, Bindings, Providers, Actions…),
  stale sidebar frontmatter dropped
- getting-started and what-is-alchemy now fan out to the provider hubs
  (the old flow dead-ended AWS users at the Cloudflare tutorial)
- Group icons + llms.txt regrouped to match; URLs unchanged

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
e16dbd1 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): final Docs taxonomy — IaC/IaE, State Store, Project st…
d50a355 
…ructure

- Categories: Infrastructure as Code (Stacks, Resources, Actions,
  Inputs & Outputs, References, Resource lifecycle, Providers, Custom
  Provider), Infrastructure as Effects (Bindings, Circular Bindings,
  Layers, Building with Layers, Functions & Servers, Phases), State
  Store, Project structure, Environments, Testing & observability
- New pages: File layout (one file per Resource/Layer, group-by-concern
  Db.ts pattern, Effect-wrapped units, stage-conditional config, the
  composition root) and Stack References (the practice split out of
  /concepts/references — staging/pr patterns, infra/app splits, the
  ref-vs-yield decision table)
- Functions & Servers replaces "Platform" as the public name (internal
  type introduced once); Building with Layers replaces "Infrastructure
  layers"; system nouns capitalized across titles/labels
- Effect-style layers icon for Infrastructure as Effects; Where-next
  tour re-mapped; llms.txt regrouped; URLs unchanged

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
35e0274 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): split the Monorepo guide — tree-first, three pages
c04054e 
The 502-line guide becomes a one-screen chooser (Monorepo: two
annotated file trees + how-to-choose) linking two focused walkthroughs
(Single Stack, Multiple Stacks). Every page opens with its file-system
layout before prose; snippets carried verbatim, surrounding prose cut
to 1-3 lines each.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
e3fabed 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): rework Stack References — three forms, zero fluff
85eb933 
Drops the intro framing, rule-of-thumb section, and pattern tables.
The page now flows from Monorepo → Single Stack → Multiple Stacks:
Resource.ref by Logical ID, optional stage/stack props, and importing
a Stack tag to depend on its outputs — one line, snippet, one line.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
sam-goodwin and others added 9 commits July 2, 2026 01:40
@sam-goodwin @claude
chore(website): refresh PR screenshots
0e94d36 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): Stack References leads with the cross-stage form
888bbec 
The no-props same-stack/same-stage ref had no motivating use case as
an opener; the page now starts at Resource.ref(id, { stage }) — the
owner/borrower pattern — then another Stack, then Stack outputs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): fold Stack References into the References concept page
0af9e93 
/concepts/references reworked to the terse three-form spine (another
stage, another Stack, a Stack's outputs) plus condensed escape hatches
and deploy order — the resolution-internals tables and selection
cheatsheet are cut. /guides/stack-references is deleted (301 →
/concepts/references); Project structure is now File layout →
Monorepo → Single Stack → Multiple Stacks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
c93f2a9 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): file-layout opens with the target file tree
5bb37d9 
Orient first like the rest of Project structure: alchemy.run.ts
composition root, src/*.ts resources and Functions/Servers, and
test/*.test.ts, straight from examples/cloudflare-neon-drizzle.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): split Testing into concept, walkthrough, providers, ha…
4a30f4d 
…rness

- /concepts/testing slimmed to the model (~1 screen): real clouds, one
  deploy per suite, stage isolation, deploy → assert → destroy
- /guides/testing-a-stack (new): the end-to-end walkthrough — deploy
  once, drive over HttpClient, first-request retry, bounded polling,
  NO_DESTROY iteration, existing-stack/shared-state/seeding patterns, CI
- /guides/testing-providers (split): test.provider scratch stacks,
  out-of-band cloud assertions, replacement verification — interlocks
  with the Custom Provider guide without duplication
- /concepts/test-harness (split, reference): every Test.make option,
  hook, variant, HttpClient wiring, Bun vs Vitest — anchors preserved
- 7 inbound links retargeted; sidebar + llms.txt updated

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
33e5439 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): CLI hub tab — 694-line reference becomes 15 pages by role
bb50206 
- New primary tab (Docs · CLI · Cloudflare · …) at /cli; the overview
  opens with an annotated command map and documents the interactive TUI
  (TTY detection, ALCHEMY_TUI/ALCHEMY_PLAIN/CI overrides) for the first
  time
- Deploy: deploy, plan, destroy, nuke (own page — the hidden
  `alchemy unsafe nuke`, scan/confirm/multi-pass-delete behavior,
  include/exclude/filter flags, prominent caution), Adopting Resources
  guide (ownership table, --adopt, AdoptPolicy)
- Develop: dev, tail, logs · Auth: login, profile · State: state,
  Inspecting State guide · Providers: aws, cloudflare
- Source beats stale docs: --profile added to plan/destroy tables,
  stage-regex case claim fixed, no-changes deploys skip the prompt
- /guides/cli deleted with a 301 to /cli; inbound links retargeted

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
5463583 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin sam-goodwin changed the title feat(website): per-cloud docs hubs with horizontal tab bar docs(website): overhaul docs and information hierarchy Jul 2, 2026
sam-goodwin and others added 13 commits July 2, 2026 02:38
@sam-goodwin @claude
docs(website): align file locations with the section taxonomy
41589e5 
104 files move into folders mirroring their sidebar sections — Docs
tab: infrastructure-as-code/, infrastructure-as-effects/, state-store/,
project-structure/, environments/, testing/; hubs: compute/, frontend/,
apis/, data/, messaging/, email/, ai/, security/, observability/,
networking/; attach providers gain data/. concepts/ and the four
guides/ dirs dissolve. CLI stays flat (URLs mirror command names);
tutorials were already aligned.

URLs follow files: 102 URL changes codemodded across 163 files, 102
301s appended to worker.ts (existing redirect targets remapped),
llms.txt sections now enumerate the category folders directly.
Sidebars unchanged label-for-label; URL-preserving index.mdx moves for
/cloudflare/email and /aws/networking.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): rename the Docs tab to Core
52b8f7c 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
5318104 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): migrating-from-v1 tutorial CTA offers both clouds
238a731 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): use Console.log inside Effect.gen on the Stack page
541329e 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): IaE reorg, RPC section, Auth Providers, Effectful Cons…
7369621 
…tructor

- Infrastructure as Effects: new Overview owning the thesis + canonical
  snippet; reorder to Overview -> Functions & Servers -> Bindings ->
  Event Sources -> Sinks -> RPC -> Phases -> Layers -> Building with
  Layers -> Circular Bindings -> Custom Runtime
- rename platform.mdx -> functions-and-servers.mdx (301) and reframe
  around the Effectful Constructor pattern + three declaration variants
  (inline / inline class / tagged Tag + .make() Layer)
- dedicated Event Sources and Sinks pages; binding.mdx keeps a light
  intro; contract-vs-implementation-Layer duality (*Binding vs *Http,
  WorkerEnvironment requirement, cross-cloud type error) woven through
  the category with the deep treatment on Bindings
- new Core RPC section (Overview, Schemaless RPC, Effect RPC, Effect
  HTTP): schemaless is the internal default; schema'd modalities for
  trust boundaries; hub apis pages re-framed and fixture-corrected
  (params vs path, HttpPlatform stub, RpcWorker.make signature,
  TaggedErrorClass httpApiStatus)
- Environments moved above State Store; new Auth Providers concept +
  Custom Auth Provider guide (lazy credential contract, OAuth refresh,
  env fallback); custom-provider.mdx refocused on lifecycle with
  required list() and state: on every Stack snippet

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
1a5e946 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): APIs section parity, progressive Effect RPC/HTTP, Fetc…
b3626b6 
…h->RPC intro flow

- rename Core RPC section to APIs ({} braces icon), rpc/ -> apis/ with
  301s; sidebar parity across Core, Cloudflare, and AWS: Schemaless
  RPC -> Effect RPC -> Effect HTTP
- new hub pages cloudflare/apis/schemaless-rpc + aws/apis/schemaless-rpc
  (platform usage + routing; Core owns the concepts)
- apis/effect-rpc + apis/effect-http rewritten progressively: evolving
  ./src file trees (ApiSchema.ts, ApiHandlers.ts, ApiService.ts,
  ApiClient.ts), one concept per heading, diff blocks per step
- functions-and-servers: progressive intro (Effectful Constructor ->
  Fetch -> RPC -> A Worker, end to end) with new Fetch and RPC sections

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
83577bc 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): re-cut APIs pages — cloud-neutral Core, platform detai…
a72cdba 
…l in hubs

- apis/schemaless: pattern-only rewrite — member rules taught by
  progressive examples (functions returning Effect/Stream are the RPC
  surface), typed-client mechanism, transports at pattern level,
  Streams, error codec, limits; platform pairings removed
- cloudflare/apis/schemaless-rpc: progressive pairing walkthroughs
  (Worker->Worker, Worker->DO with streaming, cross-script DO,
  Containers, dynamically-loaded Workers, async consumers), each
  flowing into its deeper guide
- apis/effect-rpc + apis/effect-http condensed to a concise section
  per piece (Schema, Handlers, Serve, Client); Cloudflare specifics
  (RpcWorker/RpcDurableObject sugar, HttpPlatform stub, storage
  wiring) live on the hub pages only
- verify fixes: RPC-callable member rule corrected everywhere, stub
  fetch/connect pass-through qualified, WorkerLoader snippet matched
  to real load() args, missing imports added, CORS attribution fixed

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
b9d3e73 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
docs(website): Cloudflare Frontend redesign — support matrix + per-fr…
cad4013 
…amework pages

- frontends.mdx: overview with at-a-glance support matrix (framework
  -> resource -> status -> guide); Vite framed as any pure-Vite app
- new resource pages: vite.mdx (what the resource invokes, env and
  binding flow, connects to framework pages) and static-site.mdx
- framework landing pages flowing from Vite: vite-spa (React SPA,
  reworked in place), tanstack-start, react-router (incl. RSC), vue,
  solidstart — every support claim cited to an example or live test
- TODO pages with cautions + verified workarounds: astro (StaticSite
  path, proven by this docs site's own deployment), nuxt (untested)
- Vite.ts JSDoc fixed (no Nuxt claim, flat assets examples,
  Cloudflare.Website.Vite) and API reference regenerated
- inbound updates: hub index Frontend section, workers.mdx blurb
  (verified frameworks only), React SPA relabels

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin @claude
chore(website): refresh PR screenshots
2fa8404 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@sam-goodwin sam-goodwin added the deploy-website Deploy the website preview for this PR label Jul 3, 2026
@sam-goodwin
sam-goodwin marked this pull request as ready for review July 3, 2026 04:49
@sam-goodwin
sam-goodwin merged commit aad0e6f into main Jul 3, 2026
16 of 17 checks passed
@sam-goodwin
sam-goodwin deleted the claude/nifty-carson-b4fd1f branch July 3, 2026 04:49
@sam-goodwin sam-goodwin mentioned this pull request Jul 8, 2026
Merged
DavidJFelix pushed a commit to DavidJFelix/alchemy-effect that referenced this pull request Aug 7, 2026
@sam-goodwin
docs(website): overhaul docs and information hierarchy (alchemy-run#721)
6e6f5c7
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

deploy-website Deploy the website preview for this PR

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@sam-goodwin