Environment API #14306

ematipico · 2025-09-03T08:09:34Z

Changes

Refactor of core Astro to use the Vite environments API, primarily to enable dev mode in runtimes like workerd.

Testing

Many tests updated

Docs

Changesets
Upgrade docs: docs: document Environment API breaking changes docs#12809

changeset-bot · 2025-09-03T08:09:39Z

🦋 Changeset detected

Latest commit: 98144fb

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

codspeed-hq · 2025-09-03T08:30:25Z

CodSpeed Performance Report

Merging #14306 will not alter performance

_{Comparing feat/environment-api (28b2f42) with main (f59581f)¹}

Summary

✅ 6 untouched

No successful run was found on next (16bb9f0) during the generation of this report, so main (f59581f) was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

* refactor: use environments to load modules (#14191) * refactor: make `App` more extensible using `BaseApp` (#14197) * refactor: App to extends the new BaseApp (#14213) * refactor: manifest as virtual module (#14298) * refactor: create `generate` when needed * fix type * remove type * fix types * fix breakage of code

* Use separate env to load content config * Format

* feat(cloudflare): add Vite plugin * Skip request handling when running in cloudflare * Skip lots of plugins in non-runnable envs * Use serialized-manifest * Use separate env to load content config * Format * fix rebase * fix type * Remove overrides * Remove trace --------- Co-authored-by: Emanuele Stoppa <[email protected]>

…14345) * refactor: dev app without settings and loader * address comments * chore: refactor to use proper dev pipeline * revert changes * chore: update lockfile * conditionally propagate metadata * revert exports

* Add support for content layer in env API * Lint * Format

* Support CF Images binding * Add support for content layer in env API * Lint * Format * Use image binding in dev --------- Co-authored-by: Samuel Macleod <[email protected]> Co-authored-by: Alexander Niebuhr <[email protected]>

This gets framework components to render in workerd. SSR and client both work.

…t being processed by Vite (#14939)

* Fix astro:env tests in Cloudflare This fixes astro:env tests and brings back .dev.vars support * fix wrangler * log parse errors of .dev.vars

matthewp · 2025-12-01T15:28:16Z

@sarah11918 The changesets in this PR are ready to review, along with the upgrade guide docs which are here: withastro/docs#12809

Thanks!

sarah11918

Reviews for astro major changesets, before GitHub dies on me!

Note: we decided that changelog entries for breaking changes would be minimal and link to the upgrade guide for all explanation of changes. So if there is anything contained here that you think needs to be said, it needs to find its way into the upgrade guide!

.changeset/encoding-static-builds.md

.changeset/route-data-breaking.md

.changeset/ssr-manifest-breaking.md

.changeset/vite-environments-breaking.md

sarah11918

Rest of the changesets reviewed with suggestions! 🙌

(Mostly, the integrations and adapters dont get their own upgrade guides, so we DO rely on changelogs for them. So, these are still hefty entries, and for majors with breaking change, we'll add a #### What should I do? section to make sure it's clear that there is something they might have to do.

.changeset/adapter-interface-breaking.md

.changeset/cloudflare-entrypoint-breaking.md

sarah11918 · 2025-12-01T20:25:50Z

.changeset/cloudflare-entrypoint-breaking.md

+
+The `createExports()` function has been replaced with a direct export pattern. If you're using a custom `entryPoint` in your Cloudflare adapter config, update your worker file from:
+
+```ts


For clarity, can you add a title to this file (and the following)?

.changeset/cloudflare-entrypoint-breaking.md

sarah11918 · 2025-12-01T20:29:28Z

.changeset/flat-lions-care.md

+'@astrojs/cloudflare': minor
+---
+
+Adds support for `astro preview` command


This one looks great!

.changeset/open-monkeys-boil.md

sarah11918 · 2025-12-01T20:43:13Z

.changeset/cloudflare-entrypoint-breaking.md

+
+to:
+
+```ts


Same file title here as the previous example

.changeset/open-monkeys-boil.md

.changeset/wet-lines-wear.md

Co-authored-by: Sarah Rainsberger <[email protected]>

…o feat/environment-api

sarah11918

Approving for changesets! If there happen to be any new error messages associated with this, let me know (I didn't immediately see any).

Otherwise, we're pretty close to getting the docs PR squared away and just letting you know that doesn't have to hold up this PR if it's helpful to get it off your plate!

The main thing we want to ensure is that any changesets here merge with correct links to the upgrade guide. Since we've already worked out those what those will be, we know the links for adding here, and that's good enough for me.

(The docs PR is close, just updating other pages in docs to match the changes, and doesn't need to merge before/with this PR since no one is actually relying on them for anything yet.)

.changeset/route-data-breaking.md

Co-authored-by: Sarah Rainsberger <[email protected]>

Co-authored-by: matthewp <[email protected]>

sarah11918 · 2025-12-04T12:30:18Z

Also noting that the Docs PR is now approved by me and by Armand! Anyone is welcome to give it a final look over for anything you spot last minute!

Ready to be merged. Fully approved!

ematipico added 4 commits September 3, 2025 09:10

refactor: use environments to load modules (#14191)

cb3f394

refactor: make App more extensible using BaseApp (#14197)

c6a8ac8

refactor: App to extends the new BaseApp (#14213)

c970fc4

refactor: manifest as virtual module (#14298)

a9b4871

github-actions bot added the pkg: astro Related to the core `astro` package (scope) label Sep 3, 2025

ematipico added 2 commits September 3, 2025 09:17

chore: resolve merging conflicts

5df82a0

chore: resolve merging conflicts

c701fe4

ematipico force-pushed the feat/environment-api branch from 15a3eab to c701fe4 Compare September 3, 2025 08:17

github-actions bot added the docs pr label Sep 3, 2025

ematipico and others added 8 commits September 8, 2025 10:23

refactor: routes as virtual module (#14313)

9ed7a3c

Merge branch 'main' into feat/environment-api

ed90bcb

Lock

2b17868

Use separate env to load content config (#14324)

5c41688

* Use separate env to load content config * Format

fix: creation of routes list in build (#14325)

4a80ecf

refactor(dev): use entry point to bootstrap the app (#14333)

43b3ed5

refactor(dev): expose dev app and entrypoint (#14337)

de4e76d

github-actions bot added the pkg: integration Related to any renderer integration (scope) label Sep 9, 2025

florian-lefebvre mentioned this pull request Sep 15, 2025

Use Vite's Environment API #14363

Closed

ascorbic and others added 7 commits September 15, 2025 14:34

Add support for content layer in env API (#14357)

1e50d7d

* Add support for content layer in env API * Lint * Format

Use imported Cloudflare handler in env API (#14360)

48197bb

Merge branch 'main' into feat/environment-api

b8ba777

Dedupe

22b9c33

Support framework components (#14382)

77fdf98

This gets framework components to render in workerd. SSR and client both work.

Update vite plugin

56718e0

Princesseuh and others added 2 commits December 1, 2025 15:32

fix(vite): import mergeConfig from direct file to avoid dynamic impor…

f6f3bf8

…t being processed by Vite (#14939)

Fix astro:env tests in Cloudflare (#14925)

922daf0

* Fix astro:env tests in Cloudflare This fixes astro:env tests and brings back .dev.vars support * fix wrangler * log parse errors of .dev.vars

sarah11918 reviewed Dec 1, 2025

View reviewed changes

.changeset/encoding-static-builds.md Outdated Show resolved Hide resolved

.changeset/route-data-breaking.md Outdated Show resolved Hide resolved

.changeset/ssr-manifest-breaking.md Outdated Show resolved Hide resolved

.changeset/vite-environments-breaking.md Outdated Show resolved Hide resolved

sarah11918 reviewed Dec 1, 2025

View reviewed changes

matthewp and others added 12 commits December 3, 2025 09:13

Update .changeset/encoding-static-builds.md

2d35ddb

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/route-data-breaking.md

a5eb3db

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/ssr-manifest-breaking.md

1e75fb0

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/vite-environments-breaking.md

0b0ddfd

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/adapter-interface-breaking.md

ba0db9c

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/cloudflare-entrypoint-breaking.md

58d51c3

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/cloudflare-entrypoint-breaking.md

152e785

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/open-monkeys-boil.md

0228984

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/wet-lines-wear.md

76e803d

Co-authored-by: Sarah Rainsberger <[email protected]>

Update .changeset/open-monkeys-boil.md

592fbeb

Co-authored-by: Sarah Rainsberger <[email protected]>

add titles to code samples

f188ba5

Merge branch 'feat/environment-api' of github.com:withastro/astro int…

76210c6

…o feat/environment-api

sarah11918 approved these changes Dec 3, 2025

View reviewed changes

sarah11918 reviewed Dec 3, 2025

View reviewed changes

.changeset/route-data-breaking.md Outdated Show resolved Hide resolved

matthewp and others added 2 commits December 3, 2025 16:41

Update .changeset/route-data-breaking.md

71d2382

Co-authored-by: Sarah Rainsberger <[email protected]>

refactor: optimise dependencies (#14951)

98144fb

Co-authored-by: matthewp <[email protected]>

github-actions bot added pkg: react Related to React (scope) pkg: preact Related to Preact (scope) pkg: solid Related to Solid (scope) labels Dec 4, 2025

ematipico merged commit 141c4a2 into next Dec 4, 2025
40 of 41 checks passed

ematipico deleted the feat/environment-api branch December 4, 2025 13:38

astrobot-houston mentioned this pull request Dec 3, 2025

[ci] release (alpha) #14757

Merged

ArmandPhilippot mentioned this pull request Dec 15, 2025

[v6]: add docs for entryType in Adapter API withastro/docs#12915

Merged


		The `createExports()` function has been replaced with a direct export pattern. If you're using a custom `entryPoint` in your Cloudflare adapter config, update your worker file from:

		```ts


		to:

		```ts

Uh oh!

Environment API #14306

Environment API #14306

Conversation

ematipico commented Sep 3, 2025 • edited by matthewp Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Testing

Docs

Uh oh!

changeset-bot bot commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

codspeed-hq bot commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodSpeed Performance Report

Merging #14306 will not alter performance

Summary

Footnotes

Uh oh!

matthewp commented Dec 1, 2025

Uh oh!

sarah11918 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sarah11918 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sarah11918 Dec 1, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sarah11918 Dec 1, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sarah11918 Dec 1, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sarah11918 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sarah11918 commented Dec 4, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

ematipico commented Sep 3, 2025 •

edited by matthewp

Loading

changeset-bot bot commented Sep 3, 2025 •

edited

Loading

codspeed-hq bot commented Sep 3, 2025 •

edited

Loading