Skip to content

Color System

Neutral Foundation

css/colors/

The style system employs a neutral monochromatic palette as its foundation for presenting information. Visual hierarchy is established primarily through typographic techniques and grid structure rather than relying on color differentiation.

This approach helps maintain focus on content while ensuring accessibility and reducing cognitive load for users. The restraint in color usage creates a professional, timeless aesthetic that won’t quickly feel dated.

When information architecture is strong, color becomes an accent — not a necessity

For the design and development team, it eliminates the paradox of choice that comes with access to 16.7 million possible HEX colors, streamlining decision-making and ensuring consistency.

Grayscale Palette

Black and white serve as the foundational contrast colors in the system. The grayscale palette between them performs a supporting function, ensuring comfortable information perception and helping users intuitively distinguish between primary and secondary information.

The core grayscale palette consists of three primary and five supplementary shades that are used throughout the template:

Grays Family

white
#ffffff
gray-lightest
#fafafa
gray-light
#f0f0f0
gray-mid-light
#e4e4e4
gray
#cccccc
gray-trans
#888888
gray-mid-dark
#666666
gray-dark
#333333
gray-darkest
#191919
black
#000000

These settings can be adjusted in your global stylesheet according to specific project needs:

// css/modules/colors/_base.scss
    
// Base Colors 

--black: #000; // Text color
--white: #fff; // Used for blocks highlighting

// Grays Family 

--gray-light: #f0f0f0; // Used for backgrounds
--gray: #cccccc; // Used for borders, dividers
--gray-dark: #333333; // Used for secondary text

--gray-lightest: #fafafa; // Used for cards backgrounds
--gray-mid-light: #e4e4e4; // Used for secondary backgrounds
--gray-trans: #888888; // Used for disabled states
--gray-mid-dark: #666666; // Used for labels, captions
--gray-darkest: #191919; // Used for highlighting light-grays

These grays are implemented across all levels of the interface - from section backgrounds to specialized text elements like blockquotes, citations, and preformatted text blocks.

Accent Colors

While the grayscale palette forms the foundation, strategic use of color helps highlight key informational elements and establish visual hierarchy where necessary.

Brand Color

The most prominent color in the system is defined by the --brand-color variable. It marks the brand: it fills the primary button and frames a .highlight. Links are underlined in the darker --brand-color-dark.

// css/modules/colors/_brand.scss
    
--brand-color: #00ff4e; // Primary brand color
--brand-color-light: #d8f9d1; // Lighter variant: only its color utilities read it (.brand-color-light, -bg, -link)
--brand-color-dark: #00b300; // Darker variant: link underlines and their hover fill
--brand-color-deep: #3a8000; // Deeper still: the primary button's hover; white text on it reads at 4.9:1

A project that re-maps --brand-color sets --brand-color-deep too, to a shade that carries white text at 4.5:1 or more: under the pointer the primary button turns to it, with a white label.

Technical Colors

Technical colors are used to highlight important info: statuses, warnings, and errors.

yellow — for warnings
#ffe000
red — for errors
#ff0000
green — for success
#389e0d
blue — the signal
#1677ff

Technical colors should be used strictly for their intended purpose — a designer must avoid inflating the importance of content that isn’t truly critical.

Semantic Colors

css/modules/colors/_semantic.scss

Components that signal a state read a role, not a hue. Four roles point at the technical colors above:

Role Default Meaning
--signal var(--blue) Technical information, the main chart color
--success var(--green) Done, passed
--warning var(--yellow) Caution: read before you go on
--danger var(--red) An error, a destructive action

Four aliases name the same colors where the meaning is different. They follow the role they point at:

Alias Points at Meaning
--positive var(--success) A financial figure that changed for the better
--negative var(--danger) A financial figure that changed for the worse
--neutral var(--warning) A financial figure that did not change
--fail var(--danger) A check or an operation that did not go through

Each role and each alias has its own -bg twin: the color at 25%, a fill to set text on. Every swatch below is the token as a stripe on its own -bg:

--signal on --signal-bg
--success on --success-bg
--warning on --warning-bg
--danger on --danger-bg
--positive on --positive-bg
--negative on --negative-bg
--neutral on --neutral-bg
--fail on --fail-bg

Where they are used: the callout variants (.callout-success, -warning, -danger; .callout-signal takes the text color, --primary-text-color, with no fill), a KPI delta (--positive up, --negative down), a form field (--success when right, --fail when invalid), the danger button (--danger) and the keyboard focus ring (--focus-ring-color: var(--signal); an own --focus-ring-color on :root still wins). --signal also colors checked boxes and the focused field (--field-accent), an emphasized stat (.stat--signal) and a chart's first series (--chart-series-1).

To change what a meaning looks like, re-map the role once, not every component. Re-map it on :root: the aliases and the -bg twins are resolved there and follow. On a single surface, restate them too (the callouts mix their fill from the role where they are, so theirs follows by itself; the -bg twins are for your own fills, the library reads none of them):

:root {
    --warning: var(--orange); /* --neutral and both -bg follow */
}

.report {
    --danger: var(--cherry);
    --danger-bg: color-mix(in srgb, var(--danger) 25%, transparent);
}

They are signal colors for stripes, borders and fills, not for text: none of them reaches 4.5:1 as body text on the light surfaces. Keep the words in the text colors and say the state in words too, so the color is never the only cue.

--signal is kept apart from the brand colors, which are identity: brand marks, the primary button, link highlights (--brand-color-dark).

Surface

--surface-current is the background of the surface an element sits on: the page's --bg-color, unless a .card or a .card-inverted sets its own (each paints its background with it). A .panel paints no background and sets none, so the surface behind it passes through. On paper it is white; in an island, which sits on the host's background, set it yourself. Charts paint their label plates with it from RareCharts 0.9.8_7; see Surfaces.

Chart Tokens

css/modules/charts/_index.scss

The colours a chart takes from the page (its series, text, axes and gridlines, range controls and tooltip) have names of their own, --chart-*; most point at a token on this page, and three series keep RareCharts' own hues. RareCharts reads them first, from its 0.9.8_7. The full list is on Chart Tokens.

Supporting Colors

css/modules/colors/_supporting.scss

A limited set of supporting colors is available for specific purposes like data visualization and thematic section coding:

cherry
#86241a
plum
#4e4153
ocean
#2f7395
orange
#fa8c16
pink
#ffd6e7
princess
#ff00f5
safari
#ffb038
purple
#722ed1
pen
#0033a0
tiffany
#53c9e9
blueberry
#221e4d
coral
#fe7c64
matrix
#00ff4e

Technical Implementation

Using these colors in your project is straightforward. To apply colors to elements, simply assign one of the following class patterns:

  • {color-name} - Applies the color to text
  • {color-name}-bg - Applies the color as a background
  • {color-name}-link - Formats the element as a link with the specified color

For example:

<span class="red">Error message</span>
<span class="ocean-bg white">Ocean background, white text</span>
<a class="cherry-link">Cherry link</a>

Remember that just because these color classes are available doesn’t mean they should be used extensively. The most effective interfaces often use color sparingly, relying on it only when necessary to highlight truly important information or actions.