DEV Community

Cover image for Designing a Color Palette for Dark and Light Modes for React App
Rodion Chachura
Rodion Chachura

Posted on • Originally published at

Designing a Color Palette for Dark and Light Modes for React App

Watch on YouTube | 🐙 GitHub | 🎮 Demo

Designing a color palette that achieves both beauty and functionality can be challenging, especially when trying to make it graceful in both dark and light modes while keeping the color system easy to manage in the code. In this post, I will share an approach that has worked well for my front-end project and should help make color systems intuitive for you as well.

Example from ReactKit

Theme Preference

We store the user's theme preference in the local storage. The available options are "dark," "light," or "system." By default, we set it to "system" unless the user decides to change it. If you are interested in learning about an optimal setup for storing values in the local storage, please refer to this post.

import { PersistentStorageKey } from "state/persistentStorage"
import { usePersistentStorageValue } from "state/usePersistentStorageValue"

import { ThemePreference } from "./ThemePreference"

export const useThemePreference = () => {
  return usePersistentStorageValue<ThemePreference>(
Enter fullscreen mode Exit fullscreen mode

Here's an example of the theme settings in my productivity app at

Theme settings in Increaser

To provide the components with colors, we have to wrap the root of the app with the ThemeProvider component. It relies on the useMedia hook from react-use to detect if the user prefers a dark theme. Then, based on that value and the theme preference from local storage, we pick the theme object.

import { useMemo } from "react"
import { useMedia } from "react-use"
import { ComponentWithChildrenProps } from "shared/props"
import { ThemeProvider as StyledComponentsThemeProvider } from "styled-components"
import { darkTheme } from "ui/theme/darkTheme"

import { lightTheme } from "./lightTheme"
import { useThemePreference } from "./useThemePreference"

export const ThemeProvider = ({ children }: ComponentWithChildrenProps) => {
  const [themePreference] = useThemePreference()

  const isSystemThemeDark = useMedia("(prefers-color-scheme: dark)")

  const theme = useMemo(() => {
    if (themePreference === "system") {
      return isSystemThemeDark ? darkTheme : lightTheme

    return themePreference === "dark" ? darkTheme : lightTheme
  }, [isSystemThemeDark, themePreference])

  return (
    <StyledComponentsThemeProvider theme={theme}>
Enter fullscreen mode Exit fullscreen mode

Dark and Light Themes

Both the dark and light themes implement the DefaultTheme interface, which we declare in the styled.d.ts file. It includes a name (either "dark" or "light"), colors, and shadows.

import "styled-components"

import { ThemeColors } from "lib/ui/theme/ThemeColors"

import { ThemeName } from "./ThemeName"
import { ThemeShadows } from "./ThemeShadows"

declare module "styled-components" {
  export interface DefaultTheme {
    name: ThemeName
    colors: ThemeColors
    shadows: ThemeShadows
Enter fullscreen mode Exit fullscreen mode

All the colors we'll use in our app will come from the ThemeColors interface implementation or their variants.

import { HSLA } from "../colors/HSLA"

export type ThemeColors = {
  primary: HSLA

  alert: HSLA
  idle: HSLA
  success: HSLA

  foreground: HSLA
  background: HSLA

  text: HSLA
  textSupporting: HSLA
  textShy: HSLA

  contrast: HSLA

  mist: HSLA
  mistExtra: HSLA

  overlay: HSLA

  white: HSLA
  transparent: HSLA

  getLabelColor: (index: number) => HSLA
Enter fullscreen mode Exit fullscreen mode

The "primary" color is like a brand or accent color. It's the only color you have to change in the system to accommodate it for your app. We will usually use the "primary" color for interactive elements such as buttons, checkboxes, or links.


The "alert" color is for error messages or destructive actions. "Idle" is an orange color that could be used for warnings, and I use it in some visualizations, like in this example highlighting an overdue.

Break overdue

The "success" color is used for positive things, like a check icon when the user completes a task or to highlight an increase in some metric. Here's an example of using it to show a habit streak.*vtTlG_WmopwEthBT_637IA.jpeg

"Foreground" could be used for a sidebar or some panel, while the "background" color provides the most contrast. It's either almost black or white and serves as a page background or text color in reversed elements, like a button with a dark background and white text in a light mode.

A "reversed" button

We will use "text", "textSupporting", and "textShy" for texts. They have different contrast levels, and their names embody their purpose. There's also a "contrast" color that we will use for things that should stand out. It will be absolute white in the dark mode and black in the light mode.

Text colors

"Mist" and "mistExtra" are almost transparent colors that we would use a lot because we can put one element with the "mist" background on top of another, and they will still have different colors due to the transparency. We can use them for panels and cards, buttons, borders, etc. For interactive elements with the "mist" background, we would usually use "mistExtra" as a hover color.

A panel with a "mist" background

The "overlay" color is an almost opaque version of the "mist" color that we would use to blur out the background when showing a modal.

A modal with an "overlay" background

The "white" and "transparent" colors are self-explanatory, and they will be the same in both themes. We will use the getLabelColor function to get a color for a label based on its index. Here's an example of a color input that relies on that function to provide this list of options. To learn more about color generation and the HSLA format, check out this post.

A color input

Here's how the darkTheme implements the ThemeColors interface. When using the HSLA format, there's logic for colors: here, foreground is the same as the background, but a bit lighter. The same goes for the mistExtra color, which is a bit more opaque than the mist color.

import { DefaultTheme } from "styled-components"
import { generateLabelColorGetter } from "ui/colors/generateLabelColorGetter"
import { HSLA } from "ui/colors/HSLA"

import { sharedColors } from "./shared"

const backgroundHue = 0
const backgroundSaturation = 0

const backgroundLightness = 10

export const darkTheme: DefaultTheme = {
  name: "dark",
  colors: {

    success: new HSLA(130, 56, 52),

    foreground: new HSLA(
      backgroundLightness + 3
    background: new HSLA(
    text: new HSLA(0, 0, 100, 0.81),
    textSupporting: new HSLA(0, 0, 61),
    textShy: new HSLA(0, 0, 100, 0.28),

    mist: new HSLA(0, 0, 100, 0.06),
    mistExtra: new HSLA(0, 0, 100, 0.13),

    overlay: new HSLA(backgroundHue, backgroundSaturation, 1, 0.8),

    getLabelColor: generateLabelColorGetter({
      saturation: 56,
      lightness: 52,

    contrast: new HSLA(0, 0, 100),
  shadows: {
      "rgb(15 15 15 / 20%) 0px 0px 0px 1px, rgb(15 15 15 / 20%) 0px 2px 4px",
      "rgb(15 15 15 / 10%) 0px 0px 0px 1px, rgb(15 15 15 / 20%) 0px 3px 6px, rgb(15 15 15 / 40%) 0px 9px 24px;",
Enter fullscreen mode Exit fullscreen mode

And here is the lightTheme implementation. You can see the slight difference in saturation and lightness we pass to the generateLabelColorGetter function to make them fit the light theme.

import { DefaultTheme } from "styled-components"
import { generateLabelColorGetter } from "ui/colors/generateLabelColorGetter"
import { HSLA } from "ui/colors/HSLA"

import { sharedColors } from "./shared"

export const lightTheme: DefaultTheme = {
  name: "light",
  colors: {

    success: new HSLA(137, 66, 36),

    foreground: new HSLA(60, 11, 98),
    background: new HSLA(0, 0, 100),

    text: new HSLA(60, 6, 20),
    textSupporting: new HSLA(45, 19, 8, 0.6),
    textShy: new HSLA(45, 8, 20, 0.65),

    mist: new HSLA(45, 8, 20, 0.06),
    mistExtra: new HSLA(45, 8, 20, 0.16),

    overlay: new HSLA(0, 0, 0, 0.8),

    contrast: new HSLA(0, 0, 0),

    getLabelColor: generateLabelColorGetter({
      saturation: 64,
      lightness: 64,
  shadows: {
      "rgb(15 15 15 / 10%) 0px 0px 0px 1px, rgb(15 15 15 / 10%) 0px 2px 4px",
      "rgb(15 15 15 / 5%) 0px 0px 0px 1px, rgb(15 15 15 / 10%) 0px 3px 6px, rgb(15 15 15 / 20%) 0px 9px 24px",
Enter fullscreen mode Exit fullscreen mode

Using Theme Colors in Styled Components

To access the color in styled components, we would usually rely on the getColor helper.

import { DefaultTheme } from "styled-components"

import { ThemeColors } from "./ThemeColors"

interface ThemeGetterParams {
  theme: DefaultTheme

type ColorName = keyof Omit<ThemeColors, "getLabelColor">

export const getColor =
  (color: ColorName) =>
  ({ theme }: ThemeGetterParams) =>

background: ${getColor('primary')};
Enter fullscreen mode Exit fullscreen mode

However, there may be times when we need to create a color variant. For example, here we make the button background a bit dimmer on hover:

import { HSLA } from "./HSLA"

export const getHoverVariant = (color: HSLA) =>
  color.getVariant({ l: (l) => l * 0.92 })
Enter fullscreen mode Exit fullscreen mode

Top comments (0)