Skip to content

Add note about deferred loading to flutter.dev/platform-integration/web/wasm - #13648

Open
mkustermann wants to merge 1 commit into
flutter:mainfrom
mkustermann:add-wasm-deferred-loading-note
Open

Add note about deferred loading to flutter.dev/platform-integration/web/wasm#13648
mkustermann wants to merge 1 commit into
flutter:mainfrom
mkustermann:add-wasm-deferred-loading-note

Conversation

@mkustermann

Copy link
Copy Markdown
Member

We have recently added the --enable-wasm-deferred-loading flag and should mention it in the documentation to make users aware.

@mkustermann
mkustermann requested review from a team and sfshaza2 as code owners July 30, 2026 11:10
@mkustermann
mkustermann requested review from biggs0125 and kevmoo July 30, 2026 11:10

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request adds a note to the Flutter web Wasm documentation explaining that deferred loading is not enabled by default and details how to enable it using an experimental flag. The feedback suggests improving the phrasing by removing the word "hidden" to describe the documented flag and simplifying "by default yet" to "by default".

Comment thread sites/docs/src/content/platform-integration/web/wasm.md Outdated
@mkustermann
mkustermann force-pushed the add-wasm-deferred-loading-note branch from 5f8dacd to 955e5e6 Compare July 30, 2026 11:16
@flutter-website-bot

flutter-website-bot commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 955e5e6):

https://flutter-docs-prod--docs-pr13648-add-wasm-deferred-load-h9vjrn0s.web.app

@flutter-website-bot

flutter-website-bot commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit 5f8dacd):

https://flutter-dev-230821--www-pr13648-add-wasm-deferred-load-2h7l64ir.web.app

@biggs0125 biggs0125 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I want to advertise this but should we either wait until this is on the stable branch or say something about this becoming available in Flutter 3.50? That way people don't try to do it today on the stable branch where it still doesn't work.

@mkustermann

Copy link
Copy Markdown
Member Author

I want to advertise this but should we either wait until this is on the stable branch or say something about this becoming available in Flutter 3.50? That way people don't try to do it today on the stable branch where it still doesn't work.

If we mention the deferred loading work on the dart & flutter blog posts, then we're telling that this is available in preview now. If we tell that to users, I think we should have documentation for it, which this PR adds.

See also my response here: dart-lang/site-www#7419 (comment)

(If we don't mention deferred loading in the dart & flutter blog posts - wdyt? - then there's no need to have it in the docs yet either)

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.

3 participants