Home Flexfold ColorScheme ColorPicker
Talo Grid Issues Blog


FlexColorScheme helps you make beautiful color scheme based Flutter themes, using optional color branded surfaces. The created themes are based on the same concept as Flutter’s ColorScheme based themes, but with a few interesting twists and additional features.

FlexColorScheme is available on pub.dev as a Flutter package.

ColorScheme Intro


When you make and design Flutter applications you should base the colors your application use on a light theme mode ColorScheme and a dark theme mode ColorScheme. Then make your light and dark ThemeData from these color schemes. In your MaterialApp then use these themes for the light and dark theme-mode. This gives you an application that uses the defined ColorScheme based colors on all the built-in Material UI Widgets, well on most of them anyway. Flutter’s ThemeData.from a ColorScheme factory has a few gaps, the defined color scheme is not consistently applied to all standard built in Widgets.

Your custom themes and custom widgets should also use the colors in the inherited ThemeData via its colorScheme property, so that your app gets a consistent design, can animate its theme color changes, and can be easily maintained when you need to change the look of your application.

FlexColorScheme was born when I was trying to make pretty themes for the Flexfold demo app and for some other projects as well. I needed a way to make it easier to make pretty surface color branded themes, that work well for Web and desktop apps.

I also wanted to address the ColorScheme based theming gaps in Flutter’s default ColorScheme based ThemeData creation, since I found myself fixing it in pretty much every app. Additionally, I wanted to make it easy to build and support interactive in-application theming. This is actually is pretty easy to do already with the basic SDK, but FlexColorScheme makes it even easier to switch among many themes, and vary a few other custom theme preference settings as well.

Live Web Versions of the FlexColorScheme Examples

The FlexColorScheme package documentation contains five usage examples, they are also available as Live Web demos. The examples start with a really simple use case and increase in complexity with each example. The last example, number 5, does almost everything that you might have seen before in the Flexfold demo web app on its Theme page.

In example 1 we just use a built-in scheme as our application’s theme and toggle between its light and dark variant, or allow the device theme-mode to control if the dark or light theme is used.

ColorScheme example 1 lightColorScheme example 1 dark

Example 2 is a lot like the previous example, but we use our own custom defined colors to make a scheme and turn it into a theme. In this case I used a bit more dignified looking dark purple and deep green colors.

ColorScheme example 2 lightColorScheme example 2 dark

With example 3 we are getting a bit fancier, we can now switch active theme between 3 different predefined color schemes, plus the custom one we made in the previous example. Since previous color scheme was a bit too somber, I added the Hippie blue scheme to this example. New in this example is also that the surface and background colors receive a strong blend of the primary color in both dark and light mode. Just to show how, the option to use system controlled theme mode was removed in this example.

ColorScheme example 3a lightColorScheme example 3a darkColorScheme example 3b lightColorScheme example 3b dark

In example 4 we are going all in, we can now use a popup dialog to select any of the predefined schemes, and the one we made above, plus two more color schemes created using different options.

Surface and background branding level is a bit lower in this example than in the previous example, it is set to medium.

ColorScheme example 4a lightColorScheme example 4b lightColorScheme example 4c lightColorScheme example 4c dark

Example 5 is the last, and most complex one of the package bundled examples. It has many schemes and theming configuration options that we can modify interactively. This example is best seen and tested on a tablet, desktop or web browser, rather than on a phone, but it certainly works well on a phone too.

This example can do a lot of the things seen on the Theme page in the Flexfold demo app. It even has a fake semi responsive menu/rail included, so that we can see more of the primary color branded background surface.

ColorScheme example 5 lightColorScheme example 5b lightColorScheme example 5f lightColorScheme example 5g light

This example can even do some theme tricks that the Flexfold demo app cannot do in its current version.

It allows you to toggle the dark theme between using the predefined hand-tuned dark colors, or calculating them all with the FlexSchemeColor.toDark method and using this result for the dark scheme instead. This demonstrates that for quick dark mode schemes, from a set of existing colors for a light scheme, you can create a
very decent matching dark mode scheme from it, without need to hand-pick the dark scheme colors.

For actual apps you probably want to define and tune the dark theme colors, but as a quick way to get matching dark-mode colors, this works surprisingly well. The result can also be adjusted with the optional whiteBlend level parameter.

With the deep blue sea scheme, the computed dark scheme colors are a bit more muted when compared to the ones that were hand-picked for its dark scheme. These screenshots are using medium surface branding, the computed dark scheme is on the right.

ColorScheme example 5 darkColorScheme example 5 dark computed

With some other schemes, like with Aqua blue, there is only some minor difference. These screenshots are using strong surface branding, the computed dark scheme is on the right.

ColorScheme example 5a2 darkColorScheme example 5 dark computed

I updated example 5 and added a new feature to it, just to the example, no changes to FlexColorScheme itself. I included a slider that can be used to interactively change the whiteBlend level for the computed dark mode scheme colors. Let’s select a color scheme, say the Brand blues one, then go dark. By default, it uses the built-in predefined hand-picked matching dark scheme colors for the dark theme mode.

Now turn on the “Compute dark theme” mode, the result is pretty close to the predefined one for this dark scheme with the default level of 35%. Then adjust the white level blend to tune how saturated the computed dark scheme colors are compared to their light scheme master. At 0% they are the same as the light scheme, at 100%, well then they are white, not so useful. A range of 10…50% can produce excellent results. What is best depends on how saturated your starting light scheme colors are, and of course what kind of matching dark theme look you like and want. If you use the even darker dark-mode, true black, you may want to have a different saturation for your dark scheme colors compared to standard dark-mode surface. You could easily implement that as well with this feature.

Dark scheme calc level

Another thing example 5 can do, that the Flexfold demo app cannot, is to use FlexColorScheme.toScheme to extract a standard ColorScheme object, and instead of creating the theme with its own toTheme method, it can do it with the standard ThemeData.from factory using this extracted ColorScheme. If you open two versions of example 5 side by side, in two different browser-windows, you can compare the results by turning OFF the “Make the theme with FlexColorScheme toTheme method” toggle in one window. Not quite the same thing, FlexSchemeColors is working a bit of its theming magic in comparison. You can also see these differences, with explanations, in the light and dark comparison examples further below.

Flexfold Demo App Uses FlexColorScheme

The Flexfold web demo app uses the FlexColorScheme package for all of its theming. It just has more surface areas visible that use color branded surfaces and backgrounds. This tends to look a bit cooler than the above phone images, even when they are run as web apps. It might not seem so when looking at the phone screenshots above, but yes the Flexfold demo app is using exactly the same themes via the FlexColorScheme package, proving that it can look pretty cool, like this:


To play with the FlexColorScheme based themes in the Flexfold demo app, just head over to the Flexfold demo and go to the Theme page.

In the Flexfold demo app, if you select custom theme, custom surface and custom app bar, you can pretty much build any kind of theme you want interactively by using FlexColorPicker to select colors interactively for all the scheme colors and surfaces.

Why FlexColorScheme?

Google is re-designed the theming in Flutter so that all the built-in Material UI widgets will use colors defined in a ColorScheme in ThemeData for their theme inherited colors. The recommended way to create a theme in Flutter is now to use the ThemeData.from(colorScheme) factory, over using the ThemeData factory directly. The colors in a ColorScheme and their usage follow the Material Design Guide’s color system.

The migration to move all Flutter Material UI widgets to only use ColorScheme derived colors is still in progress. Some changes will inevitable also break with past default behavior from the ThemeData factory. This public design document explains the ongoing migration in detail.

ColorScheme Theme Gaps

There are some obvious Widgets that currently don’t get ColorScheme based colors applied in the current version of Flutter’s ThemeData.from factory. I wrote an analysis of this in issue (#65782). FlexColorScheme addresses these issues in a way so that more, hopefully even all, Flutter Material Widgets get ColorScheme based colors correctly and consistently applied.

There is also an issue (#65663) with ChoiceChip Widget that has a default theme that makes it almost invisible in dark-mode, this applies to both the ThemeData and ThemeData.from factories. This is corrected in FlexColorScheme, where a selected ChoiceChip gets a correctly used color scheme based theme also in dark-mode.

dark chip issue

Branded Surfaces and Backgrounds

The Material Guide describes color branded surfaces. With FlexColorScheme you can easily toggle a color scheme from using standard white or dark backgrounds and surfaces, to use light, medium, strong or heavy primary color branded backgrounds and surfaces. The strengths are tuned differently for light and dark mode.

branded surfaces

For dark-mode, a true black mode is also available for surfaces and backgrounds, color branding will also be applied to true-back mode for the strong and heavy setting. If you really want to ensure absolute black in dark-mode, use it in combination with the default no color branded surfaces and backgrounds.

AppBarTheme Breaks its Chains

A long struggle of mine was to break AppBarTheme from its chains. With this I refer to be able to for example create an AppBarTheme that has white background, while your light theme’s primary color has brightness dark, meaning it needs white text color when used as a background.

This is quite tricky, the backstory to this can be found in issue (#50606) that explains it in detail and shows a workaround for it. Currently, FlexColorScheme uses the workaround described in the issue to break these chains and set the AppBarTheme free. A new AppBarTheme feature implemented via (71184) and its this additional feature proposal (#72206) and its resolution (#72472), now makes it possible to do this without the workaround. When these features land in stable channel, FlexColorScheme will change its implementation to use these new AppBarTheme properties instead of the currently used workaround.

appbar breaks chains

The convenience app bar theming features offered by FlexColorScheme, that allows you to easily toggle an AppBarTheme between using the standard primary and background colors, to the color branded versions of background or surface, or even a custom color that is not specified or included in the ColorScheme at all, will remain unchanged by this implementation detail change.

TabBarTheme for the AppBar or Scaffold Usage (New in upcoming release 1.2.0)

By default, the TabBar is designed to fit with the AppBar’s theme, just as default Flutter ColorScheme do. FlexColorScheme will also adjust the TabBarTheme to match the active custom AppBarTheme choice you use.

Alternatively you can choose a TabBar designed for background and surface colors. This style works well if you intend to use the TabBar in a Scaffold, Sidebar, Drawer and Dialogs. If you do not plan to use the TabBar at all in the AppBar, then you can choose this style, and you do not have to theme it separately to work well and match the used color scheme.

Note that if your app bar background color is background styled, meaning dark, black, white, surface or background colored, including the primary branded versions, then the TabBarTheme style for backgrounds will also work in the AppBar, but that is however the only case when the same style fits for both use cases. If you plan to use the TabBar both in AppBars and on Surfaces, then you have to pick one theme style and create another custom theme for the use case you did not choose. The situation is equivalent with Flutter standard ColorScheme.

Material Buttons

FlexColorScheme also by default themes the old Flutter Material buttons to follow the same visual design that the new buttons use. This is limited to the degree that was possible with the limitation of doing it with ThemeData only. I still recommend using the newer buttons for their nicer interactions and more flexible additional theming possibilities. However, if you happen to use the old buttons, at least they won’t look out of place with the rest of the used colors in your application’s color scheme.

appbar breaks chains

The Difference?

In the package documentation read.me file there is a detailed list of all the corrections, and some minor opinionated adjustments that FlexColorScheme does to a theme made from a ColorScheme with its FlexColorScheme.toTheme property, compared to the standard ThemeData.from factory.

The best way to show this is via a visual comparison. To make it more applicable to the case of also using branded surfaces, the surface and background colors use a slight primary color branding in this example. The default in Flutter is to not use any color branding, in that case, the backgrounds would just be plain white or dark for both cases. FlexColorScheme certainly does normal plain backgrounds too, but for this comparison I wanted to show the difference in the look that you get when you also use slight color branding on the surface and background colors.

The chosen color scheme for the demonstration below was selected because it uses colors that makes the differences obvious. Depending on your color scheme’s colors, the differences might be less obvious. The key differences are marked with red boxes on the image from standard method, shown on the left side.

Light Theme Mode Comparison

Apart from the more nuanced and selective surface and background color branding, we see some highlighted differences on Material UI widgets in the Theme Showcase section. There are also some colors in the old ThemeData that do not get color scheme based colors applied at all! The fact that those are missing, impacts colors of some widgets that still use them for their default colors, they will be left at the blue shades even in this orange and green colored theme.

These screenshots are straight from package Example 5. The example has a built-in toggle that allows you to try a ColorScheme based theme, using the standard ThemeData.from(colorscheme) theme creation method or the FlexColorScheme.toTheme property (getter). The toggle that switches between these options, is marked in the screenshot below.

compare light

Dark Theme Mode Comparison

In dark-mode there is an additional difference. Flutter’s current version of ThemeData.from(colorscheme), does not set the ThemeData property toggleableActive to a color from the ColorScheme in dark-mode. The ThemeData factory sets this to accentColor, which would be the equivalent of secondary color in a ColorScheme. This was also reported as the first point in issue and analysis (#65782). The Flutter ThemeData.from(colorScheme) factory sets a number of other color properties in ThemeData, why not this one too? It really should in order to make a dark theme that follows the used color scheme. In any case, FlexColorScheme takes care of this color scheme based theme inconsistency as well.

compare dark

Built-in Color Schemes

Color schemes are no fun without some built-in examples to use and play with. FlexColorScheme comes with 28 ready to go color schemes that you can use in your apps if you like.

The bundled examples are all tuned matching light and dark theme pairs. The first two color schemes are actually the Flutter and Material Design guide examples of light and dark mode themes, and the Flutter high contrast light and dark version as well. So OK, there are actually “only” 22 new ready-made color schemes.

I might add more designs in later versions if there are requests, or some proposed nice additional color schemes you would like to have included.

There is of course no need to use any of the built-in color schemes, the package examples show how you can easily make your own custom ones, but maybe these will at least inspire you.

Light Mode Color Schemes

Below you will find all the light theme mode color schemes, with the scheme colors shown.

light 01 light 02 light 03 light 04 light 05 light 06 light 07 light 07 light 09 light 10 light 11 light 12 light 13 light 14 light 15 light 16 light 17 light 18 light 19 light 20 light 21 light 22 light 23 light 24 light 25 light 26 light 27 light 28

Dark Mode Color Schemes

Below you will find all the dark theme mode color schemes, with the scheme colors shown.

dark 01 dark 02 dark 03 dark 04 dark 05 dark 06 dark 07 dark 07 dark 09 dark 10 dark 11 dark 12 dark 13 dark 14 dark 15 dark 16 dark 17 dark 18 dark 19 dark 20 dark 21 dark 22 dark 23 dark 24 dark 25 dark 26 dark 27 dark 28

Funky Color Scheme Names?

So where do the funky scheme names come from? Like Mandy red and Hippie blue among others. I used the Flexfold demo app’s custom theme mode, to design some of the color schemes in FlexColorScheme. While doing that, FlexColorPicker names the chosen color automatically. Sometimes the automatically assigned color names where just so hip, that I had to use them in the scheme names too.

Now when the secrets of the color schemes and interactive theming in the Flexfold demo app have been revealed, why not head over to pub.dev and give FlexColorScheme and give it a try!

Page updated 27.1.2021