Theme

Customizes the overall appearance of the application.

Properties

• appbar_theme - Customizes the appearance of descendant AppBar controls.
• badge_theme - Customizes the appearance of descendant Badge controls.
• banner_theme - Customizes the appearance of descendant Banner controls.
• bottom_appbar_theme - Customizes the appearance of descendant BottomAppBar controls.
• bottom_sheet_theme - Customizes the appearance of descendant BottomSheet controls.
• button_theme - Customizes the appearance of descendant Button controls.
• canvas_color - The default color for canvas surfaces behind Material controls.
• card_bgcolor - The default background color for Card controls.
• card_theme - Customizes the appearance of descendant Card controls.
• checkbox_theme - Customizes the appearance of descendant Checkbox controls.
• chip_theme - Customizes the appearance of descendant Chip controls.
• color_scheme - Overrides the default ColorScheme used for the application.
• color_scheme_seed - Overrides the default color scheme seed used to generate ColorScheme.
• data_table_theme - Customizes the appearance of descendant DataTable controls.
• date_picker_theme - Customizes the appearance of descendant DatePicker controls.
• dialog_theme - Customizes the appearance of descendant AlertDialog controls.
• disabled_color - The color used for disabled controls and text.
• divider_color - Overrides the default color of dividers used in Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.
• divider_theme - Defines the visual properties of Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.
• dropdown_theme - Customizes the appearance of descendant Dropdown controls.
• expansion_tile_theme - Customizes the appearance of descendant ExpansionTile controls.
• filled_button_theme - Customizes the appearance of descendant FilledButton controls.
• floating_action_button_theme - Customizes the appearance of descendant FloatingActionButton controls.
• focus_color - The color used to indicate that a control has input focus.
• font_family - Overrides a default font for the app.
• highlight_color - The highlight color used during ink splash animations or to indicate a selected menu item.
• hint_color - The color used for hint or placeholder text, for example in TextField controls.
• hover_color - The color used to indicate that a pointer is hovering over a control.
• icon_button_theme - Customizes the appearance of descendant IconButton controls.
• icon_theme - Customizes the appearance of descendant Icon controls.
• input_decoration_theme - Customizes the decoration (border, label, hint, padding, fill) of descendant TextField and Dropdown controls.
• list_tile_theme - Customizes the appearance of descendant ListTile controls.
• markdown_theme - The default style sheet of descendant Markdown controls.
• material_tap_target_size - The size of the tappable area of descendant Material controls (switches, checkboxes, radios, buttons, ...).
• navigation_bar_theme - Customizes the appearance of descendant NavigationBar controls.
• navigation_drawer_theme - Customizes the appearance of descendant NavigationDrawer controls.
• navigation_rail_theme - Customizes the appearance of descendant NavigationRail controls.
• outlined_button_theme - Customizes the appearance of descendant OutlinedButton controls.
• page_transitions - Configures the default page transition presets used for route changes.
• popup_menu_theme - Customizes the appearance of descendant PopupMenuButton controls.
• primary_text_theme - A text theme that contrasts with the theme's primary color.
• progress_indicator_theme - Customizes the appearance of descendant ProgressBar and ProgressRing controls.
• radio_theme - Customizes the appearance of descendant Radio controls.
• scaffold_bgcolor - The default background color for scaffold-like page surfaces.
• scrollbar_theme - Customizes the appearance of descendant scrollbars.
• search_bar_theme - Customizes the appearance of descendant SearchBar controls.
• search_view_theme - Customizes the appearance of the search view presented by SearchBar.
• secondary_header_color - The color used for secondary headers, such as the header of a paginated data table when rows are selected.
• segmented_button_theme - Customizes the appearance of descendant SegmentedButton controls.
• slider_theme - Customizes the appearance of descendant Slider and RangeSlider controls.
• snackbar_theme - Customizes the appearance of descendant SnackBar controls.
• splash_color - The color of ink splashes.
• surfaces - How surface colors are derived from color_scheme_seed.
• switch_theme - Customizes the appearance of descendant Switch controls.
• system_overlay_style - Customizes the appearance of the system status bar and navigation bar on mobile platforms.
• tab_bar_theme - Customizes the appearance of descendant TabBar controls.
• text_button_theme - Customizes the appearance of descendant TextButton controls.
• text_field_theme - Customizes descendant TextField controls.
• text_theme - The default text styles for descendant controls.
• time_picker_theme - Customizes the appearance of descendant TimePicker controls.
• tooltip_theme - Customizes the appearance of descendant tooltips.
• unselected_control_color - The color used for controls in their inactive but enabled state, such as an unchecked Checkbox.
• use_material3 - A temporary flag that can be used to opt-out of Material 3 features.
• visual_density - Specifies how compact descendant Material controls should be.

Properties

buildappbar_themeclass-attributeinstance-attribute

appbar_theme: AppBarTheme | None = None

Customizes the appearance of descendant AppBar controls.

buildbadge_themeclass-attributeinstance-attribute

badge_theme: BadgeTheme | None = None

Customizes the appearance of descendant Badge controls.

buildbanner_themeclass-attributeinstance-attribute

banner_theme: BannerTheme | None = None

Customizes the appearance of descendant Banner controls.

buildbottom_appbar_themeclass-attributeinstance-attribute

bottom_appbar_theme: BottomAppBarTheme | None = None

Customizes the appearance of descendant BottomAppBar controls.

buildbottom_sheet_themeclass-attributeinstance-attribute

bottom_sheet_theme: BottomSheetTheme | None = None

Customizes the appearance of descendant BottomSheet controls.

buildbutton_themeclass-attributeinstance-attribute

button_theme: ButtonTheme | None = None

Customizes the appearance of descendant Button controls.

buildcanvas_colorclass-attributeinstance-attribute

canvas_color: ColorValue | None = None

The default color for canvas surfaces behind Material controls.

buildcard_bgcolorclass-attributeinstance-attribute

card_bgcolor: ColorValue | None = None

The default background color for Card controls.

buildcard_themeclass-attributeinstance-attribute

card_theme: CardTheme | None = None

Customizes the appearance of descendant Card controls.

buildcheckbox_themeclass-attributeinstance-attribute

checkbox_theme: CheckboxTheme | None = None

Customizes the appearance of descendant Checkbox controls.

buildchip_themeclass-attributeinstance-attribute

chip_theme: ChipTheme | None = None

Customizes the appearance of descendant Chip controls.

buildcolor_schemeclass-attributeinstance-attribute

color_scheme: ColorScheme | None = None

Overrides the default ColorScheme used for the application.

buildcolor_scheme_seedclass-attributeinstance-attribute

color_scheme_seed: ColorValue | None = None

Overrides the default color scheme seed used to generate ColorScheme. The default color is blue.

The seed drives accent colors. Surfaces are neutral unless surfaces is set to TONAL.

builddata_table_themeclass-attributeinstance-attribute

data_table_theme: DataTableTheme | None = None

Customizes the appearance of descendant DataTable controls.

builddate_picker_themeclass-attributeinstance-attribute

date_picker_theme: DatePickerTheme | None = None

Customizes the appearance of descendant DatePicker controls.

builddialog_themeclass-attributeinstance-attribute

dialog_theme: DialogTheme | None = None

Customizes the appearance of descendant AlertDialog controls.

builddisabled_colorclass-attributeinstance-attribute

disabled_color: ColorValue | None = None

The color used for disabled controls and text.

builddivider_colorclass-attributeinstance-attribute

divider_color: ColorValue | None = None

Overrides the default color of dividers used in Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.

builddivider_themeclass-attributeinstance-attribute

divider_theme: DividerTheme | None = None

Defines the visual properties of Divider, VerticalDivider, dividers between ListTiles, and dividers between rows in DataTable.

builddropdown_themeclass-attributeinstance-attribute

dropdown_theme: DropdownTheme | None = None

Customizes the appearance of descendant Dropdown controls.

buildexpansion_tile_themeclass-attributeinstance-attribute

expansion_tile_theme: ExpansionTileTheme | None = None

Customizes the appearance of descendant ExpansionTile controls.

buildfilled_button_themeclass-attributeinstance-attribute

filled_button_theme: FilledButtonTheme | None = None

Customizes the appearance of descendant FilledButton controls.

buildfloating_action_button_themeclass-attributeinstance-attribute

floating_action_button_theme: (
    FloatingActionButtonTheme | None
) = None

Customizes the appearance of descendant FloatingActionButton controls.

buildfocus_colorclass-attributeinstance-attribute

focus_color: ColorValue | None = None

The color used to indicate that a control has input focus.

buildfont_familyclass-attributeinstance-attribute

font_family: str | None = None

Overrides a default font for the app.

buildhighlight_colorclass-attributeinstance-attribute

highlight_color: ColorValue | None = None

The highlight color used during ink splash animations or to indicate a selected menu item.

buildhint_colorclass-attributeinstance-attribute

hint_color: ColorValue | None = None

The color used for hint or placeholder text, for example in TextField controls.

buildhover_colorclass-attributeinstance-attribute

hover_color: ColorValue | None = None

The color used to indicate that a pointer is hovering over a control.

buildicon_button_themeclass-attributeinstance-attribute

icon_button_theme: IconButtonTheme | None = None

Customizes the appearance of descendant IconButton controls.

buildicon_themeclass-attributeinstance-attribute

icon_theme: IconTheme | None = None

Customizes the appearance of descendant Icon controls.

buildinput_decoration_themeclass-attributeinstance-attribute

input_decoration_theme: InputDecorationTheme | None = None

Customizes the decoration (border, label, hint, padding, fill) of descendant TextField and Dropdown controls.

buildlist_tile_themeclass-attributeinstance-attribute

list_tile_theme: ListTileTheme | None = None

Customizes the appearance of descendant ListTile controls.

buildmarkdown_themeclass-attributeinstance-attribute

markdown_theme: MarkdownStyleSheet | None = None

The default style sheet of descendant Markdown controls.

A control's own md_style_sheet is applied on top of it, property by property. Unset properties fall back to defaults derived from the theme - links in the color scheme's primary, for example.

buildmaterial_tap_target_sizeclass-attributeinstance-attribute

material_tap_target_size: MaterialTapTargetSize | None = (
    None
)

The size of the tappable area of descendant Material controls (switches, checkboxes, radios, buttons, ...). SHRINK_WRAP drops the 48px minimum for dense, pointer-driven layouts. See MaterialTapTargetSize.

buildnavigation_bar_themeclass-attributeinstance-attribute

navigation_bar_theme: NavigationBarTheme | None = None

Customizes the appearance of descendant NavigationBar controls.

buildnavigation_drawer_themeclass-attributeinstance-attribute

navigation_drawer_theme: NavigationDrawerTheme | None = None

Customizes the appearance of descendant NavigationDrawer controls.

buildnavigation_rail_themeclass-attributeinstance-attribute

navigation_rail_theme: NavigationRailTheme | None = None

Customizes the appearance of descendant NavigationRail controls.

buildoutlined_button_themeclass-attributeinstance-attribute

outlined_button_theme: OutlinedButtonTheme | None = None

Customizes the appearance of descendant OutlinedButton controls.

buildpage_transitionsclass-attributeinstance-attribute

page_transitions: PageTransitionsTheme = field(
    default_factory=PageTransitionsTheme
)

Configures the default page transition presets used for route changes.

buildpopup_menu_themeclass-attributeinstance-attribute

popup_menu_theme: PopupMenuTheme | None = None

Customizes the appearance of descendant PopupMenuButton controls.

buildprimary_text_themeclass-attributeinstance-attribute

primary_text_theme: TextTheme | None = None

A text theme that contrasts with the theme's primary color.

buildprogress_indicator_themeclass-attributeinstance-attribute

progress_indicator_theme: ProgressIndicatorTheme | None = (
    None
)

Customizes the appearance of descendant ProgressBar and ProgressRing controls.

buildradio_themeclass-attributeinstance-attribute

radio_theme: RadioTheme | None = None

Customizes the appearance of descendant Radio controls.

buildscaffold_bgcolorclass-attributeinstance-attribute

scaffold_bgcolor: ColorValue | None = None

The default background color for scaffold-like page surfaces.

buildscrollbar_themeclass-attributeinstance-attribute

scrollbar_theme: ScrollbarTheme | None = None

Customizes the appearance of descendant scrollbars.

buildsearch_bar_themeclass-attributeinstance-attribute

search_bar_theme: SearchBarTheme | None = None

Customizes the appearance of descendant SearchBar controls.

buildsearch_view_themeclass-attributeinstance-attribute

search_view_theme: SearchViewTheme | None = None

Customizes the appearance of the search view presented by SearchBar.

buildsecondary_header_colorclass-attributeinstance-attribute

secondary_header_color: ColorValue | None = None

The color used for secondary headers, such as the header of a paginated data table when rows are selected.

buildsegmented_button_themeclass-attributeinstance-attribute

segmented_button_theme: SegmentedButtonTheme | None = None

Customizes the appearance of descendant SegmentedButton controls.

buildslider_themeclass-attributeinstance-attribute

slider_theme: SliderTheme | None = None

Customizes the appearance of descendant Slider and RangeSlider controls.

buildsnackbar_themeclass-attributeinstance-attribute

snackbar_theme: SnackBarTheme | None = None

Customizes the appearance of descendant SnackBar controls.

buildsplash_colorclass-attributeinstance-attribute

splash_color: ColorValue | None = None

The color of ink splashes.

buildsurfacesclass-attributeinstance-attribute

surfaces: ThemeSurfaces | None = None

How surface colors are derived from color_scheme_seed.

Defaults to NEUTRAL if None. Set it to TONAL for seed-tinted Material 3 surfaces.

buildswitch_themeclass-attributeinstance-attribute

switch_theme: SwitchTheme | None = None

Customizes the appearance of descendant Switch controls.

buildsystem_overlay_styleclass-attributeinstance-attribute

system_overlay_style: SystemOverlayStyle | None = None

Customizes the appearance of the system status bar and navigation bar on mobile platforms.

buildtab_bar_themeclass-attributeinstance-attribute

tab_bar_theme: TabBarTheme | None = None

Customizes the appearance of descendant TabBar controls.

buildtext_button_themeclass-attributeinstance-attribute

text_button_theme: TextButtonTheme | None = None

Customizes the appearance of descendant TextButton controls.

buildtext_field_themeclass-attributeinstance-attribute

text_field_theme: TextFieldTheme | None = None

Customizes descendant TextField controls.

buildtext_themeclass-attributeinstance-attribute

text_theme: TextTheme | None = None

The default text styles for descendant controls.

buildtime_picker_themeclass-attributeinstance-attribute

time_picker_theme: TimePickerTheme | None = None

Customizes the appearance of descendant TimePicker controls.

buildtooltip_themeclass-attributeinstance-attribute

tooltip_theme: TooltipTheme | None = None

Customizes the appearance of descendant tooltips.

buildunselected_control_colorclass-attributeinstance-attribute

unselected_control_color: ColorValue | None = None

The color used for controls in their inactive but enabled state, such as an unchecked Checkbox.

builduse_material3class-attributeinstance-attribute

use_material3: bool | None = None

A temporary flag that can be used to opt-out of Material 3 features.

buildvisual_densityclass-attributeinstance-attribute

visual_density: VisualDensity | None = None

Specifies how compact descendant Material controls should be.

Negative density values make supported controls denser and more compact, while positive values make them more spacious. See VisualDensity.