@geisthq/design-system

Platform parent design tokens for the GEIST platform, published in DTCG format.

Every GEIST vertical inherits this file and overrides only a narrow set of tokens (accent color, default theme, optional display font). Tenants producing branding through Claude Design install this package so their exported Handoff bundle diffs against the real platform baseline rather than an approximation.

Install

npm install @geisthq/design-system

Use

import tokens from "@geisthq/design-system";
// or
import tokens from "@geisthq/design-system/tokens.json";

As Claude Design project context

Add this package to your Claude Design project so the canvas inherits real platform tokens:

1. Install the package in your project's repo.
2. In your Claude Design project → Settings → Resources → link node_modules/@geisthq/design-system/ (or upload tokens.json directly).
3. The parent baseline (surfaces, text, borders, radius, typography, spacing, shadow, motion) is now available in the canvas.
4. Override only: themes.{mode}.color.accent.*, $defaultTheme, and optionally typography.fontFamily.display.

Token shape

brand.*            theme-invariant marque identity (colors + gradient)
typography.*       font families, sizes, weights, line heights
radius.*           corner radii
spacing.*          layout spacing scale
shadow.*           elevation shadows
motion.*           duration + easing tokens
themes.dark        color palette — surfaces, text, borders, accents
themes.light       color palette — surfaces, text, borders, accents
themes.midtone     color palette — warm off-white + dark brown text
$defaultTheme      default theme key for consumers

Every leaf is { "$value": "...", "$type": "..." } per DTCG.

Override policy — common chassis, thin skin

Keep the chassis platform-wide; skin thinly per vertical. A vertical may override:

1. $defaultTheme.
2. themes.{mode}.color.accent.*.
3. typography.fontFamily.display.

Nothing else. Propose a platform change rather than drifting locally.

Related packages (planned)

• @geisthq/talentgeist-design-system
• @geisthq/agentgeist-design-system
• @geisthq/dermgeist-design-system
• @geisthq/learngeist-design-system
• @geisthq/basegeist-design-system
• @geisthq/paygeist-design-system

Each extends this package's tokens.json via $extends and publishes the same DTCG shape.

Versioning

Semver against the token contract: value change is a patch, adding a token is a minor, removing or renaming is a major.

License

UNLICENSED — not for redistribution outside the GEIST platform ecosystem.