Skip to content

fix(build): keep web apps on path routing through boot (no /#/, deep links survive) #6639

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
FeodorFitsner merged 2 commits into from
Jul 4, 2026
Merged

fix(build): keep web apps on path routing through boot (no /#/, deep links survive) #6639

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6bef1e6
fix(build): select web URL strategy before boot, not in prepareApp()
FeodorFitsner Jul 4, 2026
44476cf
fix(build): don't let the boot-screen MaterialApp report route '/' to…
FeodorFitsner Jul 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 24 additions & 6 deletions sdk/python/templates/build/{{cookiecutter.out_dir}}/lib/main.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,20 @@ String appDir = "";
Map<String, String> environmentVariables = Map.from(Platform.environment);

void main(List<String> args) async {
// On web the URL strategy must be selected before ANYTHING reads the initial
// location: FletDeepLinkingBootstrap.install() (below) calls
// WidgetsFlutterBinding.ensureInitialized() and starts observing route pushes,
// and the first runApp() wires up the router. Whatever strategy is active at
// that point latches how the cold-start URL maps to a route — under Flutter's
// default hash strategy a hard refresh of `/apps/x` reads an empty fragment
// (route "/"), so the deep link is lost and the app rewrites the URL to "/".
// Applying the strategy that `flet build` baked into window.flet here, as the
// very first statement, keeps both the running URLs (no `/#/`) and cold-start
// deep links on the path strategy.
if (kIsWeb && getFletRouteUrlStrategy() == "path") {
usePathUrlStrategy();
}

FletDeepLinkingBootstrap.install();

_args = List<String>.from(args);
Expand Down Expand Up @@ -268,9 +282,16 @@ class _BootOverlayState extends State<_BootOverlay> {
// resolveBootScreen is built once here (status changes update the
// message via the screen's own ValueListenableBuilder), so the spinner
// keeps animating across preparing → starting up.
// Use `builder:` rather than `home:` so this MaterialApp creates NO
// Navigator. A MaterialApp with `home` builds a Navigator with
// `reportsRouteUpdateToEngine: true`, which pushes the home route "/"
// to the browser URL on mount — clobbering a cold-start deep link
// (e.g. `/gallery`) before FletApp's real router reads it. The boot
// overlay never navigates, so it doesn't need a Navigator; this keeps
// theme/Directionality while leaving the URL untouched.
child: MaterialApp(
debugShowCheckedModeBanner: false,
home: resolveBootScreen(
builder: (context, _) => resolveBootScreen(
name: bootScreenName,
options: bootScreenOptions,
extensions: extensions,
Expand Down Expand Up @@ -301,12 +322,9 @@ Future prepareApp() async {
);

if (kIsWeb) {
// web mode - connect via HTTP
// web mode - connect via HTTP. The URL strategy is applied in main() before
// runApp(); doing it here would be too late (see the note there).
pageUrl = Uri.base.toString();
var routeUrlStrategy = getFletRouteUrlStrategy();
if (routeUrlStrategy == "path") {
usePathUrlStrategy();
}
assetsDir = getAssetsDir();
} else if (_args.isNotEmpty && isDesktopPlatform()) {
// developer mode
Expand Down
Loading