#17175 7a7d879 Thanks @astrobot-houston! - Fixes astro dev OOM crashes for @astrojs/cloudflare users on Vite 8 by migrating the frontmatter scan plugin to Rolldown-compatible options.
#17187 0db4b57 Thanks @matthewp! - Fixes React invalid hook warning during cold SSR optimizer reload when using ClientRouter
Updated dependencies []:
#16335 9a53f77 Thanks @ascorbic! - Adds an opt-in CDN cache provider for Astro route caching on Cloudflare Workers
[!WARNING] This provider requires the Cloudflare Workers Cache feature, which is currently in private beta. It is opt-in: nothing changes unless you import
cacheCloudflare()and set it as your provider. But without beta access it does not work and should not be used. Cloudflare Workers run in front of the cache, so cached responses are never served, and callingcache.invalidate()throws an error.
Import cacheCloudflare() from @astrojs/cloudflare/cache and set it as your cache provider:
import { defineConfig } from 'astro/config';import cloudflare from '@astrojs/cloudflare';import { cacheCloudflare } from '@astrojs/cloudflare/cache';
export default defineConfig({ adapter: cloudflare(), cache: { provider: cacheCloudflare(), },});The adapter automatically enables the Worker caching layer when a Cloudflare cache provider is configured. No manual wrangler.jsonc changes are needed.
Use Astro.cache.set() in your pages and API routes to cache responses. The provider sets Cloudflare-CDN-Cache-Control and Cache-Tag headers, which are read by Cloudflare’s built-in caching layer. Cache hits bypass Worker execution entirely, meaning your Worker is not invoked for cached responses.
---Astro.cache.set({ maxAge: 300, tags: ['products'] });const data = await fetchProducts();---
<ProductList items={data} />You can also set cache rules for groups of routes in your config:
cache: { provider: cacheCloudflare() },routeRules: { '/products/[...slug]': { maxAge: 3600, tags: ['products'] }, '/api/[...path]': { maxAge: 60, swr: 600 },},Purge cached responses by tag or path from any API route or server endpoint:
export async function POST({ request, cache }) { await cache.invalidate({ tags: ['products'] }); return new Response('Purged');}
// Path-based invalidation (implemented via an auto-generated path tag)await cache.invalidate({ path: '/products/123' });Both tag-based and path-based invalidation are supported.
#16961 96398e8 Thanks @adamchal! - Speeds up astro sync by no longer starting the Cloudflare runtime during type generation
#16671 fd926fd Thanks @alexanderniebuhr! - Removes deprecations warnings added in Astro v6 for Cloudflare specific Astro.locals properties.
#17027 241250b Thanks @ocavue! - Triggers beta prereleases for packages that are still on alpha
Updated dependencies []:
#16571 d4b0cd1 Thanks @MA2153! - Sets immutable cache headers for static assets
Static assets under _astro can be cached to improve performance. The adapter now automatically injects a Cache-Control header at build time when possible.
#16968 7a5c001 Thanks @astrobot-houston! - Fixes a build crash when using experimental.advancedRouting with a custom fetchFile that statically imports cf from @astrojs/cloudflare/fetch. The circular dependency between @astrojs/cloudflare/fetch and astro/app/entrypoint caused createApp or createGetEnv to be undefined at module evaluation time. Initialization is now deferred to the first cf() call, breaking the cycle.
Updated dependencies []:
#16990 ebeb830 Thanks @ocavue! - Fixes a build crash when using experimental.advancedRouting with a custom fetchFile that statically imports cf from @astrojs/cloudflare/fetch. The circular dependency between @astrojs/cloudflare/fetch and astro/app/entrypoint caused createApp or createGetEnv to be undefined at module evaluation time. Initialization is now deferred to the first cf() call, breaking the cycle.
#16671 fd926fd Thanks @alexanderniebuhr! - Removes deprecations warnings added in Astro v6 for Cloudflare specific Astro.locals properties.
Updated dependencies [1f07343, 1e000e2, c63e7e4, ebeb830, 10229f7]:
#16914 4bdd240 Thanks @matthewp! - Fixes astro/fetch and astro/hono being discovered at runtime during dev instead of pre-bundled
#16693 9e6edc2 Thanks @ArmandPhilippot! - Fixes a link in the documentation specifying where to open an issue for the adapter.
Updated dependencies []:
#16729 01aa164 Thanks @matthewp! - Adds @astrojs/cloudflare/fetch and @astrojs/cloudflare/hono exports for composing Cloudflare-specific setup with Astro’s advanced routing handlers.
@astrojs/cloudflare/fetchFor use with astro/fetch in a custom fetch handler:
import { astro, FetchState } from 'astro/fetch';import { cf } from '@astrojs/cloudflare/fetch';
export default { async fetch(request: Request, env: Env, ctx: ExecutionContext) { const state = new FetchState(request); const asset = await cf(state, env, ctx); if (asset) return asset; return astro(state); },};@astrojs/cloudflare/honoFor use with astro/hono as Hono middleware:
import { Hono } from 'hono';import { actions, middleware, pages, i18n } from 'astro/hono';import { cf } from '@astrojs/cloudflare/hono';
const app = new Hono<{ Bindings: Env }>();
app.use(cf());app.use(actions());app.use(middleware());app.use(pages());app.use(i18n());
export default app;Both handlers configure SESSION KV bindings, static asset serving via the ASSETS binding, locals.cfContext, client address, waitUntil, and prerendered error page fetch.
#16868 f9bae95 Thanks @helio-cf! - Fixes user options passed to cloudflare({...}) (remoteBindings, inspectorPort, persistState, configPath, auxiliaryWorkers) being silently ignored during astro preview. The adapter now resolves the full @cloudflare/vite-plugin config once at integration setup time and reuses that single resolved value across the dev/build plugin, the prerenderer’s preview server, and the astro preview entrypoint, so user options can no longer be dropped at one of the call sites.
#16468 4cff3a1 Thanks @matthewp! - Fixes static Cloudflare builds with server islands or image endpoints that failed at preview time due to mismatched output directories.
Updated dependencies [f732f3c]:
#16607 98297af Thanks @alexanderflodin! - Fixes incorrect assets.directory in the generated wrangler.json when a base path is configured
Updated dependencies []:
#16769 428cb1b Thanks @astrobot-houston! - Forwards user-provided optimizeDeps settings (exclude, include, esbuildOptions.loader) to SSR/prerender environments. Previously, top-level vite.optimizeDeps in the Astro config was silently ignored for server environments because Vite 6 scopes it to client-only and the adapter’s configEnvironment hook did not forward it. This caused packages with non-standard file types (e.g. .data files) to fail during dev-mode dependency optimization with errors like “No loader is configured for ‘.data’ files”.
Updated dependencies []:
#16801 d619277 Thanks @ematipico! - Reverts a change to the esbuild dep-scan plugin that caused astro check and astro build to fail by making esbuild incorrectly bundle virtual: modules (e.g. from expressive-code)
Updated dependencies []:
#16708 bb709ff Thanks @fkatsuhiro! - Fixed a bug where a cascade of reloads would cause the page to crash during the first visit when building or developing with Cloudflare SSR in Astro v6 due to dependency loading issues.
Updated dependencies []:
#16707 2ff3f8f Thanks @helio-cf! - Fixes remoteBindings: false being ignored during astro build. The Cloudflare prerenderer’s internal Vite preview server now receives the user’s adapter options, so remote-flagged bindings (e.g. a D1 database with remote: true in wrangler.toml) are emulated locally during build, matching the existing astro dev behavior.
#16652 98c32cc Thanks @greatjourney589! - Fixes user-declared KV namespace bindings being duplicated in the generated dist/server/wrangler.json, which caused wrangler validation to fail with “SESSION binding and lets @cloudflare/vite-plugin merge it with the user’s wrangler config, instead of pre-merging the user’s bindings into the output.
#16272 4f9521e Thanks @barry3406! - Fixes .astro files failing with No matching export in "html:..." for import "default" when default-imported from a .ts file
#15723 9256345 Thanks @rururux! - Fixes an issue where the <Prism /> component failed to work in Cloudflare Workers.
Updated dependencies [d365c97]:
4d72482 Thanks @ematipico! - The adapter now depends on Astro 6.3.0.#16519 1b1c218 Thanks @louisescher! - Adds support for redirecting URLs in remote image optimization.
Previously, when a remote image URL meant to be optimized by Astro led to a redirect, Astro would fail silently and ignore the redirect. Now, Astro tracks up to 10 redirects for these images. If any of the redirects are not covered by a pattern in image.remotePatterns or a domain in image.domains, Astro will fail with a helpful error message.
In the following example, the first image would be loaded successfully, while the second would lead to Astro throwing an error:
export default defineConfig({ image: { domains: ['example.com', 'cdn.example.com'], },});{ /* Redirects to https://cdn.example.com/assets/image.png: */}<Image src="https://example.com/assets/image.png" width="1920" height="1080" alt="An example image."/>;
{ /* Redirects to https://malicious.com/image.png: */}<Image src="https://example.com/bad-image.png" width="1920" height="1080" alt="An example image."/>;In cases where all redirects to HTTPS hosts should be trusted, the following configuration for image.remotePatterns can be used:
export default defineConfig({ image: { remotePatterns: [ { protocol: 'https', }, ], },});#16552 409f6ef Thanks @web-dev0521! - Fixes an issue where existing KV namespace bindings were silently removed when session support was enabled.
#16277 7666bcd Thanks @Calvin-LL! - Fix static assets and prerendered pages 404ing when base is configured.
Updated dependencies []:
#16187 fe58071 Thanks @gllmt! - Adds a waitUntil option to the RenderOptions so that adapters can forward runtime background-task hooks to Astro.
When provided by an adapter, runtime cache providers receive context.waitUntil in
CacheProvider.onRequest(), which allows background cache work such as stale-while-revalidate
without blocking the response. The Cloudflare adapter now forwards
ExecutionContext.waitUntil to this API.
#16290 a49637a Thanks @ViVaLaDaniel! - Ensures that server.allowedHosts (and vite.preview.allowedHosts) configuration is respected when using astro preview with the @astrojs/cloudflare adapter. This improves security by preventing DNS rebinding attacks when previewing Cloudflare builds locally.
#16498 4efe020 Thanks @matthewp! - Fixes the dependency scan failing with “No matching export for import ‘default’” when a .ts file default-imports an .astro component
The esbuild scan plugin now includes export default {} in its output for .astro files, preventing the scan from failing and ensuring all dependencies are discovered ahead of time.
Updated dependencies []: