Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Flutter Wrapper

flutterw is a tiny, open source shell script which downloads and executes the Flutter SDK with the exact version defined in your project respository. It encourages the idea that upgrading Flutter should happen per project, not per developer. Thus upgrading Flutter with flutterw automatically upgrades Flutter for your co-workers and on the CI servers.

The Flutter Wrapper will add the Flutter SDK as a git submodule to your project. It pins the version and the channel.

This project is inspired by the gradle wrapper.

Read more on Medium

Install flutterw

sh -c "$(curl -fsSL"

Open the Terminal, navigate to your project root and execute the line above.

From now on use ./flutterw instead of flutter

flutterw terminal demo

IDE Setup

Use with VScode

If you're a VScode user link the new Flutter SDK path in your settings $projectRoot/.vscode/settings.json (create if it doesn't exists yet)

    "dart.flutterSdkPath": ".flutter",

Commit this file to your git repo and your coworkers will automatically use flutterw from now on

Use with IntelliJ / Android Studio

Go to Preferences > Languages & Frameworks > Flutter and set the Flutter SDK path to $projectRoot/.flutter

IntelliJ Settings

Add this step to the onboarding guidelines of your projects because this has to be done for every developer for every project using flutterw.

Tips and Tricks

Upgrading Flutter

Flutter Wrapper doesn't require any special command to update Flutter. Run ./flutterw channel <stable|beta|dev|master> to change the channel or update to the lastest version of a given channel.

./flutterw channel beta
./flutterw upgrade

Don't forget to commit the submodule changes.

Updating flutterw

To update the flutter wrapper to the latest version run the install command again:

sh -c "$(curl -fsSL"

To update the flutter wrapper to a specific verssion, use the -t <tag/branch> (i.e. v1.0.0)

sh -c "curl -fsSL" | bash /dev/stdin -t v1.0.0

Uninstall flutterw

Sorry to let you go! Removing submodules is hard, that's why I did the hard work for you. Simply run this command from the root of your flutter project and the uninstall script will cleanup everything.

sh -c "$(curl -fsSL"

Bye 👋

Create a new project using the flutter wrapper

You can create a new Flutter project without installing Flutter globally on your machine.

# 1. Create an empty git repo
mkdir flutter_wrapper_project && cd "$_"
git init

# 2. Install flutterw
sh -c "$(curl -fsSL"

# 3. Create Flutter project
./flutterw create .
./flutterw run


Copyright 2019 Pascal Welsch

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


Flutter execution wrapper which keeps the flutter version in sync for each project




Sponsor this project

Learn more about GitHub Sponsors


No packages published


You can’t perform that action at this time.