77

The default URL of a Flutter web project defines a URL containing a hashtag (#), as follows:

http://localhost:41521/#/peaple/...

I would like to remove this '#', looking like this:

http://localhost:41521/peaple/

How can I solve this problem?

1

8 Answers 8

103

You can now use a simple package and a single line of code to remove the leading hash (#) from your Flutter web app: url_strategy (full disclosure: I am the author)

Using url_strategy

You simply add the dependency as described here and then add the following function call to your main function:

import 'package:url_strategy/url_strategy.dart';

void main() {
  // Here we set the URL strategy for our web app.
  // It is safe to call this function when running on mobile or desktop as well.
  setPathUrlStrategy();
  runApp(MyApp());
}

Calling setPathUrlStrategy is all you need to do 🎉


The package also ensures that running the code will not crash on mobile (see below). Additionally, this will also run on stable if you build your mobile app on stable and only web on beta.

Notes

You need to make sure that you include <base href="/"> inside the <head> section of your web/index.html when using the path URL strategy.
This is added by default when creating a new Flutter app.

Furthermore, when deploying your production app, you need to make sure that every path points to your index.html. If you use tools like Firebase hosting, this is done automatically for you when configuring your app as a single page app.
Otherwise, you want to look up how to rewrite all paths to your index.html for the hosting you are using.

Essentially, you want to have a single page app, where the HTTP server serves the index.html for all paths.


The package implementation is based on the manual solution using flutter_web_plugins. The benefits of using the package are the following:

  • Only need to call a single function.
  • No need to use conditional imports (the package does it for you).
  • You will not get any missing implementation issues on stable (as the web feature is still on beta).
8
  • 3
    You can redirect all of your paths to index.html by adding thnis to the "hosting" field in your firebase.json: "rewrites": [ { "source": "**", "destination": "/index.html" } ]
    – Banjoe
    Aug 10, 2021 at 21:53
  • 2
    By default, Flutter uses the hash (/#/) location strategy. what is benefit of hash?
    – Zahra
    Aug 22, 2021 at 9:05
  • @cretivecreatormaybenot I'm using url_strategy and when I type in a new url the app restarts instead of just parsing it and update the shown page. Is it normal ? To test it I used this Navigator 2.0 example: github.com/carloshwa/flutter-example/tree/navigator_2 Many thanks
    – Vincenzo
    Nov 29, 2021 at 6:03
  • Fantastic, thank you so much! For some reason, that '#' was really annoying me, and it was getting in the way of some specific routing I needed to do. Feb 20, 2022 at 17:57
  • Without /#/ every time you change address, the whole app restarts. With it, you just move within navigation system of the app, which is clearly faster and more efficient. It's probably not a good idea to change the default behavior. Nov 18, 2022 at 2:52
28

The following answer is copied from Mouad Debbar's explanation on GitHub (see issue comment).


Here are the steps to use it once it's available:

Add <base href="/"> inside the <head> section of your web/index.html file. This will be added automatically for new projects created by flutter create. But for existing apps, the developer needs to add it manually. Add the flutter_web_plugins dependency in pubspec.yaml if it doesn't already exist:

dependencies:
  flutter_web_plugins:
    sdk: flutter

Add a lib/configure_nonweb.dart with the following content:

void configureApp() {
  // No-op.
}

Add a lib/configure_web.dart with the following content:

import 'package:flutter_web_plugins/flutter_web_plugins.dart';

void configureApp() {
  setUrlStrategy(PathUrlStrategy());
}

In lib/main.dart, do the following:

import 'package:flutter/material.dart';
import 'configure_nonweb.dart' if (dart.library.html) 'configure_web.dart';

void main() {
  configureApp();
  runApp(MyApp());
}
6
  • Currently it's not available on either master or stable channels. But it's tested to be working on both dev and beta channels. Nov 7, 2020 at 11:00
  • 1
    This should really be a community wiki because it is just a copied answer. Dec 13, 2020 at 15:32
  • I now wrote an answer with a simpler solution: stackoverflow.com/a/65709246/6509751 Jan 13, 2021 at 20:27
  • 1
    Does this work if the base href is something else like /app/? Feb 16, 2021 at 22:35
  • 2
    I prefer this answer because it does not rely on a package, and it's really just a few very simple changes. Relying on url_strategy package for such simple edits is a bad idea for infrastructure and long-term support reasons. May 28, 2022 at 4:46
4

Only for Github pages hosting

This also applies to apps that aren't served from domain.com/ directly but from some path domain.com/path/.

You need to add your repo name to base href otherwise your website won't work.

<base href="/REPO_NAME/">
2

If your only concern is for routing, you can do something like this:

onGenerateRoute: (settings) {
    List segments = settings.name.split('/').where((x) => ! x.isEmpty).toList();
    String page = segments.length > 0 ? segments[0] : '';
    ...
  }
}
2
  • where to write this ? Feb 28, 2021 at 13:49
  • @NehalJaisalmeria inside your MaterialApp() widget
    – iqfareez
    Apr 25, 2021 at 10:38
1

add this in pubspec.yaml

dependencies:
  flutter_web_plugins:
    sdk: flutter

inside the main.dart file add the cofigureApp in to root of the app and also add this import

import 'package:flutter_web_plugins/flutter_web_plugins.dart';

void configureApp() {
  setUrlStrategy(PathUrlStrategy());
}

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  configureApp();
  runApp(MyApp());
}

restart the web app

out will be like this

http://localhost:52299/login_page
1
  1. Install in pubspec.yaml url_strategy

  2. Write in main.dart:

import 'package:url_strategy/url_strategy.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  setPathUrlStrategy();
  runApp(MyApp());
}
  1. If you get an error when you refresh the page, then add file 404.html to the folder with index.html. Copy the entire contents of the index.html and paste it into the 404.html. For some hosts it's enough. But some host aslo requires the file ".htaccess".

  2. You shoud create in the same folder the file ".htaccess" and write into this file:

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule . /index.html [L]

This solution was recieved from this video.

1
  • yet another beta projects, based on its semver.
    – Xao
    Mar 3 at 10:36
0

I found most of the answers above to be a bit confusing. What ended up working for my firebase-hosted website was following this short 4-minute YouTube tutorial by Johannes Milke.

The tutorial outlines a number of options for solving the "#" problem, basically explaining some of the answers above a bit better. My final solution was to

  1. Add url_strategy dependency as outlined in many of the answers above.
  2. Adding base href="/"> inside the section of my index.html file
  3. Making sure that all paths point to index.html by adding "rewrites": [ { "source": "**", "destination": "/index.html" } ] in my firebase.json.
0

you can also do this

String main_url = url.split('#').join();

eg. http://localhost:31265/#apply?id=1

output: http://localhost:31265/apply?id=1

2
  • what do you even mean man? provide more details
    – Xao
    Mar 3 at 10:34
  • The post ask to remove # so u could just split the url around # and then again join it.
    – Moiz
    Mar 4 at 17:46

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.