Cerberus provides a set of palettes that have an intentional purpose which contribtutes to the
overall theme. This creates a clear, consistent color scheme that can be easily customized.
Warning
We recommend always using Semantic Tokens and not primtives for color values. Primitives will eventually become private and are static by nature (e.g., they have no context of the theme or color mode).
Naming Convention
Cerberus uses a naming convention for semantic tokens to ensure clarity and maintainability. Each color is named based on its purpose and context, making it easier to understand its intended use.
Semantic token naming convention:
[palette].[usage].[prominence?].[interaction?]
Name
Description
Palette
The category/context of where the color is used.
Usage
How the color is used within the context.
Prominence
Optional.The hierarchy of the color used within the page context.
Interaction
Optional. The element interaction type the color should be applied to.
Page
Used for pages, layouts, and any other container that is relative to a page.
page.bg.100{colors.neutral.80}#201935
page.bg.200{colors.neutral.70}#2d2246
page.bg.300{colors.neutral.60}#392e55
page.bg.initial{colors.brand.100}#130024
page.border.100{colors.neutral.60}#392e55
page.border.200{colors.neutral.50}#605579
page.border.initial{colors.neutral.70}#2d2246
page.surface.100{colors.neutral.90}#130a2a
page.surface.200{colors.neutral.80}#201935
page.surface.300{colors.neutral.70}#2d2246
page.surface.400{colors.neutral.60}#392e55
page.surface.initial{colors.neutral.100}#0c0420
page.surface.inverse{colors.neutral.5}#f9f9fb
page.text.100{colors.neutral.20}#dedce5
page.text.200{colors.neutral.10}#eeedf2
page.text.300{colors.neutral.white}#ffffff
page.text.initial{colors.brand.5}#fcfbfe
page.text.inverse{colors.neutral.100}#0c0420
page.text.static{colors.neutral.60}#392e55
Action
The primary palette for actions, such as buttons, links, and other interactive elements.
Cerberus provides a comprehensive set of primitive colors (theme.tokens.colors) that serve as the foundation for all semantic tokens. These are the raw color values that semantic tokens reference.
Primitive colors are organized by color families and include numerical scales (e.g., neutral.0 to neutral.100) that provide fine-grained control over color variations. These colors form the building blocks that semantic tokens reference to create meaningful, contextual color usage.
How Primitives Relate to Semantic Tokens:
Semantic tokens like page.bg.initial reference primitive colors using token syntax: {colors.cerberus.neutral.5}
This creates a clear hierarchy: primitives → semantic tokens → component usage
Customizing primitive colors automatically updates all semantic tokens that reference them