Skip to content

feat(builder): enable Rspack native watcher by default - #8813

Open
stormslowly wants to merge 1 commit into
web-infra-dev:mainfrom
stormslowly:feat/rspack-native-watcher-by-default
Open

feat(builder): enable Rspack native watcher by default#8813
stormslowly wants to merge 1 commit into
web-infra-dev:mainfrom
stormslowly:feat/rspack-native-watcher-by-default

Conversation

@stormslowly

Copy link
Copy Markdown

Why

Modern.js watch mode currently falls back to Rspack's default Watchpack-based watcher. Watchpack degrades badly when a large number of files change at once (webpack/watchpack#223), which shows up in dev on big apps. Rspack's Rust native watcher does incremental change detection and avoids that class of problem.

Before / after (experiments in the generated Rspack config):

  "experiments": {
+   "nativeWatcher": true,
    "sourceImport": true,
  }

What

Registers a small Rsbuild plugin in @modern-js/builder that sets experiments.nativeWatcher through modifyRspackConfig.

Two escape hatches, both covered by tests:

// tools.rspack runs after every modifyRspackConfig hook
tools: { rspack: { experiments: { nativeWatcher: false } } }

// tools.bundlerChain runs before it — this is why the plugin uses `??=`, not `=`
tools: { bundlerChain: chain => chain.experiments({ ...chain.get('experiments'), nativeWatcher: false }) }

Notes

NativeWatchFileSystem rejects a function for watchOptions.ignored (string / array / RegExp only). The only place this repo sets it (adapterBasic.ts) uses a string array, so nothing here breaks — but it is a behavior difference worth calling out for anyone passing a function through tools.rspack.

Verification

  • @modern-js/builder unit tests: 46 passed, 0 failed.
  • Probed Rspack directly: nativeWatcher=undefined -> NodeWatchFileSystem, nativeWatcher=true -> NativeWatchFileSystem.
  • Ran modern dev on tests/integration/basic-app, edited src/App.tsx, confirmed the incremental rebuild fires.

Enable `experiments.nativeWatcher` so watch mode uses Rspack's Rust
watcher instead of Watchpack. Applied via `modifyRspackConfig` with `??=`
so both `tools.rspack` and `tools.bundlerChain` can still opt out.
@changeset-bot

changeset-bot Bot commented Aug 17, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 47c847c

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

This PR includes changesets to release 119 packages
Name Type
@modern-js/builder Patch
@modern-js/plugin-bff Patch
@modern-js/server Patch
@modern-js/app-tools Patch
@modern-js/plugin Patch
rsc-ssr-app Patch
bff-api-app Patch
bff-client-app Patch
bff-indep-client-app Patch
bff-hono Patch
deploy-server Patch
pure-esm-project Patch
basic-app-rstest Patch
@modern-js/adapter-rstest Patch
@modern-js/plugin-ssg Patch
@modern-js/plugin-styled-components Patch
@modern-js/plugin-i18n Patch
@modern-js/image Patch
@modern-js/runtime Patch
@modern-js/plugin-polyfill Patch
@integration-test/alias-set Patch
app-document Patch
async-entry-test Patch
tmp Patch
integration-clean-dist-path Patch
integration-compatibility Patch
integration-custom-dist-path Patch
custom-file-system-entry Patch
integration-custom-template Patch
deploy Patch
dev-server Patch
integration-disable-html Patch
entries-app-builder Patch
app-custom-entries Patch
app-custom-routes-runtime Patch
app-custom Patch
app-entry Patch
app-route Patch
app-entry-server Patch
i18n-app-csr-html-lang Patch
i18n-app Patch
i18n-app-ssr-html-lang Patch
i18n-app-ssr Patch
i18n-custom-i18n-wrapper Patch
i18n-mf-app-provider Patch
i18n-mf-component-provider Patch
i18n-mf-consumer Patch
i18n-routes Patch
i18n-routes-ssr Patch
@integration-test/image-component Patch
main-entry-name Patch
nonce Patch
react-compiler-test Patch
routes-match Patch
routes Patch
app-rsbuild-hooks Patch
rsc-csr-app Patch
rsc-csr-routes Patch
rsc-ssr-routes Patch
basic-app-rstest-browser Patch
runtime-custom-plugin Patch
runtime-custom-config-plugin Patch
select-mul-entry-test Patch
select-one-entry-test Patch
server-config Patch
server-esm-tsx Patch
server-json-script Patch
server-monitors Patch
server-prod Patch
server-routes Patch
@source-code-build/app Patch
ssg-fixtures-mega-list-routes Patch
ssg-fixtures-nested-routes Patch
ssg-fixtures-simple Patch
ssg-fixtures-web-server Patch
ssr-base-async-entry-test Patch
ssr-base-async-pre-entry-test Patch
ssr-base-json-test Patch
ssr-base-test Patch
ssr-base-fallback-test Patch
init Patch
ssr-base-loadable Patch
ssr-partial-test Patch
rsc-closing-tags-test Patch
ssr-script-loading Patch
ssr-useid-test Patch
ssr-streaming-inline-test Patch
ssr-streaming-lazy-test Patch
ssr-streaming-test Patch
styled-components-stream Patch
styled-components-string Patch
integration-tailwindcss-v2 Patch
integration-tailwindcss-v3 Patch
integration-tailwindcss-v4-tools Patch
integration-tailwindcss-v4 Patch
tmp-dir Patch
write-to-dist Patch
@modern-js/bundle-diff-benchmark Patch
@modern-js/main-doc Patch
@modern-js/tsconfig Patch
@modern-js/plugin-data-loader Patch
@modern-js/render Patch
@modern-js/bff-core Patch
@modern-js/bff-runtime Patch
@modern-js/server-core Patch
@modern-js/create-request Patch
@modern-js/prod-server Patch
@modern-js/server-runtime Patch
@modern-js/server-utils Patch
@modern-js/create Patch
@modern-js/i18n-utils Patch
@modern-js/runtime-utils Patch
@modern-js/sandpack-react Patch
@modern-js/types Patch
@modern-js/utils Patch
@modern-js/rslib Patch
@scripts/prebundle Patch
@scripts/rstest-config Patch
@scripts/release-node 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

@netlify

netlify Bot commented Aug 17, 2026

Copy link
Copy Markdown

Deploy Preview for modernjs-byted ready!

Name Link
🔨 Latest commit 47c847c
🔍 Latest deploy log https://app.netlify.com/projects/modernjs-byted/deploys/6a82dc5b58fa180008ccf08e
😎 Deploy Preview https://deploy-preview-8813--modernjs-byted.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 96 (🔴 down 3 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

1 participant