CHANGELOG.md

[3.0.0] - [April 10, 2026]

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

[2.0.3] - [June 13, 2022]

• Updated documentation
• Fixed display of web support on pub.dev
• Fixed scrollbar on wide screens
• Fixed 'trailing' when used 'SettingsTile.switchTile'
• Fixed color scheme on web version
• Fixed default vertical padding on web version

[2.0.2] - [January 24, 2022]

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

[2.0.1] - [January 9, 2022]

• Cover image was updated

[2.0.0] - [Now 30, 2021]

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

[1.0.1] - [Jul 28, 2021]

• Allow manual platform style selection
• Fixed iOS Title text getting cut off in version 1.0.0
• CustomTile implemented
• Implement titleWidget and subtitleWidget parameters
• Implement the native behaviour for the iOS switch tile

[1.0.0-nullsafety.3] - [April 6, 2021]

• Dropped use of 'dart:io'
• Use Theme.of(context) to detect platform
• Fixed a bug with long subtitles in iOS

[1.0.0-nullsafety.2] - [February 26, 2021]

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

[1.0.0-nullsafety.1] - [February 26, 2021]

• Null safety preview release

[0.7.0] - [February 26, 2021]

• Fixed double trailing on iOS devices
• Support for MacOS
• Fixed padding in the project example

[0.6.0] - [February 10, 2021]

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

[0.5.0] - [December 4, 2020]

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

[0.4.0] - [August 21, 2020]

• 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

[0.3.0] - [May 19, 2020]

• 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.

[0.2.0] - [December 6, 2019]

• Added onTap color change for cupertino tiles.

[0.1.1] - [December 4, 2019]

• Slight updates.

[0.1.0] - [December 4, 2019]

• Initial release with basic SettingsTile and SettingsTile.switchTile.