M3E Core #

A comprehensive Flutter package providing Expressive Material 3 components: Card Lists, Dismissible Cards, Expandable Cards, Dropdown Menus, Buttons, Floating Toolbars, Extended M3 Shapes, Seekbars, Progress & Loading Indicators, and Emphasized Typography.

Live Demo #

Try the hosted example app here: m3e_core

Browse the example source here:

Example App

📦 Individual Packages #

This package (m3e_core) bundles multiple M3E components. For detailed documentation and standalone usage, please refer to the individual packages:

• m3e_card_list - Expressive card list with dynamic radii.
• m3e_dismissible - Swipe-to-dismiss with "neighbour pull" physics.
• m3e_expandable - Spring-animated expandable card lists.
• m3e_dropdown_menu - Fluid dropdown with search and chip tags.
• m3e_buttons - Expressive button system with neighbor squish and shape morphing.
• flutter_m3shapes_extended - Full suite of M3 expressive shapes.
• m3e_floating_toolbar - Material 3 Expressive FloatingToolbar family.
• m3e_slider - Material 3 Expressive Slider and RangeSlider components.
• m3e_color_scheme - Material 3 Expressive dynamic color scheme utilities.
• m3e_haptics - Expressive haptic feedback engine with spring-synchronized patterns.
• m3e_progress_indicator - Material 3 Expressive circular and linear progress indicators.
• m3e_loading_indicator - Expressive loading indicator with shape morphing animations.
• m3e_seekbar - Material 3 Expressive Seekbar with standard and wavy variants.
• m3e_typography - Material 3 Expressive Emphasized Typography scale and variable font extensions.

📦 Installation #

Add m3e_core and material_ui to your pubspec.yaml:

dependencies:
  material_ui: ^1.1.0
  m3e_core: ^1.1.1

import 'package:material_ui/material_ui.dart';
import 'package:m3e_core/m3e_core.dart';

⚠️ Breaking API Changes (v0.1.0) #

Version 0.1.0 updates m3e_dismissible, m3e_expandable, m3e_card_list and m3e_dropdown to v0.1.0. These updates include breaking API changes.

Please refer to the documentation on their respective individual package pages (linked below) for detailed migration guides and updated API references.

🧩 Components #

Detailed documentation for each component is available in their respective packages linked above.

1. M3E Card List #

Static or scrollable interactive card lists with expressive styling, custom radii, and various list/column/sliver variants. Detailed Documentation →

2. M3E Dismissible Cards #

Swipe-to-dismiss items with a beautiful spring-driven "neighbour pull" effect. Supports Gmail-style dismissal and high-damping physics. Detailed Documentation →

3. M3E Expandable Cards #

Smoothly expand and collapse individual cards using motor spring animations. Supports auto-collapse and multiple expanded items. Detailed Documentation →

4. M3E Dropdown Menu #

A powerful, stylized dropdown with support for single/multi-selection, fuzzy search, async loading, and animated chip tags. Detailed Documentation →

5. M3E Buttons #

A robust button system featuring:

• Neighbor Squish: Adjacent buttons compress when one is pressed.
• Shape Morphing: Smooth transitions between different shapes (e.g., pill to square).
• Overflow Management: Supports scroll, menu, and paging for constrained spaces. Detailed Documentation →

6. M3 Shapes Extended #

A wide variety of predefined Material 3 expressive shapes (Gem, Slanted, Flower, etc.) for visual elements or clipping. Detailed Documentation →

7. M3E Floating Toolbar #

A faithful Flutter port of the Material 3 Expressive FloatingToolbar component family with spring physics. Detailed Documentation →

8. M3E Slider #

Material 3 Expressive Slider and RangeSlider with docking animations, spring physics, and support for track shapes. Detailed Documentation →

9. M3E Color Scheme #

Dynamic color scheme utilities following Material 3 Expressive color system guidelines. Detailed Documentation →

10. M3E Haptics #

Expressive haptic feedback engine with spring-synchronized patterns for rich tactile experiences. Detailed Documentation →

11. M3E Progress Indicator #

Material 3 Expressive circular and linear progress indicators with wavy and animated variants. Detailed Documentation →

12. M3E Loading Indicator #

Expressive loading indicator with fluid shape morphing animations. Detailed Documentation →

13. M3E Seekbar #

Material 3 Expressive Seekbar with standard, wavy, and animated variants, custom handle shapes, and spring physics. Detailed Documentation →

14. M3E Typography #

Material 3 Expressive Emphasized Typography scale elevating font weights, optical sizes, and variable font axes across all 15 M3 roles. Detailed Documentation →

🐞 Found a bug? or ✨ Feature Request? #

Feel free to open an Issue or Contribute.

❤️ Support & Like #

If you loved using M3E Core, please consider dropping a 👍 like on pub.flutter-io.cn and a ⭐ star on GitHub — it helps the project grow!

Credits #

• Motor for Expressive Animations
• Multi_dropdown for Dropdown Menu base
• flutter_m3shapes for M3 Shapes base
• M3E Collection for helping with buttons implementation

Radhe Radhe 🙏 #