https://github.com/pingbird/puro

A powerful tool for installing and upgrading Flutter versions.
https://github.com/pingbird/puro

dart flutter

Last synced: 4 days ago
JSON representation

A powerful tool for installing and upgrading Flutter versions.

• Host: GitHub
• URL: https://github.com/pingbird/puro
• Owner: pingbird
• License: other
• Created: 2022-10-12T23:52:50.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-12-05T23:25:18.000Z (about 1 month ago)
• Last Synced: 2025-01-01T22:45:22.534Z (4 days ago)
• Topics: dart, flutter
• Language: Dart
• Homepage: https://puro.dev
• Size: 1.05 MB
• Stars: 264
• Watchers: 6
• Forks: 13
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# About

Puro is a powerful tool for installing and upgrading [Flutter](https://flutter.dev/) versions, it is essential for any

developers that work on multiple projects or have slower internet.

With Puro you can:

* Use different versions of Flutter at the same time

* Download new versions twice as fast with significantly less disk space and internet bandwidth

* Use versions globally or per-project

* Automatically configure IDE settings with a single command

## Installation

Puro is distributed as a precompiled executable (you do not need Dart installed), see the quick installation

instructions at https://puro.dev/

## Quick start

After installing Puro you can run `puro flutter doctor` to install the latest stable version of Flutter, if you want to

switch to beta you can run `puro use -g beta` and then `puro flutter doctor` again.

And that's it, you're ready to go!

Puro uses the concept of "environments" to manage Flutter versions, these can either be tied to a specific version /

release channel, or a named environment that can be upgraded independently.

Environments can be set globally or per-project, the global environment is set to `stable` by default.

Cheat sheet:

```

# Create a new environment "foo" with the latest stable release

puro create foo stable

# Create a new environment "bar" with with Flutter 3.13.6

puro create bar 3.13.6

# Switch "bar" to a specific Flutter version

puro upgrade bar 3.10.6

# List available environments

puro ls

# List available Flutter releases

puro releases

# Switch the current project to use "foo"

puro use foo

# Switch the global default to "bar"

puro use -g bar

# Remove puro configuration from the current project

puro clean

# Delete the "foo" environment

puro rm foo

# Run flutter commands in a specific environment

puro -e foo flutter ...

puro -e foo dart ...

puro -e foo pub ...

```

See the full command list at https://puro.dev/reference/manual/

## Performance

Puro implements a few optimizations that make installing Flutter as fast as possible.

First-time installations are 20% faster while improving subsequent installations by a whopping 50-95%:

![](https://puro.dev/assets/install_time_comparison.svg)

This also translates into much lower network usage:

![](https://puro.dev/assets/network_usage_comparison.svg)

## How it works

Puro achieves these performance gains with a few smart optimizations:

* Parallel git clone and engine download

* Global cache for git history

* Global cache for engine versions

With other approaches, each Flutter repository is in its own folder, requiring you to download and store the git history, engine, and framework of each version:

![](https://puro.dev/assets/storage_without_puro.png)

Puro implements a technology similar to GitLab's [object deduplication](https://docs.gitlab.com/ee/development/git_object_deduplication.html) to avoid downloading the same git objects over and over again. It also uses symlinks to share the same engine version between multiple installations:

![](https://puro.dev/assets/storage_with_puro.png)