flex_color_scheme 1.1.1

A Flutter package to make and use beautiful color scheme based MaterialApp themes.

Changelog

All notable changes to the FlexColorScheme package will be documented in this file.

[1.1.1] - December 31, 2020

• Updated example 5 to include UI that can be used to vary the computed dark themes white blend percentage level. This was added to better demonstrate the toDark feature.
• Added a defaultError fix/modifier that enables the built-in schemes to use the Material design guide's default dark error color when using the toDark method to compute a dark scheme from a light scheme, that already defines a light scheme error color. The toDark method can be used without the defaultError scheme modifier as well, but then the dark error color also change with the other computed dark scheme colors when using the "Compute dark theme" feature and the level adjustment. This is not necessarily the desired behavior. The fix enables the alternative more often desired behavior and ensures that the dark error color just uses the default value. For custom schemes that do not specify a custom error color for their light scheme and thus default to the Material Guide's standard error color, the fix is not needed. Example 5 demonstrates the use case of defaultError as well.
• Major documentation review and updates.

[1.1.0] - December 29, 2020

• Added API to make a matching dark scheme from a light scheme. See FlexSchemeColor.toDark.
• Added a showSystemMode property to FlexThemeModeSwitch. It defaults to true. Set it to false, to exclude the system setting based theme mode option.
• Added static method FlexColorScheme.comfortablePlatformDensity.
• Added static method FlexColorScheme.themedSystemNavigationBar that can be used to assist with theming the system navigation bar via an annotated region. See updated example 5, for a demo on how to use it.
• Added API property FlexColorScheme.transparentStatusBar to allow opting out of the one-toned AppBar in Android.
• Updated the examples.
  • All examples now use the new platform adaptive FlexColorScheme.comfortablePlatformDensity as their visualDensity setting. The Flutter default compact mode for desktop and web goes a bit overboard in its compactness. This optional setting presents an alternative where comfortable density is used on desktops and Web, while devices keep their standard visual density. Just omit the setting if you prefer Flutter's super compact Web and Desktop widgets.
  • Example 3 excludes the system theme mode option, just to show this new feature of the switch.
  • Example 4 includes all built-in schemes, plus 3 custom ones, including one where the dark scheme is made with the toDark method. Example 4 also includes a sub-page that can be opened to see the same theme on a new page.
  • Example 5 now includes an option make all the dark mode schemes with the toDark option, so it can be toggled and compared to the hand-tuned versions. The same custom color scheme as in example 4 are also included. Example 5 also has the same sub-page as example 4. Example 5 now also show how to solve the issue that the system navigation bar does not get color scheme and theme mode appropriate system navigation bar style in Android as we change the color scheme and theme mode. This is done with an AnnotatedRegion and the new helper method FlexColorScheme.themedSystemNavigationBar.
• Documentation updates and typo corrections.

[1.0.0] - December 21, 2020

• Version 1.0.0 released
• Documentation layout updates and typo corrections.

[1.0.0-dev.2] - December 21, 2020

• Made planned API name changes, SchemeOnColors -> FlexSchemeOnColors and SchemeSurfaceColors -> FlexSchemeSurfaceColors. These are lower level APIs that are only used when making custom on and surface colors. Changed ThemeModeOptionButton -> FlexThemeModeOptionButton, this is also a lower level API that can be used when making more advanced custom theme selection control that are based on the same button as the FlexThemeModeSwitch uses.
• Exposed planned configuration APIs for the FlexThemeModeSwitch and FlexThemeModeOptionButton.
• Removed the constants that had no function in the public interface from the API.
• Documentation updates and corrections.
• Removed legacy usage of deprecated ThemeData properties textSelectionColor, cursorColor and textSelectionHandleColor. They are no longer needed even for stable channel, they were useful earlier but not anymore, using only TextSelectionThemeData is enough in the latest stable version.

[1.0.0-dev.1] - December 17, 2020

• First development pre-release on pub.dev.

---

To do list and planned feature updates

• ✅ Release first version 1.0.0-dev.1 publicly on GitHub and pub.dev.
• ✅ Complete the documentation.
• ✅ Publish live Web versions of the five examples.
• ✅ Review and update the API.
• ✅ Review and correct documentation mistakes and typos, first pass anyway.
• ✅ Release version 1.0.0 on pub.dev.
• ✅ Add API the can create the dark scheme based on a light scheme's colors.
• ✅ Add API that allows us to use an additional extra color definition for ThemeData.accentColor to easily make themes with custom input border color in dark-mode.
• ✅ API to opt-out from one-toned AppBar and return it to Android's default two-toned.
• ✅ API to assist with themed annotated region for system navigation bar theming.
• ❌ Change the current "white" AppBarTheme implementation to new AppBarTheme when it lands in stable channel. See https://github.com/flutter/flutter/pull/71184 and https://github.com/flutter/flutter/issues/72206.
• ❌ Version 1.1.x: Add tests and fine tune the docs.
• ❌ Version 2.0.0-nullsafety.1: Add null safe version.