[Proposal] Support --base-href for flutter run

Use case

I want to test my web app when it runs in a subfolder. When I build the web app, I can use the flag --base-href to supply the correct subfolder the web app will be hosted at. This flag is however not available for the flutter run command.

In VS Code I have the following configuration

{
    "name": "portal (in subfolder)",
    "type": "dart",
    "request": "launch",
    "program": "clients/portal/lib/main.dart",
    "args": [
        "--web-launch-url=http://localhost:8080/preview",
        "--web-port=8080",
        "--web-browser-flag=--disable-web-security",
    ]
},

Adding --base-href=/preview/ as an argument results in the error:
Could not find an option named "base-href".

Proposal

Add --base-href to the flutter run command.

Or maybe consider to support all flags that are supported by flutter build command, if that makes sense.

Workaround for now is to either

change the value manually in index.html
Add a preLaunchTask to edit index.html

Downsides for both these workarounds are

I've got a change to undo before committing anything to git
When launching another configuration, I have to reset base href manually or using preLaunchTask

You can use this for a production build flutter build web --base-href /path/
Labelling this issue as a valid proposal to support base-href to run command

feat: Add --base-href support to flutter run for web (#182709)

feat: Add --base-href support to flutter run for web (flutter#182709)

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

feat: Add --base-href support to flutter run for web (flutter#182709)

Navigation Menu

Repository navigation

[Proposal] Support `--base-href` for flutter run #163141

Use case

Proposal

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[Proposal] Support --base-href for flutter run #163141

Description

Use case

Proposal

Activity

markbeij commented on Feb 12, 2025

maheshj01 commented on Feb 13, 2025

github-actions commented on Apr 7, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

[Proposal] Support `--base-href` for flutter run #163141