# Shared color foundation

Fractal owns the canonical primitive token values in [primitives.json](primitives.json). Applications and packages consume those values; an application stylesheet is not the upstream design authority. Canonical CSS tokens live in resources/tokens/.

Use these colors as the default source in Fractal-designed artifacts, including newly authored presentations, unless the user supplies another brand or style. Preserve an existing artifact's design unless restyling is requested. Sharing colors does not make every domain share typography, surface treatment, density, or geometry.

Domain rules determine color's meaning:

- Product UI and reports use semantic tokens and meaningful status/hierarchy.
- Product charts use the product palette and scientific charts use their approved colourmap catalogue. Both use explicit theme-aware values; do not substitute UI hierarchy for data meaning.
- Chemical element colors preserve scientific identity through the approved renderer palette.
- Presentations select a coherent palette from these families. Blueprint remains an explicit structural profile, not an automatic consequence of palette use.

Preserve accessibility, actual foreground/background contrast, and non-color cues regardless of palette choice. A user override changes aesthetic defaults, not scientific meaning or factual accuracy.

For buttons, apply the shared [variant meanings](../primary-actions.md): blue Primary, neutral filled Secondary, outlined Tertiary, and borderless Ghost. The public website can use Secondary for its main CTA.