Repository navigation
[web] Update Flutter 3.50 web caching, Wasm, and viewport-fit docs - #13986
Merged
Merged
Conversation
- Document `flutter build web --web-content-hash`, two-tier `Cache-Control` headers, overlay deployment for active tabs, `precache_manifest.json`, and `{{flutter_build_config}}` compatibility in `deployment/web.md`, `faq.md`, and `initialization.md`.
- Update `wasm.md` and `initialization.md` for Flutter 3.50 / Dart 3.14: document W3C `WasmGC` + `wasm:js-string` + `try_table` requirements, the Chromium 137+ / Safari 26.2+ / Firefox 147+ compatibility matrix, `wasmAllowList`, `renderer`, `verboseBuildSelection`, `suppressMultithreadingWarning`, `wasmDeferredModulesLoader`, and `--no-deprecated-js-interop`.
- Document `viewport-fit=cover` `SafeArea` support (with breaking change guide `viewport-fit-cover-safe-area.md`), URL percent-encoding preservation in browser history, and remove obsolete `--no-web-experimental-hot-reload` / 2019 HTML renderer prose and dead link references.
Fixes #13825
Fixes #13961
Fixes #13962
Collaborator
|
Staged preview of the updated docs.flutter.dev site (updated for commit 6abd4c7): |
kevmoo
commented
Oct 16, 2026
kevmoo
commented
Oct 16, 2026
kevmoo
commented
Oct 16, 2026
kevmoo
commented
Oct 16, 2026
kevmoo
commented
Oct 16, 2026
…x 147+, and interop removal
kevmoo
marked this pull request as ready for review
October 16, 2026 22:17
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request updates the Flutter web documentation for Flutter 3.50, introducing details on web content hashing (--web-content-hash), mobile browser viewport and SafeArea support (viewport-fit=cover), updated Wasm browser compatibility requirements, and modern JS interop enforcement (--no-deprecated-js-interop). The review feedback identifies a few documentation inaccuracies, including a typo in the hashed asset manifest filename, incorrect Safari/iOS minimum versions for Wasm support, and a minor distinction regarding the deprecation of package:js versus built-in SDK libraries.
conooi
reviewed
Oct 19, 2026
Contributor
Author
|
Thanks! Addressed all 6 review comments in aa8c9f7. |
conooi
approved these changes
Oct 23, 2026
conooi
left a comment
conooi
left a comment
Contributor
There was a problem hiding this comment.
Added a couple of suggestions that I missed the first time around but otherwise LGTM!
Co-authored-by: Connie Ooi <[email protected]>
Co-authored-by: Connie Ooi <[email protected]>
Collaborator
|
Staged preview of the updated flutter.dev site (updated for commit f1efa93): |
Keep all six Flutter 3.50 breaking-change index entries in alphabetical order.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates Flutter web deployment, WebAssembly, initialization, and breaking-change documentation for the Flutter 3.50 release:
flutter build web --web-content-hash(8-character SHA-256 content hashes across entrypoints andbuild/web/assets/**, splitCache-Controlrules, overlay deployment for active tabs, andprecache_manifest.json).WasmGC+wasm:js-string+try_tableacross Chromium 137+, Safari 26.2+, and Firefox 147+),FlutterConfigurationoptions (wasmAllowList,renderer,verboseBuildSelection,suppressMultithreadingWarning,wasmDeferredModulesLoader), and--no-deprecated-js-interop(highlighting upcoming Dart SDK removal of legacy JS interop libraries).viewport-fit=coverSafeAreabreaking-change migration guide (viewport-fit-cover-safe-area.md), notes browser history URL percent-encoding preservation, updatesinitialization.mdfor{{flutter_service_worker_version}}/serviceWorkerSettingsdeprecation, and removes obsolete--no-web-experimental-hot-reload/ 2019 HTML-renderer prose.Fixes #13825
Fixes #13961
Fixes #13962