material_expressive_ui
Material 3 Expressive components for Flutter. The package includes spring-animated buttons, form fields, pickers, charts and adaptive navigation. Its shapes, colour schemes and motion follow the AndroidX Compose implementation.

Getting started
flutter pub add material_expressive_ui material_ui
Load the bundled fonts before the first frame and install ExpressiveTheme in the app builder. This example uses MaterialApp from material_ui. A WidgetsApp or CupertinoApp can use the same builder and localization delegates.
import 'package:material_expressive_ui/material_expressive_ui.dart';
import 'package:material_ui/material_ui.dart';
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
await expressiveLoadFonts();
runApp(const App());
}
class App extends StatelessWidget {
const App({super.key});
@override
Widget build(BuildContext context) => MaterialApp(
theme: ThemeData(
pageTransitionsTheme: const PageTransitionsTheme(
builders: expressivePageTransitions,
),
),
localizationsDelegates: const [
DefaultDesignLocalizations.delegate,
ExpressiveLocalizations.delegate,
DefaultMaterialLocalizations.delegate,
DefaultWidgetsLocalizations.delegate,
],
builder: (context, child) => ExpressiveTheme(
data: ExpressiveThemeData.grove(MediaQuery.platformBrightnessOf(context)),
child: child!,
),
home: Builder(
builder: (context) => ColoredBox(
color: context.expressiveTheme.colors.surface,
child: Center(
child: ExpressiveFilledButton('Book a table', onPressed: () {}),
),
),
),
);
}
Themes
Choose a preset with ExpressiveThemeData.preset(id, brightness) or derive a colour scheme with ExpressiveThemeData.from(seed: brand, brightness: brightness). The presets provide light, dark and high-contrast colours. Pass contrastLevel: 1 for a high-contrast preset.
| Preset | Seed | Variant | Motion |
|---|---|---|---|
baseline |
#6750A4 | tonal spot | expressive |
slate |
#52667A | neutral | standard |
bloom |
#B5487A | vibrant | expressive |
grove |
#2E7D5B | tonal spot | expressive |
ember |
#C25A1F | expressive | expressive |
Widgets read their theme from context.expressiveTheme. Use copyWith to set density, typography, shapes, motion or a component theme. An individual widget's style overrides the component theme for that widget. A WidgetStateProperty can vary a colour or shape for focus, selection and other states.
Navigation and localization
Import package:material_expressive_ui/material_expressive_host.dart for ExpressiveHost, adaptive app navigation and page transitions. ExpressiveShellScaffold places destinations in a bottom bar on phones and a rail on wider screens. ExpressivePage, ExpressiveSheetPage and ExpressiveFullScreenDialogPage work with the Navigator pages API.
Use ExpressiveLocalizations for component text and DesignLocalizations for shared actions. Both include English defaults. Supply delegates for your app's other languages. Give icon-only controls a semanticLabel and give the rating a name such as “Rate this trip” so a screen reader can announce its current score in context.
Custom components
To adapt a component, copy its source into your app and import package:material_expressive_ui/material_expressive_parts.dart for its drawing and animation helpers. Check copied components when updating the package because these helpers may change between releases.
Example
The example app includes a Trip planner and an interactive component gallery. Switch between light and dark themes, change text size, or try right-to-left layout from the gallery settings. Run it from the repository with cd example and flutter run.
Licences
The package is BSD-3-Clause. Roboto Flex and Jost use the SIL Open Font License 1.1. Material Symbols Rounded and the AndroidX graphics-shapes port use Apache 2.0. The material_new_shapes port uses the MIT licence. Notices ship in LICENSE and THIRD_PARTY_NOTICES/.
This is an independent implementation of Material 3 Expressive.
Libraries
- material_expressive_host
- Material Expressive's host layer, for an app that shows the look's screens in a shell of its own: the scaffold every
look shares (
package:ui_core/host.dart: its tabs, its main action, its background and insets, the preview frame and platform) and Material Expressive's own part of it. An app that draws its screens frompackage:material_expressive_ui/material_expressive_ui.dartdoes not need this library; the look's own chrome, gallery and tests import it beside that one. - material_expressive_parts
- Helpers for customizing components copied from
material_expressive_ui. - material_expressive_ui
- Material 3 Expressive for Flutter: Material's newest look, ported from Jetpack Compose's material3 1.5.0-alpha29 (its tokens, motion springs, shape library and components). The one import an app needs.