fix: file reloading mechanism and add profile watch ignores by ZerGo0 · Pull Request #2112 · wxt-dev/wxt

ZerGo0 · 2026-02-11T12:00:58Z

Overview

Fixes flaky dev reload detection where WXT sometimes ignores real source file saves.

Root cause:

Dev watcher used a debounced callback (leading: true, trailing: false) and queued events inside that callback.
With noisy filesystem activity (especially browser profile/cache files), relevant source change events could be dropped.

Changes:

Reworked dev file reload flow in packages/wxt/src/core/create-server.ts to:
- queue every watcher event immediately
- process the queue in a serialized loop
- keep flushing after each debounce window until no new events arrive
Added runner profile watch ignores in packages/wxt/src/core/builders/vite/index.ts so browser profile churn is not watched:
- chromiumProfile
- firefoxProfile
- chromiumArgs --user-data-dir (split and = forms)
- firefoxArgs -profile (split and = forms)
Added a single regression test:
- packages/wxt/src/core/__tests__/create-server.test.ts
- Simulates browser-profile noise event followed by real source change and verifies the source change is detected/reloaded.

Manual Testing

This is pretty hard/annoying to reproduce. The new test is probably the best way of reproducing this: pnpm -C packages/wxt test --run src/core/__tests__/create-server.test.ts

Use a project with browser profile inside project dir (example):
- Chromium: chromiumArgs: ['--user-data-dir=./private/.dev-profile']
- Firefox: firefoxProfile: './private/.dev-firefox-profile'
- My main project does a ton of stuff in indexed dbs, this causes a ton of changes in the browser profile directory
Run pnpm wxt.
Save a real source file while browser is active.
A rebuild should be triggered, but it just doesn't sometimes.

Related Issue

None I think.

- Exported `createFileReloader` function to allow external usage. - Improved the file reloading process by implementing a queue worker to handle multiple file changes without dropping events. - Added `getRunnerProfileWatchIgnores` function to dynamically generate ignored paths based on user profiles for Chromium and Firefox. - Updated Vite builder configuration to include these new ignore patterns.

netlify · 2026-02-11T12:01:05Z

✅ Deploy Preview for creative-fairy-df92c4 ready!

Name	Link
🔨 Latest commit	`a3c33f6`
🔍 Latest deploy log	https://app.netlify.com/projects/creative-fairy-df92c4/deploys/6a44224058a32b00082f8847
😎 Deploy Preview	https://deploy-preview-2112--creative-fairy-df92c4.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

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

aklinker1

Nice, I really like these changes!

I just woke up and am on mobile, so I'll need to do some manual testing to make sure everything is working later today.

pkg-pr-new · 2026-02-11T14:12:35Z

Open in StackBlitz

@wxt-dev/analytics

npm i https://pkg.pr.new/@wxt-dev/analytics@2112

@wxt-dev/auto-icons

npm i https://pkg.pr.new/@wxt-dev/auto-icons@2112

@wxt-dev/browser

npm i https://pkg.pr.new/@wxt-dev/browser@2112

@wxt-dev/i18n

npm i https://pkg.pr.new/@wxt-dev/i18n@2112

@wxt-dev/is-background

npm i https://pkg.pr.new/@wxt-dev/is-background@2112

@wxt-dev/module-react

npm i https://pkg.pr.new/@wxt-dev/module-react@2112

@wxt-dev/module-solid

npm i https://pkg.pr.new/@wxt-dev/module-solid@2112

@wxt-dev/module-svelte

npm i https://pkg.pr.new/@wxt-dev/module-svelte@2112

@wxt-dev/module-vue

npm i https://pkg.pr.new/@wxt-dev/module-vue@2112

@wxt-dev/runner

npm i https://pkg.pr.new/@wxt-dev/runner@2112

@wxt-dev/storage

npm i https://pkg.pr.new/@wxt-dev/storage@2112

@wxt-dev/unocss

npm i https://pkg.pr.new/@wxt-dev/unocss@2112

@wxt-dev/webextension-polyfill

npm i https://pkg.pr.new/@wxt-dev/webextension-polyfill@2112

wxt

npm i https://pkg.pr.new/wxt@2112

commit: a3c33f6

codecov · 2026-02-11T14:13:48Z

Codecov Report

❌ Patch coverage is 80.70175% with 22 lines in your changes missing coverage. Please review.
✅ Project coverage is 79.35%. Comparing base (d3983a6) to head (a3c33f6).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
packages/wxt/src/core/builders/vite/index.ts	37.50%	11 Missing and 4 partials ⚠️
...ackages/wxt/src/core/utils/create-file-reloader.ts	90.90%	5 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2112      +/-   ##
==========================================
+ Coverage   78.81%   79.35%   +0.53%     
==========================================
  Files         134      134              
  Lines        3918     4005      +87     
  Branches      891      910      +19     
==========================================
+ Hits         3088     3178      +90     
+ Misses        741      737       -4     
- Partials       89       90       +1

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- Introduced `getRelevantDevChangedFiles` to filter out unrelated file changes. - Updated `detectDevChanges` to utilize the new filtering function for improved accuracy. - Modified `createFileReloader` to work with relevant file changes, ensuring only necessary reloads occur. - Enhanced tests to validate the new behavior and ensure proper handling of HTML-only reloads.

ZerGo0 · 2026-02-11T15:22:50Z

I pushed another small change. I don't really like the changes in 0cf79bb but I can't really think of a better way of doing this.

The problem is that it would show potentially wrong files in the "Changed: ..." log line and so on because they all use the "raw"/unfiltered queue. My latest commit fixes that.

PatrykKuniczak · 2026-02-11T21:23:33Z

I'm also have 1 file on which HMR doesn't work and i was about to report it, but i'll check it on your branch, maybe your PR will solve that issue 😄

aklinker1

Tested, things seem to behave the same way for me. One requested change.

Move createFileReloader into an internal core utils file and update create-server/test imports.

- Exported `createFileReloader` function to allow external usage. - Improved the file reloading process by implementing a queue worker to handle multiple file changes without dropping events. - Added `getRunnerProfileWatchIgnores` function to dynamically generate ignored paths based on user profiles for Chromium and Firefox. - Updated Vite builder configuration to include these new ignore patterns.

- Introduced `getRelevantDevChangedFiles` to filter out unrelated file changes. - Updated `detectDevChanges` to utilize the new filtering function for improved accuracy. - Modified `createFileReloader` to work with relevant file changes, ensuring only necessary reloads occur. - Enhanced tests to validate the new behavior and ensure proper handling of HTML-only reloads.

Move createFileReloader into an internal core utils file and update create-server/test imports.

PatrykKuniczak · 2026-02-14T09:21:20Z

it's working for Windows also, but it doesn't solve my issue, i'll open new issue about it.

…into fix/dev-watch-missed-reloads

- detect entrypoint directory file events that are missed by step-based dev change detection and treat them as rebuild candidates. - recompute and merge latest entrypoint groups on file changes so new entrypoints are built immediately instead of waiting for a dev server restart. - reload the extension when new entrypoints are introduced to keep manifest/runtime behavior in sync. - add and update `createFileReloader` tests to cover noisy events and newly added entrypoint files.

PatrykKuniczak · 2026-04-12T20:16:02Z

@aklinker1 This one also, needs your review

aklinker1 · 2026-04-27T02:16:44Z

+): string[] {
+  const root = normalizePath(wxtConfig.root);
+  const chromiumArgProfiles = extractPathArgs(
+    wxtConfig.runnerConfig.config?.chromiumArgs,


Hmm, I'm working on adding an alternative runner in the next major version and hardcoding access to one of the runner's config will prevent me from abstracting it.

It works for now like this, but we'll likely have to add a hook for this in the future...

Just thinking out loud, no changes here.

aklinker1 · 2026-04-27T02:22:23Z

@@ -1,35 +1,15 @@
-import { debounce } from 'perfect-debounce';


Can we remove this dependency?

ZerGo0 · 2026-04-27T03:32:46Z

@aklinker1 I can do a clean PR if you want?

(This issue is super frustrating tbh, 1/20 file saves trigger a rebuild/reload for me right now for me. It's usually faster to just stop and start the dev command ^^)

aklinker1 · 2026-04-27T13:20:22Z

Yeah, resolve the conflicts and I'll finish reviewing it.

…d-reloads # Conflicts: # packages/wxt/src/core/builders/vite/index.ts # packages/wxt/src/core/utils/create-file-reloader.ts

aklinker1 · 2026-04-29T12:43:17Z

+    expect(server.reloadExtension).toBeCalledTimes(1);
+  });
+
+  it('should rebuild and reload extension when a new entrypoint is added', async () => {


I noticed you resolved that TODO, thanks!

aklinker1

Some type errors causing CI to fail, the no-reload case is still not handled properly, it runs the final else block and tries to reload content scripts

…d-reloads

aklinker1

Sorry for the delay on this, merging now!

github-actions · 2026-06-30T20:12:11Z

Thanks for helping make WXT better!

ZerGo0 requested review from Timeraa and aklinker1 as code owners February 11, 2026 12:00

aklinker1 reviewed Feb 11, 2026

View reviewed changes

PatrykKuniczak reviewed Feb 11, 2026

View reviewed changes

Comment thread packages/wxt/src/core/builders/vite/index.ts

aklinker1 requested changes Feb 12, 2026

View reviewed changes

Comment thread packages/wxt/src/core/create-server.ts Outdated

ZerGo0 added 4 commits February 13, 2026 07:12

fix: keep createFileReloader out of the public API

41b2084

Move createFileReloader into an internal core utils file and update create-server/test imports.

fix: keep createFileReloader out of the public API

9e4d40d

Move createFileReloader into an internal core utils file and update create-server/test imports.

PatrykKuniczak force-pushed the fix/dev-watch-missed-reloads branch from 41b2084 to 9e4d40d Compare February 14, 2026 09:09

PatrykKuniczak requested changes Feb 14, 2026

View reviewed changes

Comment thread packages/wxt/src/core/utils/create-file-reloader.ts Outdated

ZerGo0 added 2 commits February 16, 2026 07:38

Merge branch 'fix/dev-watch-missed-reloads' of github.com:ZerGo0/wxt …

d3c877f

…into fix/dev-watch-missed-reloads

ZerGo0 requested a review from PatrykKuniczak February 16, 2026 07:22

PatrykKuniczak reviewed Feb 16, 2026

View reviewed changes

Comment thread packages/wxt/src/core/utils/create-file-reloader.ts Outdated

aklinker1 force-pushed the main branch from db3e29d to adaae6e Compare February 22, 2026 23:30

Merge upstream/main into fix/dev-watch-missed-reloads

c5be896

ZerGo0 requested review from PatrykKuniczak and aklinker1 March 12, 2026 08:55

PatrykKuniczak approved these changes Mar 12, 2026

View reviewed changes

aklinker1 mentioned this pull request Apr 27, 2026

chore: Move createFileReloader into it's own file #2307

Merged

aklinker1 reviewed Apr 27, 2026

View reviewed changes

ZerGo0 added 2 commits April 29, 2026 09:23

Merge remote-tracking branch 'upstream/main' into fix/dev-watch-misse…

1fb1d26

…d-reloads # Conflicts: # packages/wxt/src/core/builders/vite/index.ts # packages/wxt/src/core/utils/create-file-reloader.ts

chore: address file reloader review comments

d9550bf

ZerGo0 requested a review from aklinker1 April 29, 2026 07:42

aklinker1 requested changes Apr 29, 2026

View reviewed changes

fix: avoid redundant no-change reload condition

cd5c7cf

ZerGo0 requested a review from aklinker1 April 30, 2026 06:57

aklinker1 requested changes May 12, 2026

View reviewed changes

ZerGo0 added 2 commits May 19, 2026 09:56

fix: handle file reloader no-change branch

7b0c8ab

Merge remote-tracking branch 'upstream/main' into fix/dev-watch-misse…

656623d

…d-reloads

ZerGo0 requested a review from aklinker1 May 19, 2026 08:01

Merge branch 'main' into fix/dev-watch-missed-reloads

ca23fed

aklinker1 approved these changes Jun 30, 2026

View reviewed changes

aklinker1 enabled auto-merge (squash) June 30, 2026 20:05

Fix formatting

a3c33f6

aklinker1 merged commit 82825a5 into wxt-dev:main Jun 30, 2026
19 checks passed

		@@ -1,35 +1,15 @@
		import { debounce } from 'perfect-debounce';

Uh oh!

Uh oh!

Conversation

ZerGo0 commented Feb 11, 2026

Overview

Manual Testing

Related Issue

Uh oh!

netlify Bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for creative-fairy-df92c4 ready!

Uh oh!

aklinker1 left a comment

Choose a reason for hiding this comment

Uh oh!

pkg-pr-new Bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

ZerGo0 commented Feb 11, 2026

Uh oh!

PatrykKuniczak commented Feb 11, 2026

Uh oh!

Uh oh!

aklinker1 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

PatrykKuniczak commented Feb 14, 2026

Uh oh!

Uh oh!

Uh oh!

PatrykKuniczak commented Apr 12, 2026

Uh oh!

aklinker1 Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

aklinker1 Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ZerGo0 commented Apr 27, 2026

Uh oh!

aklinker1 commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

aklinker1 Apr 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

aklinker1 left a comment

Choose a reason for hiding this comment

Uh oh!

aklinker1 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jun 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

netlify Bot commented Feb 11, 2026 •

edited

Loading

pkg-pr-new Bot commented Feb 11, 2026 •

edited

Loading

codecov Bot commented Feb 11, 2026 •

edited

Loading

aklinker1 commented Apr 27, 2026 •

edited

Loading