forked from mirrors/material_3_expressive
83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
# m3e_collection
|
|
|
|
Single import that re-exports all M3E component packages plus `m3e_design`.
|
|
|
|
The packages `material_new_shapes` by [ulims](https://github.com/ulims) and `expressive_refresh` by [alvaronp](https://github.com/alvaronp) are reexported to complete the collection.
|
|
|
|
---
|
|
|
|
## Packages in this collection
|
|
|
|
- [m3e_design](../m3e_design) — Material 3 Expressive design language for Flutter (tokens, ThemeExtension, motion).
|
|
- [app_bar_m3e](../app_bar_m3e) — Expressive App Bar (Material 3 Expressive) with small/medium/large variants and Sliver integration.
|
|
- [button_m3e](../button_m3e) — Material 3 Expressive Buttons for Flutter with 5 styles, 5 sizes, round/square shapes, and toggle selection.
|
|
- [button_group_m3e](../button_group_m3e) — Wrapper-only Button Group for Material 3 Expressive (layout, shape, size propagation).
|
|
- [fab_m3e](../fab_m3e) — Material 3 Expressive Floating Action Button (FAB), Extended FAB, and FAB Menu for Flutter using M3E tokens.
|
|
- [icon_button_m3e](../icon_button_m3e) — Material 3 Expressive IconButton with sizes, variants, shapes, toggle, and accessible hit targets.
|
|
- [loading_indicator_m3e](../loading_indicator_m3e) — Material 3 Expressive Loading Indicator (morphing polygons) for Flutter, with Default and Contained variants.
|
|
- [progress_indicator_m3e](../progress_indicator_m3e) — Material 3 Expressive progress indicators.
|
|
- [navigation_bar_m3e](../navigation_bar_m3e) — Material 3 Expressive Navigation Bar for Flutter with token-driven colors, shapes, and badges.
|
|
- [navigation_rail_m3e](../navigation_rail_m3e) — Material 3 Expressive navigation rail (collapsed & expanded) with modal/standard modes, badges, sections, and m3e_design token integration.
|
|
- [slider_m3e](../slider_m3e) — Material 3 Expressive Sliders (single & range) for Flutter, powered by M3E tokens.
|
|
- [split_button_m3e](../split_button_m3e) — Material 3 Expressive Split Button with sizes, variants, shapes, a11y, and menu.
|
|
- [toolbar_m3e](../toolbar_m3e) — Material 3 Expressive Toolbars for Flutter with token-driven colors, shapes, density, and overflow handling.
|
|
|
|
### External re-exports
|
|
|
|
- material_new_shapes — Extra Material shapes (e.g., RoundedPolygon) used by M3E components. Author: [ulims](https://github.com/ulims).
|
|
- expressive_refresh — Expressive pull-to-refresh component. Author: [alvaronp](https://github.com/alvaronp).
|
|
|
|
---
|
|
|
|
## Live demo (Gallery)
|
|
|
|
Explore the components in the M3E Gallery (GitHub Pages):
|
|
|
|
https://<your-github-username>.github.io/material_3_expressive/
|
|
|
|
To run the Gallery locally:
|
|
|
|
```sh
|
|
cd apps/gallery
|
|
flutter run -d chrome
|
|
```
|
|
|
|
_Last updated: 2025-10-23_
|
|
|
|
|
|
---
|
|
|
|
## Detailed Guide
|
|
|
|
### What this package provides
|
|
A convenience package that re-exports all Material 3 Expressive components and design tokens so you can depend on one package and import everything you need.
|
|
|
|
### Installation
|
|
- Monorepo (local path): already configured in this repo.
|
|
- Pub (when published):
|
|
```yaml
|
|
dependencies:
|
|
m3e_collection: ^0.1.0
|
|
```
|
|
|
|
Minimum SDK: Dart >=3.5.0.
|
|
|
|
### Dependencies (via this collection)
|
|
- m3e_design, icon_button_m3e, split_button_m3e, button_group_m3e, app_bar_m3e, button_m3e, fab_m3e,
|
|
loading_indicator_m3e, progress_indicator_m3e, navigation_bar_m3e, navigation_rail_m3e, slider_m3e, toolbar_m3e.
|
|
|
|
### Quick start
|
|
```dart
|
|
import 'package:m3e_collection/m3e_collection.dart';
|
|
|
|
// Use any M3E widget, e.g. a filled button
|
|
ButtonM3E.filled(label: const Text('Continue'), onPressed: () {})
|
|
```
|
|
|
|
### Notes
|
|
- Keep versions of individual packages aligned; this collection pins compatible versions.
|
|
|
|
### Links
|
|
- Repository: https://github.com/EmilyMoonstone/material_3_expressive/tree/main/packages/m3e_collection
|
|
- Issue tracker: https://github.com/EmilyMonestone/material_3_expressive/issues
|
|
- Changelog: ./CHANGELOG.md
|