Warning

This branch, next, is a working draft of the next major version of this library. Breaking changes are to be expected with each new commit.

Important

Below are (mostly) up-to-date instructions on how to properly set up this library, as well as some basic information. Both the guides and the info may be inaccurate or outdated.

Note

For now, workspace member packages do not have README files of their own, so kindly refer to this one for any information.

Material for Flutter

A Material Design components library which does it just right.

---

Table of contents

• Packages
  • mcu
    • Installation
  • material3
  • material3_expressive
    • Installation
• Apps
  • mtb
    • Installation
      • Building from source
      • Installing globally
      • Download a prebuilt binary
    • Usage

Packages

mcu

Caution

Package name may change in the near future.

This package is a Dart port of the recently updated [Material Color Utilities] (the Dart version of which is now outdated).

Installation

1. Add this to pubspec.yaml:

   dependency_overrides:
     mcu:
       git:
         url: git@github.com:deminearchiver/evolve.git
         ref: next
         path: packages/mcu

2. Now you can add the package in your pubspec.yaml:

   dependencies:
     mcu: # This gets overriden

material3

TBA.

material3_expressive

Installation

1. Add this to pubspec.yaml:

   dependency_overrides:
     mcu:
       git:
         url: git@github.com:deminearchiver/evolve.git
         ref: next
         path: packages/mcu
     material3_expressive:
       git:
         url: git@github.com:deminearchiver/evolve.git
         ref: next
         path: packages/material3_expressive

2. Now you can add the package in your pubspec.yaml:

   dependencies:
     material3_expressive: # This gets overriden

Apps

mtb

mtb is short for "Material Theme Builder". This app is the unofficial CLI counterpart of the web-based official Material Theme Builder app.

Installation

Building from source

1. Clone this repository:

   git clone -b next https://github.com/deminearchiver/evolve.git

2. Install workspace dependencies:

   flutter pub get

3. Switch to the apps/mtb directory:

   cd apps/mtb

4. Install app dependencies:

   dart pub get

5. Compile to an executable:

   dart compile exe bin/mtb.dart

Installing globally

1. Clone this repository:

   git clone -b next https://github.com/deminearchiver/evolve.git

2. Install workspace dependencies:

   flutter pub get

3. Switch to the apps/mtb directory:

   cd apps/mtb

4. Install app dependencies:

   dart pub get

5. Install globally:

   dart pub global activate --source path .

Download a prebuilt binary

A prebuilt binary should be available on the Actions page.

Usage

mtb create