Skip to content
Boring Doc
BreakingHigh impactOfficial migration guidesince 3.35.0landed 3.33.0-1.0.pre through 3.35.0-0.0.pre

Component theme normalization updates

Framework · Official source

What changed?

`AppBarTheme`, `BottomAppBarTheme` and `InputDecorationTheme` were refactored to conform to Flutter's conventions for component themes. `AppBarThemeData`, `BottomAppBarThemeData` and `InputDecorationThemeData` were added to define overrides for the defaults of the component visual properties. Releases of Flutter continue to normalize component themes like these for a more consistent theming experience in the material library.

Will this affect my application?

Who is affected
Applications and packages relying on the previous behaviour or signature. Code that uses AppBarTheme, BottomAppBarTheme, InputDecorationTheme and related APIs.
Practical impact
Behaviour or API differences that can break builds or change runtime behaviour.
What action should I take?
Follow the official migration guide below, update affected call sites, run `dart fix --apply` where a fix is available, then run your tests.
APIs mentioned:AppBarThemeBottomAppBarThemeInputDecorationThemeAppBarThemeDataBottomAppBarThemeDataInputDecorationThemeDataThemeDataDatePickerThemeDataTimePickerThemeData

How do I migrate safely?

Before and after (from the official guide)

dart+8−8
Before
1−final AppBarTheme appBarTheme = Theme.of(context).appBarTheme;
2−final AppBarTheme appBarTheme = AppBarTheme.of(context);
3  
4−final BottomAppBarTheme bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
5−final BottomAppBarTheme bottomAppBarTheme = BottomAppBarTheme.of(context);
6  
7−final InputDecorationTheme inputDecorationTheme = Theme.of(context).inputDecorationTheme;
8−final InputDecorationTheme inputDecorationTheme = InputDecorationTheme.of(context);
9−final InputDecorationTheme inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
10−final InputDecorationTheme inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
After
1+final AppBarThemeData appBarTheme = Theme.of(context).appBarTheme;
2+final AppBarThemeData appBarTheme = AppBarTheme.of(context);
3  
4+final BottomAppBarThemeData bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
5+final BottomAppBarThemeData bottomAppBarTheme = BottomAppBarTheme.of(context);
6  
7+final InputDecorationThemeData inputDecorationTheme = Theme.of(context).inputDecorationTheme;
8+final InputDecorationThemeData inputDecorationTheme = InputDecorationTheme.of(context);
9+final InputDecorationThemeData inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
10+final InputDecorationThemeData inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
Raw before / after
final AppBarTheme appBarTheme = Theme.of(context).appBarTheme;
final AppBarTheme appBarTheme = AppBarTheme.of(context);

final BottomAppBarTheme bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
final BottomAppBarTheme bottomAppBarTheme = BottomAppBarTheme.of(context);

final InputDecorationTheme inputDecorationTheme = Theme.of(context).inputDecorationTheme;
final InputDecorationTheme inputDecorationTheme = InputDecorationTheme.of(context);
final InputDecorationTheme inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
final InputDecorationTheme inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
final AppBarThemeData appBarTheme = Theme.of(context).appBarTheme;
final AppBarThemeData appBarTheme = AppBarTheme.of(context);

final BottomAppBarThemeData bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
final BottomAppBarThemeData bottomAppBarTheme = BottomAppBarTheme.of(context);

final InputDecorationThemeData inputDecorationTheme = Theme.of(context).inputDecorationTheme;
final InputDecorationThemeData inputDecorationTheme = InputDecorationTheme.of(context);
final InputDecorationThemeData inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
final InputDecorationThemeData inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
Migration checklist0/3
Official migration guide (excerpt, © The Flutter Authors, CC BY 3.0)

In ThemeData:

  • The type of the appBarTheme property has been changed from AppBarTheme to AppBarThemeData.
  • The type of bottomAppBarTheme property has been changed from BottomAppBarTheme to BottomAppBarThemeData.
  • The type of inputDecorationTheme property has been changed from InputDecorationTheme to InputDecorationThemeData.

The return type of the component theme xTheme.of() methods and Theme.of().xTheme have also changed to xThemeData.

In DatePickerThemeData and TimePickerThemeData, the type of the inputDecorationTheme property has been changed from InputDecorationTheme to InputDecorationThemeData.

Code before migration:

final AppBarTheme appBarTheme = Theme.of(context).appBarTheme;
final AppBarTheme appBarTheme = AppBarTheme.of(context);

final BottomAppBarTheme bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
final BottomAppBarTheme bottomAppBarTheme = BottomAppBarTheme.of(context);

final InputDecorationTheme inputDecorationTheme = Theme.of(context).inputDecorationTheme;
final InputDecorationTheme inputDecorationTheme = InputDecorationTheme.of(context);
final InputDecorationTheme inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
final InputDecorationTheme inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
final ThemeData theme = ThemeData(
  appBarTheme: AppBarTheme(),
  bottomAppBarTheme: BottomAppBarTheme(),
  inputDecorationTheme: InputDecorationTheme(),
);

final ThemeData theme = ThemeData().copyWith(
  appBarTheme: AppBarTheme(),
  bottomAppBarTheme: BottomAppBarTheme(),
  inputDecorationTheme: InputDecorationTheme(),
);

const DatePickerThemeData datePickerTheme = DatePickerThemeData(inputDecorationTheme: InputDecorationTheme());
const TimePickerThemeData timePickerTheme = TimePickerThemeData(inputDecorationTheme: InputDecorationTheme());

Code after migration:

final AppBarThemeData appBarTheme = Theme.of(context).appBarTheme;
final AppBarThemeData appBarTheme = AppBarTheme.of(context);

final BottomAppBarThemeData bottomAppBarTheme = Theme.of(context).bottomAppBarTheme;
final BottomAppBarThemeData bottomAppBarTheme = BottomAppBarTheme.of(context);

final InputDecorationThemeData inputDecorationTheme = Theme.of(context).inputDecorationTheme;
final InputDecorationThemeData inputDecorationTheme = InputDecorationTheme.of(context);
final InputDecorationThemeData inputDecorationTheme = Theme.of(context).datePickerTheme.inputDecorationTheme;
final InputDecorationThemeData inputDecorationTheme = Theme.of(context).timePickerTheme.inputDecorationTheme;
final ThemeData theme = ThemeData(
  appBarTheme: AppBarThemeData(),
  bottomAppBarTheme: BottomAppBarThemeData(),
  inputDecorationTheme: InputDecorationThemeData(),
);

final ThemeData theme = ThemeData().copyWith(
  appBarTheme: AppBarThemeData(),
  bottomAppBarTheme: BottomAppBarThemeData(),
  inputDecorationTheme: InputDecorationThemeData(),
);

const DatePickerThemeData datePickerTheme = DatePickerThemeData(inputDecorationTheme: InputDecorationThemeData());
const TimePickerThemeData timePickerTheme = TimePickerThemeData(inputDecorationTheme: InputDecorationThemeData());
Migration assistantAI-generated · grounded in cited sources
AI explanations are not configured
Set AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.

Evidence & verification

Official migration guide·Verified classification (95%)

Listed in the official breaking-changes index (docs.flutter.dev/release/breaking-changes).

An official announcement or migration guide documents an intended behaviour or API change. A verified source change (git diff) shows code changed but does not by itself prove a public API is breaking. AI interpretations are labelled and never used to classify a change.

Source commit
b3045439b7c0
Source last updated
Oct 21, 2026
Last synchronized
Oct 21, 2026
Publication status
published
Publication history
  • Oct 21, 2026, 8:31 PM: new → published (ingestion) — Backed by an official breaking-change/migration guide.
AI explanationAI-generated · grounded in cited sources
AI explanations are not configured
Set AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.
Was this useful?