Skip to content

fix: don't emit the dev bootstrap into builds with a non-standard NODE_ENV#16023

Merged
teemingc merged 6 commits into
sveltejs:mainfrom
Nic-Polumeyv:fix-nonstandard-node-env-dev-bootstrap
Jun 12, 2026
Merged

fix: don't emit the dev bootstrap into builds with a non-standard NODE_ENV#16023
teemingc merged 6 commits into
sveltejs:mainfrom
Nic-Polumeyv:fix-nonstandard-node-env-dev-bootstrap

Conversation

@Nic-Polumeyv

@Nic-Polumeyv Nic-Polumeyv commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Since 2.63.1 (#15971), the init script's eager import('/@vite/client') was gated on DEV from esm-env, which folds on NODE_ENV — so NODE_ENV=staging vite build shipped the dev bootstrap in production output (#16008). Sorry for the regression (awkward emoji face + that one emoji with a sweat drop) #15971.

As @Rich-Harris suggested in #16008, this goes back to the import.meta.hot trick, but in the generated client app.js instead of per kit module. All user client code is imported through app.js, so Vite injecting its client as that module's first dependency guarantees the define globals exist before hooks.client.js (or anything else) evaluates — static import order, with no possibility of the race the eager import() left open. This also keeps #13249 fixed. The start graph already has the same guarantee via the preamble in client.js.

render.js now emits no dev-only code at all. The remaining esm-env DEV gates in the runtime still fold with a non-standard NODE_ENV.

Fixes #16008


Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

  • It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
  • This message body should clearly illustrate what problems it solves.
  • Ideally, include a test that fails without this PR but passes with it.

Tests

  • Run the tests with pnpm test and lint the project with pnpm lint and pnpm check

Changesets

  • If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

Edits

  • Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed.

@changeset-bot

changeset-bot Bot commented Jun 12, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 68677b9

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

This PR includes changesets to release 1 package
Name Type
@sveltejs/kit Patch

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

@Nic-Polumeyv

Nic-Polumeyv commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

One note on approach. The review discussion on #15971 raised that the #15574-style environment handling would be more fool proof than per-module import.meta.hot guards, and longer term that seems right. This PR takes the smaller route for 2.x, with the guard in the generated app.js as one choke point rather than scattered per module.

Comment thread .changeset/fix-dev-bootstrap-node-env.md Outdated
"test": "pnpm test:dev && pnpm test:build",
"test:dev": "DEV=true playwright test",
"test:build": "playwright test && REGISTER_SERVICE_WORKER=true playwright test"
"test:build": "NODE_ENV=custom playwright test && REGISTER_SERVICE_WORKER=true playwright test"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This helps catch the reported issue after build

@teemingc teemingc left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! You're alright. The regression was my fault.

@teemingc teemingc merged commit 7e4cade into sveltejs:main Jun 12, 2026
25 of 26 checks passed
This was referenced Jun 12, 2026
teemingc pushed a commit that referenced this pull request Jun 14, 2026
This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.


# Releases
## @sveltejs/kit@2.65.1

### Patch Changes


- fix: avoid importing the Vite development client code into builds with
a non-standard `NODE_ENV`
([#16023](#16023))


- fix: don't emit the unused bundle and stylesheet files when using
`bundleStrategy: 'inline'`
([#16025](#16025))


- fix: reset queries before navigating when `invalidateAll` is set
([#16014](#16014))


- fix: regression in loading assets for absolute path apps
([#16026](#16026))

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Building with a non-standard NODE_ENV emits the dev bootstrap (import('/@vite/client'), CSS as module imports) since 2.63.1

2 participants