Melos

Manage multi-package repositories.

Melos is a workspace management tool for Dart and Flutter. It streamlines monorepo development by handling local linking, testing, versioning, and publishing across multiple packages.

Melos is ideal for repositories that combine applications and shared internal packages. It runs bulk scripts, generates IDE run configurations, and handles app versioning (for example, 1.2.3+45), even if you never publish to pub.dev. You can also use it for single package projects.

Melos is trusted by major projects like FlutterFire and Flame. For more information, see projects using Melos. To add yours, submit your project.

Note: Melos 8 configures directly from the root pubspec.yaml file and requires Dart 3.9+.

Key features

  • Versioning and Changelogs: Automatically determines versions and writes changelogs based on Conventional Commits.
  • Publishing: Pushes newly versioned packages to pub.dev.
  • Local Linking: Makes local changes available to dependent packages without publishing.
  • Global Commands: Runs scripts (like tests or linting) across all or selected packages simultaneously.
  • Package Listing: Visualizes your workspace and its dependency graph.
  • Continuous Integration: Automates commands and releases in CI, with native support via the Melos GitHub Action.

How it compares to other tools

If you are coming from other ecosystems, Melos brings the same capabilities to Dart and pubspec.yaml files:

Note: Melos builds on top of the native Dart pub workspaces.

Install

Workspace
Workspace

Add Melos to a multi-package repo and run melos bootstrap.

Single package
Single package

One application or package in the repo root, with useRootAsPackage.

Agents

Melos skills
Melos skills

Load the five skills with dart run skills@ get after bootstrap.

Features

Configure a Melos workspace
Configure a Melos workspace

Set the workspace up in the root pubspec.yaml file.

Workspace scripts
Workspace scripts

Define commands the workspace can run with melos run.

Automated releases
Automated releases

Version, changelog, and publish from Conventional Commits.

Help

Discord
Discord

Ask a question.

GitHub Issues
GitHub Issues

Report a bug or submit a feature request.

Changelog
Changelog

What changed in each Melos release.