flex_color_scheme 1.2.0

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.2.0] - January 4, 2021

• Added four new built-in color schemes.

  • Amber blue - Amber blaze and blue color theme, based on Material amber and blue accent colors. Use enum value FlexScheme.amber for easy access to it.
  • Vesuvius burned - Vesuvius burned orange and eden green theme. Use enum value FlexScheme.vesuviusBurn for easy access to it.
  • Deep purple - Deep purple daisy bush theme, based on Material deepPurple and lightBlueAccent colors. Use enum value FlexScheme.deepPurple for easy access to it.
  • Ebony clay - Ebony clay dark blue-grey and watercourse green colored theme. Use enum value FlexScheme.ebonyClay for easy access to it.

• Added a style option for the tab bar. The FlexColorScheme created tab bar theme now defaults to a TabBarTheme that fits its created AppBarTheme, also works via the factory app bar style options. There is also an optional style that makes the tab bar theme suitable for surface and background colors. This was the default style before. The change to this default style is a fix to make the default TabBarTheme one that fits on app bar's instead, which is expected default behavior in Flutter and Material design. The style is set via the FlexColorScheme property tabBarStyle using enum values FlexTabBarStyle.forAppBar (default) and FlexTabBarStyle.forBackground.

• The themed AppBar and BottomAppBar elevations still default to 0. However, and for convenience, the themed values can now both be modified directly via the FlexColorScheme properties appBarElevation and bottomAppBarElevation, without need to change these frequently modified values with an extra copyWith to get them re-themed as desired. When using the recommended FlexColorScheme.light and FlexColorScheme.dark factories, appBarElevation defaults to '0', if not defined and bottomAppBarElevation defaults to appBarElevation, if not defined. When using the default constructor (the factories are recommended), they both default to '0'.

Example updates

• All examples: The widget showcase now show the resulting themed tab bar on two different backgrounds, one on the app bar color and one on background color. This can guide you in which tab bar style is right for your use case.
• Example 4 and 5: The sub-page now has a demo tab bar in the app bar, and a demo bottom navigation bar.
• Example 5: Now includes a toggle that can be used to select the tab bar theme style.
• Example 5: Now includes a slider to modify the themed app bar elevation.
• Example 5: Fixed so that the Roboto font, that is always used by the examples regardless of platform, now also gets used when you toggle to create the theme from the scheme with the ThemeData.from(colorScheme). It looked a bit ood when it changed to platform default font on Desktop and Web versions, and FlexColorScheme.toTheme used Roboto. This was modified so that the resulting themes use the same font and are comparable.

[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.2.x: Add tests and fine tune the docs.
• Version 2.0.0-nullsafety.1: Add null safe version.