Viewing version 1.6.0. Open the latest package page.

material_ui

1.6.0

The official Flutter Material UI Library, implementing Google's Material Design design system.

Readme

material_ui

The official Flutter Material Design library, implementing Google's Material Design design system for Flutter applications.

material_ui provides a complete, modern suite of visual components, motion, typography, color system, and theming tools to build beautiful and accessible user interfaces on all screen sizes.

See also the cupertino_ui package, which is Flutter's official iOS- and macOS-style design library.

New to the package?

Install the package with the following command:

flutter add material_ui

See Flutter's main getting started guide for information about using Flutter and material_ui.

Migrating existing code to this package

The standalone material_ui package was previously built directly into the core Flutter framework as package:flutter/material.dart. It has been decoupled from the flutter/flutter repository into its new home here in flutter/packages.

Follow the steps below to migrate:

Step 1: Migrate imports

We've included a data driven Dart fix to help users migrate. Simply run the following command:

dart fix --apply --code=migrate_design_widgets

This performs the equivalent of adding material_ui to your project and changing imports of package:flutter/material.dart to package:material_ui/material_ui.dart.

Step 2: Migrate localizations (if needed)

If you are not currently using the GlobalMaterialLocalizations or GlobalCupertinoLocalizations classes from flutter/flutter's flutter_localizations package, then you are already good to go. For those that do need to migrate off of these classes, simply use the new versions of these classes from material_ui and cupertino_ui, respectively.

A typical app can use the following localization delegate from material_ui to cover all of the localization strings in Flutter, Material, and Cupertino:

  localizationsDelegates: GlobalMaterialLocalizations.delegates,

Step 3: Bridge legacy dependencies (if needed)

If your app uses third-party packages or subtrees that still import and rely on package:flutter/material.dart, use MaterialUiCompatibilityBridge to bridge ThemeData and MaterialLocalizations so legacy widgets resolve correctly within modern widget trees.

Wrap your app using MaterialApp.builder:

import 'package:material_ui/material_ui.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: (BuildContext context, Widget? child) {
        return MaterialUiCompatibilityBridge(child: child!);
      },
      home: const HomeScreen(),
    );
  }
}

You can also wrap individual subtrees that contain legacy package widgets:

Scaffold(
  appBar: AppBar(title: const Text('Modern Screen')),
  body: MaterialUiCompatibilityBridge(
    child: LegacyPackageWidget(),
  ),
)

Features

The material_ui package contains everything you need to create a fully-featured Material app, such as:

App Structure & Navigation: MaterialApp, Scaffold, AppBar, NavigationBar, BottomSheet, TabBar, SearchAnchor, SearchBar, Dialog
Buttons & Interaction: ElevatedButton, TextButton, IconButton, FloatingActionButton, SegmentedButton, InkWell, MenuBar
Inputs & Selection: TextField, Checkbox, Radio, Switch, Slider, DropdownMenu, DatePicker, TimePicker
Display & Feedback: Card, Chip, ListTile, Badge, Divider, ProgressIndicator, SnackBar, Tooltip, CarouselView, VerticalDivider
Theming & Color: ThemeData, ColorScheme, TextTheme, dynamic color generation, Material 3 design tokens, typography, and motion easing curves
Internationalization: MaterialLocalizations and GlobalMaterialLocalizations for multi-locale support

Changelog

See the Changelog for a list of new features and breaking changes.

Documentation & Resources

Changelog

1.6.0

Documents that TextField.decoration is merged with the ambient InputDecorationTheme rather than replacing it.
Fixes unresolved doc comment references.
Fixes NavigationIndicator not repainting when the selected destination changes without pointer interaction.
Removes the unconditional dart:io import from AboutDialog, so that material_ui is correctly detected as supporting the web platform and showAboutDialog no longer throws on the web when no application name is available.
Fix DropdownButtonFormField underline alignment at bottom.
Fixes floating-point rounding errors when calculating values for discrete Slider and RangeSlider.
Added fontFeatures and fontVariations parameters to TextTheme.apply().

1.5.0

Adds Material 3 Expressive support for IconButton.
Exposes selected state on Autocomplete option semantics.
Wraps DrawerHeader in Semantics(header: true).
Adds ignorePointer to TooltipThemeData for WCAG 1.4.13 Hoverable support.
Fixes decorations on MenuItemButton.leadingIcon, such as Badge, being clipped to the icon's bounds in vertically expanding menus.
Introduces labelTextDirection property to InputDecoration.
Adds support for standard, medium, and high contrast Material 3 color scheme baselines.
Fixes LocalHistoryEntry leak when double tapping Drawer scrim

1.4.0

Updates minimum supported SDK version to Flutter 3.47/Dart 3.13.
Adds sortIconBuilder parameter to DataTable, PaginatedDataTable, and DataTableThemeData for custom sorting indicators.
Fix PopupMenuButton not announcing button semantics (enabled state, expanded state) when built with a child instead of the default icon.
Fixes DatePickerThemeData.todayBorder color being overridden by todayForegroundColor in the year selector.
Adds an alternative keyboard input method for RangeSlider in NavigationMode.directional.

1.3.0

Adds @awaitNotRequired annotations to asynchronous functions that do not need to be awaited.
Adds an option for MaterialPageRoute and MaterialPage to opt out of introducing a semantics route scope.
Fixes SliverGeometry maxPaintExtent assertion in CarouselView.weighted
Corrects the Material 3 default style documentation for FilledButton to match its implementation.
Adds support for customizing date input formatters via CalendarDelegate.keyboardInputFormatters, allowing custom date input behavior in the Material date picker.
Adds a semanticLabel to MenuAnchor for the expanded menu overlay.

1.2.0

Adds the StyleVariant enum defining the Material 3 and Material 3 Expressive style variants.

1.1.1

Constrains Slider and RangeSlider value indicator labels to the screen width, truncating with an ellipsis instead of clipping.
Prevents stale asynchronous suggestions from replacing newer SearchAnchor results.
Fix RangeSlider thumb overlay remaining visible after touch interaction

1.1.0

Add missing Widget of the Week videos to widget API docs.
Exposes ink_sparkle shader asset in pubspec.yaml and removes stretch_effect shader.
Fix Typo in Readme
Fixes typos in library code and tests.
SearchAnchor overlay expands to full-screen on viewport size change (e.g., on device rotation).
Fixes https://github.com/flutter/flutter/issues/186154.

1.0.1

Updates cupertino_ui dependency constraint to ^1.0.0.

1.0.0

README updated for the full release of material_ui.
Promotes the pre-release to 1.0.0.

0.0.3+1

Replace unresolvable doc imports
Added a main.dart example for the Pub "Example" tab that reference a curated list of existing examples.

0.0.3

Fix API doc by clearing unsupported directives introduced by macros.
Fix API doc references.
Adds MaterialUiCompatibilityBridge for legacy flutter/material.dart compatibility.

0.0.2

Copies over all Material code from flutter/flutter.
Copies over Material localizations from flutter/flutter's flutter_localizations package.
Unpins material_color_utilities.
Migrates API doc samples and formatting.
Updates minimum supported SDK version to Flutter 3.44/Dart 3.12.

0.0.1

Initial setup of the material_ui package, preparing for decoupling Material widgets from the Flutter framework.

Installing

export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com
flutter pub add 'material_ui:1.6.0'

pubspec.yaml

name: material_ui
description: The official Flutter Material UI Library, implementing Google's Material Design design system.
version: 1.6.0
repository: https://github.com/flutter/packages/tree/main/packages/material_ui
issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A%20material_ui%22

environment:
  sdk: ^3.13.0
  flutter: ">=3.47.0"

dependencies:
  collection: ^1.19.1
  cupertino_ui: ^1.0.0
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: ^0.20.2
  material_color_utilities: ^0.13.0
  vector_math: ^2.2.0

dev_dependencies:
  args: ^2.7.0
  file: ^7.0.1
  flutter_goldens:
    path: ../../script/flutter_goldens
  flutter_test:
    sdk: flutter
  # To track memory leaks.
  leak_tracker_flutter_testing: ^3.0.10
  meta: ^1.18.0
  path: ^1.9.1
  platform: ^3.1.6

flutter:
  shaders:
    - packages/material_ui/shaders/ink_sparkle.frag

topics:
  - ui
  - widgets
  - material

Version history

Version	Published	Archive	SHA-256
0.0.1	2026-02-18Cached · Upstream SHA-256 matched	Download	`47b4acbb…e26063`
0.0.2	2026-07-22Cached · Upstream SHA-256 matched	Download	`e1fa6739…fe31cf`
0.0.3	2026-08-03Cached · Upstream SHA-256 matched	Download	`849f45c2…65ce17`
0.0.3+1	2026-08-11Cached · Upstream SHA-256 matched	Download	`ba53669b…c71a94`
1.0.0	2026-08-12Cached · Upstream SHA-256 matched	Download	`d9b4f6c6…23995f`
1.0.1	2026-08-19Cached · Upstream SHA-256 matched	Download	`4f3f38b9…e4683b`
1.1.0	2026-08-24Cached · Upstream SHA-256 matched	Download	`7ba1ca31…03110c`
1.1.1	2026-09-02Cached · Upstream SHA-256 matched	Download	`9c0156b0…fb7101`
1.2.0	2026-09-08Cached · Upstream SHA-256 matched	Download	`fbfb53ca…80ec45`
1.3.0	2026-09-15Cached · Upstream SHA-256 matched	Download	`6d056d60…abc7e2`
1.4.0	2026-09-22Cached · Upstream SHA-256 matched	Download	`134ab2f0…0411e9`
1.5.0	2026-09-28Cached · Upstream SHA-256 matched	Download	`32d98f11…2e23d2`
1.6.0	2026-10-06Cached · Upstream SHA-256 matched	Download	`98ab9eda…814695`
1.7.0	2026-10-14Cached · Upstream SHA-256 matched	Download	`27ea1af2…839060`
1.8.0	2026-10-20Cached · Upstream SHA-256 matched	Download	`e4031746…90b4ab`
1.9.0	2026-10-29Cached · Upstream SHA-256 matched	Download	`feb289df…d25196`

Dependencies

collection "^1.19.1"

cupertino_ui "^1.0.0"

flutter { "sdk": "flutter" }

flutter_localizations { "sdk": "flutter" }

intl "^0.20.2"

material_color_utilities "^0.13.0"

vector_math "^2.2.0"

Selected archive

1.6.0

98ab9eda579ecae623e4b376c603035c5def78ce706f735f30bd632af5814695

Cached · Upstream SHA-256 matched

16 published versions