withastro · ematipico · Feb 4, 2026 · Jan 16, 2026 · Jan 20, 2026 · Jan 27, 2026
diff --git a/.changeset/full-crews-juggle.md b/.changeset/full-crews-juggle.md
@@ -0,0 +1,17 @@
+---
+'@astrojs/netlify': minor
+'@astrojs/vercel': minor
+'@astrojs/node': minor
+'astro': minor
+---
+
+Stabilizes the adapter feature `experimentalStatiHeaders`. If you were using this  feature in any of the supported adapters, you'll need to change the name of the flag:
+
+```diff
+export default defineConfig({
+  adapter: netlify({
+-    experimentalStaticHeaders: true
++    staticHeaders: true
+  })
+})
+```
diff --git a/examples/minimal/src/pages/index.astro b/examples/minimal/src/pages/index.astro
@@ -1,5 +1,4 @@
 ---
-
 ---
 
 <html lang="en">

diff --git a/packages/astro/src/core/app/dev/app.ts b/packages/astro/src/core/app/dev/app.ts
@@ -10,12 +10,8 @@ import { getCustom404Route, getCustom500Route } from '../../routing/helpers.js';
 import { matchRoute } from '../../routing/dev.js';
 import type { RunnablePipeline } from '../../../vite-plugin-app/pipeline.js';
 
-/**
- *
- */
 export class DevApp extends BaseApp<NonRunnablePipeline> {
 	logger: Logger;
-	currentRenderContext: RenderContext | undefined = undefined;
 	resolvedPathname: string | undefined = undefined;
 	constructor(manifest: SSRManifest, streaming = true, logger: Logger) {
 		super(manifest, streaming, logger);

diff --git a/packages/astro/src/core/build/app.ts b/packages/astro/src/core/build/app.ts
@@ -3,6 +3,7 @@ import type { SSRManifest } from '../app/types.js';
 import type { BuildInternals } from './internal.js';
 import { BuildPipeline } from './pipeline.js';
 import type { StaticBuildOptions } from './types.js';
+import type { CreateRenderContext, RenderContext } from '../render-context.js';
 
 export class BuildApp extends BaseApp<BuildPipeline> {
 	createPipeline(_streaming: boolean, manifest: SSRManifest, ..._args: any[]): BuildPipeline {
@@ -11,6 +12,12 @@ export class BuildApp extends BaseApp<BuildPipeline> {
 		});
 	}
 
+	async createRenderContext(payload: CreateRenderContext): Promise<RenderContext> {
+		return await super.createRenderContext({
+			...payload,
+		});
+	}
+
 	isDev(): boolean {
 		return true;
 	}

diff --git a/packages/astro/src/core/build/generate.ts b/packages/astro/src/core/build/generate.ts
@@ -189,7 +189,7 @@ export async function generatePages(
 	await runHookBuildGenerated({
 		settings: options.settings,
 		logger,
-		experimentalRouteToHeaders: routeToHeaders,
+		routeToHeaders,
 	});
 }
 
@@ -610,10 +610,7 @@ async function generatePath(
 		route.distURL = [outFile];
 	}
 
-	if (
-		settings.adapter?.adapterFeatures?.experimentalStaticHeaders &&
-		settings.config.security?.csp
-	) {
+	if (settings.adapter?.adapterFeatures?.staticHeaders) {
 		routeToHeaders.set(pathname, { headers: responseHeaders, route: integrationRoute });
 	}
 

diff --git a/packages/astro/src/core/build/plugins/plugin-manifest.ts b/packages/astro/src/core/build/plugins/plugin-manifest.ts
@@ -280,9 +280,7 @@ async function buildManifest(
 		];
 
 		csp = {
-			cspDestination: settings.adapter?.adapterFeatures?.experimentalStaticHeaders
-				? 'adapter'
-				: undefined,
+			cspDestination: settings.adapter?.adapterFeatures?.staticHeaders ? 'adapter' : undefined,
 			scriptHashes,
 			scriptResources: getScriptResources(settings.config.security.csp),
 			styleHashes,

diff --git a/packages/astro/src/integrations/hooks.ts b/packages/astro/src/integrations/hooks.ts
@@ -575,11 +575,11 @@ export async function runHookBuildSsr({
 export async function runHookBuildGenerated({
 	settings,
 	logger,
-	experimentalRouteToHeaders,
+	routeToHeaders,
 }: {
 	settings: AstroSettings;
 	logger: Logger;
-	experimentalRouteToHeaders: RouteToHeaders;
+	routeToHeaders: RouteToHeaders;
 }) {
 	const dir =
 		settings.buildOutput === 'server' ? settings.config.build.client : settings.config.outDir;
@@ -589,7 +589,7 @@ export async function runHookBuildGenerated({
 			integration,
 			hookName: 'astro:build:generated',
 			logger,
-			params: () => ({ dir, experimentalRouteToHeaders }),
+			params: () => ({ dir, routeToHeaders }),
 		});
 	}
 }

diff --git a/packages/astro/src/manifest/serialized.ts b/packages/astro/src/manifest/serialized.ts
@@ -128,9 +128,7 @@ async function createSerializedManifest(settings: AstroSettings): Promise<Serial
 
 	if (shouldTrackCspHashes(settings.config.security.csp)) {
 		csp = {
-			cspDestination: settings.adapter?.adapterFeatures?.experimentalStaticHeaders
-				? 'adapter'
-				: undefined,
+			cspDestination: settings.adapter?.adapterFeatures?.staticHeaders ? 'adapter' : undefined,
 			scriptHashes: getScriptHashes(settings.config.security.csp),
 			scriptResources: getScriptResources(settings.config.security.csp),
 			styleHashes: getStyleHashes(settings.config.security.csp),

diff --git a/packages/astro/src/runtime/server/render/page.ts b/packages/astro/src/runtime/server/render/page.ts
@@ -42,6 +42,7 @@ export async function renderPage(
 		) {
 			headers.set('content-security-policy', renderCspContent(result));
 		}
+
 		return new Response(bytes, {
 			headers,
 			status: result.response.status,
@@ -88,6 +89,7 @@ export async function renderPage(
 	) {
 		headers.set('content-security-policy', renderCspContent(result));
 	}
+
 	// For non-streaming, convert string to byte array to calculate Content-Length
 	if (!streaming && typeof body === 'string') {
 		body = encoder.encode(body);

diff --git a/packages/astro/src/types/public/integrations.ts b/packages/astro/src/types/public/integrations.ts
@@ -96,10 +96,9 @@ export interface AstroAdapterFeatures {
 	 * `astro:build:generated` hook, so adapters can consume them and add them inside
 	 * their hosting headers configuration file.
 	 *
-	 * NOTE: the semantics and list of headers might change until the feature
-	 * is out of experimental
+	 * Future features may decide to use this feature to create/add headers for static pages.
 	 */
-	experimentalStaticHeaders?: boolean;
+	staticHeaders?: boolean;
 }
 
 /**
@@ -257,7 +256,7 @@ export interface BaseIntegrationHooks {
 	'astro:build:generated': (options: {
 		dir: URL;
 		logger: AstroIntegrationLogger;
-		experimentalRouteToHeaders: RouteToHeaders;
+		routeToHeaders: RouteToHeaders;
 	}) => void | Promise<void>;
 	'astro:build:done': (options: {
 		pages: { pathname: string }[];

diff --git a/packages/astro/src/vite-plugin-app/app.ts b/packages/astro/src/vite-plugin-app/app.ts
@@ -87,16 +87,19 @@
 		manifestData: RoutesList,
 		getDebugInfo: () => Promise<string>,
 	): RunnablePipeline {
-		return RunnablePipeline.create(manifestData, {
+		const pipeline = RunnablePipeline.create(manifestData, {
 			loader,
 			logger,
 			manifest,
 			settings,
 			getDebugInfo,
 		});
+
+		return pipeline;
 	}
 
 	async createRenderContext(payload: CreateRenderContext): Promise<RenderContext> {
+		console.log(this.manifest.csp);
 		this.currentRenderContext = await super.createRenderContext({
 			...payload,
 			pathname: this.resolvedPathname ?? payload.pathname,
@@ -234,7 +237,7 @@
 					routeData,
 					clientAddress,
 					status,
-					shouldInjectCspMetaTags: false,
+					shouldInjectCspMetaTags: !!this.manifest.csp,
 				});
 				renderContext.props.error = error;
 				const response = await renderContext.render(preloadedComponent);

diff --git a/packages/astro/src/vite-plugin-app/pipeline.ts b/packages/astro/src/vite-plugin-app/pipeline.ts
@@ -11,8 +11,12 @@ import { createDefaultRoutes } from '../core/routing/default.js';
 import { routeIsRedirect } from '../core/routing/index.js';
 import { findRouteToRewrite } from '../core/routing/rewrite.js';
 import { isPage } from '../core/util.js';
-import { resolveIdToUrl } from '../core/viteUtils.js';
-import type { AstroSettings, ComponentInstance, RoutesList } from '../types/astro.js';
+import type {
+	AstroSettings,
+	ComponentInstance,
+	ImportedDevStyle,
+	RoutesList,
+} from '../types/astro.js';
 import type {
 	DevToolbarMetadata,
 	RewritePayload,
@@ -24,7 +28,6 @@ import type {
 import { getComponentMetadata } from '../vite-plugin-astro-server/metadata.js';
 import { createResolve } from '../vite-plugin-astro-server/resolve.js';
 import { PAGE_SCRIPT_ID } from '../vite-plugin-scripts/index.js';
-import { getDevCSSModuleName } from '../vite-plugin-css/util.js';
 
 /**
  * This Pipeline is used when the Vite SSR environment is runnable.
@@ -69,7 +72,7 @@ export class RunnablePipeline extends Pipeline {
 	}
 
 	async headElements(routeData: RouteData): Promise<HeadElements> {
-		const { manifest, loader, runtimeMode, settings } = this;
+		const { manifest, runtimeMode, settings } = this;
 		const filePath = new URL(`${routeData.component}`, manifest.rootDir);
 		const scripts = new Set<SSRElement>();
 
@@ -81,15 +84,14 @@ export class RunnablePipeline extends Pipeline {
 					children: '',
 				});
 
-				if (
-					settings.config.devToolbar.enabled &&
-					(await settings.preferences.get('devToolbar.enabled'))
-				) {
-					const src = await resolveIdToUrl(
-						loader,
-						'astro/runtime/client/dev-toolbar/entrypoint.js',
-					);
-					scripts.add({ props: { type: 'module', src }, children: '' });
+				if (this.manifest.devToolbar.enabled) {
+					scripts.add({
+						props: {
+							type: 'module',
+							src: '/@id/astro/runtime/client/dev-toolbar/entrypoint.js',
+						},
+						children: '',
+					});
 
 					const additionalMetadata: DevToolbarMetadata['__astro_dev_toolbar__'] = {
 						root: fileURLToPath(settings.config.root),
@@ -124,7 +126,19 @@ export class RunnablePipeline extends Pipeline {
 			}
 		}
 
-		const { css } = await loader.import(getDevCSSModuleName(routeData.component));
+		const { devCSSMap } = await import('virtual:astro:dev-css-all');
+
+		const importer = devCSSMap.get(routeData.component);
+		let css = new Set<ImportedDevStyle>();
+		if (importer) {
+			const cssModule = await importer();
+			css = cssModule.css;
+		} else {
+			this.logger.warn(
+				'assets',
+				`Unable to find CSS for ${routeData.component}. This is likely a bug in Astro.`,
+			);
+		}
 
 		// Pass framework CSS in as style tags to be appended to the page.
 		const links = new Set<SSRElement>();

diff --git a/packages/astro/src/vite-plugin-astro-server/plugin.ts b/packages/astro/src/vite-plugin-astro-server/plugin.ts
@@ -150,9 +150,7 @@ export async function createDevelopmentManifest(settings: AstroSettings): Promis
 		];
 
 		csp = {
-			cspDestination: settings.adapter?.adapterFeatures?.experimentalStaticHeaders
-				? 'adapter'
-				: undefined,
+			cspDestination: settings.adapter?.adapterFeatures?.staticHeaders ? 'adapter' : undefined,
 			scriptHashes: getScriptHashes(settings.config.security.csp),
 			scriptResources: getScriptResources(settings.config.security.csp),
 			styleHashes,

diff --git a/packages/astro/test/test-adapter.js b/packages/astro/test/test-adapter.js
@@ -130,7 +130,7 @@ export default function ({
 					},
 					adapterFeatures: {
 						buildOutput: 'server',
-						experimentalStaticHeaders: staticHeaders,
+						staticHeaders: staticHeaders,
 					},
 					...extendAdapter,
 				});
@@ -143,9 +143,9 @@ export default function ({
 					setManifest(manifest);
 				}
 			},
-			'astro:build:generated': ({ experimentalRouteToHeaders }) => {
+			'astro:build:generated': ({ routeToHeaders }) => {
 				if (setRouteToHeaders) {
-					setRouteToHeaders(experimentalRouteToHeaders);
+					setRouteToHeaders(routeToHeaders);
 				}
 			},
 		},
@@ -270,7 +270,7 @@ export function selfTestAdapter({
 					},
 					adapterFeatures: {
 						buildOutput: 'server',
-						experimentalStaticHeaders: staticHeaders,
+						staticHeaders: staticHeaders,
 					},
 					...extendAdapter,
 				});

diff --git a/packages/integrations/netlify/src/index.ts b/packages/integrations/netlify/src/index.ts
@@ -263,7 +263,7 @@ export interface NetlifyIntegrationConfig {
 	 * Here the list of the headers that are added:
 	 * - The CSP header of the static pages is added when CSP support is enabled.
 	 */
-	experimentalStaticHeaders?: boolean;
+	staticHeaders?: boolean;
 
 	/**
 	 * Netlify features to enable when running `astro dev`. These work best when your site is linked to a Netlify site using `netlify link`.
@@ -671,15 +671,15 @@ export default function netlifyIntegration(
 				finalBuildOutput = buildOutput;
 
 				const useEdgeMiddleware = integrationConfig?.edgeMiddleware ?? false;
-				const useStaticHeaders = integrationConfig?.experimentalStaticHeaders ?? false;
+				const useStaticHeaders = integrationConfig?.staticHeaders ?? false;
 
 				setAdapter({
 					name: '@astrojs/netlify',
 					serverEntrypoint: '@astrojs/netlify/ssr-function.js',
 					exports: ['default'],
 					adapterFeatures: {
 						edgeMiddleware: useEdgeMiddleware,
-						experimentalStaticHeaders: useStaticHeaders,
+						staticHeaders: useStaticHeaders,
 					},
 					args: { middlewareSecret } satisfies Args,
 					supportedAstroFeatures: {
@@ -703,8 +703,8 @@ export default function netlifyIntegration(
 					},
 				});
 			},
-			'astro:build:generated': ({ experimentalRouteToHeaders }) => {
-				staticHeadersMap = experimentalRouteToHeaders;
+			'astro:build:generated': ({ routeToHeaders }) => {
+				staticHeadersMap = routeToHeaders;
 			},
 			'astro:build:ssr': async ({ middlewareEntryPoint }) => {
 				astroMiddlewareEntryPoint = middlewareEntryPoint;

diff --git a/packages/integrations/netlify/test/static/fixtures/static-headers/astro.config.mjs b/packages/integrations/netlify/test/static/fixtures/static-headers/astro.config.mjs
@@ -4,7 +4,7 @@ import { defineConfig } from 'astro/config';
 export default defineConfig({
 	output: 'static',
 	adapter: netlify({
-		experimentalStaticHeaders: true
+		staticHeaders: true
 	}),
 	site: "http://example.com",
 	security: {

diff --git a/packages/integrations/node/src/index.ts b/packages/integrations/node/src/index.ts
@@ -22,7 +22,7 @@ export function getAdapter(options: Options): AstroAdapter {
 		adapterFeatures: {
 			buildOutput: 'server',
 			edgeMiddleware: false,
-			experimentalStaticHeaders: options.experimentalStaticHeaders,
+			staticHeaders: options.staticHeaders,
 		},
 		supportedAstroFeatures: {
 			hybridOutput: 'stable',
@@ -92,8 +92,8 @@ export default function createIntegration(userOptions: UserOptions): AstroIntegr
 					},
 				});
 			},
-			'astro:build:generated': ({ experimentalRouteToHeaders }) => {
-				_routeToHeaders = experimentalRouteToHeaders;
+			'astro:build:generated': ({ routeToHeaders }) => {
+				_routeToHeaders = routeToHeaders;
 			},
 			'astro:config:done': ({ setAdapter, config }) => {
 				_options = {
@@ -103,7 +103,7 @@ export default function createIntegration(userOptions: UserOptions): AstroIntegr
 					host: config.server.host,
 					port: config.server.port,
 					assets: config.build.assets,
-					experimentalStaticHeaders: userOptions.experimentalStaticHeaders ?? false,
+					staticHeaders: userOptions.staticHeaders ?? false,
 					experimentalErrorPageHost,
 				};
 				setAdapter(getAdapter(_options));
-Original file line number
+Diff line change
@@ -1,5 +1,4 @@
     ---
     ---
     <html lang="en">
@@ Expand Down @@