From be47e513c44498dcf38a857bcf396a475ff9644e Mon Sep 17 00:00:00 2001 From: Martin Kustermann Date: Thu, 30 Jul 2026 13:07:22 +0200 Subject: [PATCH 1/3] Add note about deferred loading to flutter.dev/platform-integration/web/wasm --- .../src/content/platform-integration/web/wasm.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/sites/docs/src/content/platform-integration/web/wasm.md b/sites/docs/src/content/platform-integration/web/wasm.md index b2755cee9b..9e5de95c2c 100644 --- a/sites/docs/src/content/platform-integration/web/wasm.md +++ b/sites/docs/src/content/platform-integration/web/wasm.md @@ -70,6 +70,19 @@ $ flutter build web --wasm The command produces output into the `build/web` directory relative to the package root, just like `flutter build web`. +:::note +Enabling Wasm compilation for a Flutter web app does not use deferred loading +by default. Deferred loading in Wasm is experimental and can be enabled +using the `--enable-wasm-deferred-loading` flag: + +```console +$ flutter build web --wasm --enable-wasm-deferred-loading +``` + +This is available on the flutter main branch and will become generally +available later this year in the 3.47.0 flutter stable release. +::: + #### Wasm production debugging By default, Wasm release builds strip debug symbols and omit source maps From ead41f0492a3e3051b0e3602566e19ebaffcb123 Mon Sep 17 00:00:00 2001 From: Martin Kustermann Date: Wed, 5 Aug 2026 13:19:45 +0200 Subject: [PATCH 2/3] Update 3.47.0 -> 3.50.0 --- sites/docs/src/content/platform-integration/web/wasm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/platform-integration/web/wasm.md b/sites/docs/src/content/platform-integration/web/wasm.md index 9e5de95c2c..202c26d29d 100644 --- a/sites/docs/src/content/platform-integration/web/wasm.md +++ b/sites/docs/src/content/platform-integration/web/wasm.md @@ -80,7 +80,7 @@ $ flutter build web --wasm --enable-wasm-deferred-loading ``` This is available on the flutter main branch and will become generally -available later this year in the 3.47.0 flutter stable release. +available later this year in the 3.50.0 flutter stable release. ::: #### Wasm production debugging From 3b7decb7cc189944a92051bfda51950c25ddbc09 Mon Sep 17 00:00:00 2001 From: Martin Kustermann Date: Wed, 5 Aug 2026 13:22:46 +0200 Subject: [PATCH 3/3] Update 3.50.0 -> 3.50 --- sites/docs/src/content/platform-integration/web/wasm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/platform-integration/web/wasm.md b/sites/docs/src/content/platform-integration/web/wasm.md index 202c26d29d..0a8ca91f27 100644 --- a/sites/docs/src/content/platform-integration/web/wasm.md +++ b/sites/docs/src/content/platform-integration/web/wasm.md @@ -80,7 +80,7 @@ $ flutter build web --wasm --enable-wasm-deferred-loading ``` This is available on the flutter main branch and will become generally -available later this year in the 3.50.0 flutter stable release. +available later this year in the 3.50 flutter stable release. ::: #### Wasm production debugging