t3-code-android-nightly/.repos/alchemy-effect/packages/frontend-frameworks/fixtures/astro

@fixtures/astro

E2e fixture for @alchemy.run/frontend-frameworks/astro — a wrangler-free Astro app on Cloudflare Workers, driven through the e2e harness's Framework service (no wrangler.json). The project's own astro.config.mjs loads natively; the toolchain's config is an inline overlay astro merges over it.

e2e.config.ts uses the target-scoped config carriage (target.cloudflare) and passes the Cloudflare deploy target as a typed value (cloudflare({ worker }) from @alchemy.run/frontend-frameworks/astro/cloudflare) to Astro.make.

The app exercises:

• a real user astro.config.mjs honored natively: a user integration injects the on-demand /user-integration route, and a user vite.define setting is rendered into its HTML — both asserted e2e in dev and live
• an on-demand SSR page (/) reading a Text.local binding via cloudflare:workers, with a client-interactive counter script
• middleware (src/middleware.ts): writes Astro.locals (rendered by /locals) and mutates response headers (x-middleware) on on-demand routes
• a redirects config entry (/old-about → /about/): emitted into the generated _redirects file at build time (served by the asset layer ahead of the worker in live mode) and handled dynamically by the worker in dev (the integration sets build: { redirects: false })
• zero-config sessions (/session): no session driver configured anywhere — the integration defaults to the Cloudflare KV driver (binding SESSION), auto-injects an in-memory local KV namespace in dev, and the live preview supplies a miniflare KV namespace (preview.kvNamespaces)
• the generated _headers file: immutable Cache-Control on the hashed /_astro/* assets, asserted end-to-end in live mode
• a prerendered page (/about/) served from assets in production and by Astro's node prerender middleware in dev
• a content-collection-driven static page (/posts/hello-world/): glob loader over src/posts/*.md, getStaticPaths + render from astro:content, prerendered at build time
• API routes returning JSON (/api/hello, reads the binding + asserts the ASSETS binding exists) and binary data (/api/binary, application/octet-stream)
• a public/ static asset (/robots.txt)
• the 404 fallback path through env.ASSETS.fetch

Known limitations (see the package README for details): prerendering runs in node, not workerd, so prerendered pages must not import cloudflare:workers at render time; the image service is passthrough (no sharp in workerd); middleware header mutations are only observable on on-demand routes (prerendered pages are static files in production).

Commands

bun run dev       # astro dev with the ssr environment in workerd (port 3102)
bun run build     # astro build -> dist/ + dist/build.json
bun run preview   # miniflare over dist/build.json
bun run test      # playwright: live (miniflare) + dev projects