settings_ui

Breaking changes

• Requires Flutter >=3.16.0 and Dart SDK >=3.5.0
• Android and Web themes now derive colors from Theme.of(context).colorScheme (Material 3). Custom color overrides via SettingsThemeData still work.

New features

• compact: bool parameter on SettingsTile — use smaller vertical padding for dense layouts
• crossAxisAlignment parameter on SettingsList
• titleTextStyle, tileTextStyle, tileDescriptionTextStyle, inactiveSwitchColor fields on SettingsThemeData

Bug fixes

• Fixed iOS value text overflow in narrow tiles (#186)
• Fixed RTL chevron direction — now shows back-arrow in right-to-left layouts
• Fixed platform override being ignored on macOS host when platform: android/web was set (#139)
• Fixed web switch ignoring SwitchTheme due to hardcoded fallback color (#188)
• Fixed disabled switch using wrong inactive color on all platforms

Maintenance

• Migrated all constructors to super-parameters (super.key, super.child)
• Replaced deprecated textScaleFactor with MediaQuery.textScalerOf
• Replaced deprecated Switch.activeColor with Switch.activeThumbColor
• Replaced deprecated CupertinoSwitch.activeColor with CupertinoSwitch.activeTrackColor
• Updated CI to actions/checkout@v4, coverage gate raised from 35% → 60%
• Updated example app with Material 3 demo screen

• Enabled parameter for the ListTile widget
• Trailing parameter for the ListTile widget
• Fixed minor bugs

• Cover image was updated

• The whole codebase was refactored
• Bug fixes and stability improvements

• Enable web support
• Round borders for web and iPad settings tiles

• Null safety preview release

• Fixed subtitle for iOS
• Added iosChevron and iosChevronPadding for forward chevron and color in iOS.
• CupertinoSettingsItem toggle on disabled fix
• Content padding implementation

• Ripple effect for Android
• Ability to setup padding and subtitle for sections
• New onPressed(context) parameter for SettingsTile, onTap() is deprecated from now on.

• Custom colors support for SettingsList
• Allow physics and shrinkWrap on SettingsList
• CupertinoSettingsItemButton ripple effect
• Device preview disabled for Flutter Web
• CustomSection implementation (possibility to add your own widget)
• Use Target Platform to determine which Settings UI to show

• Change background color for dark theme in SettingsList with backgroundColor attribute.
• Ability to add trailing widgets to tiles.
• Added enabled attribute to tile.
• Flutter Web support.

• Added onTap color change for cupertino tiles.

• Slight updates.

• Initial release with basic SettingsTile and SettingsTile.switchTile.