openclaw/carapace / openclaw-design-system
openclaw-design-system
VerifiedCompatibility alias for existing OpenClaw installations that now applies Carapace semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
| references/consumer-adapters.md | markdown | 2.0 KB |
| references/tokens.md | markdown | 3.0 KB |
references/tokens.md
View on GitHub# Token Contract
Import `@openclaw/design-system` for the complete foundation or use focused
exports when the consumer must control reset and adapter order. This legacy
specifier is intentional for consumers that have not migrated their dependency
to `@openclaw/carapace`.
## Layers
| Layer | Prefix | Purpose |
| --- | --- | --- |
| Palette | `--oc-palette-*` | Fixed source colors; rare direct use |
| Semantic | `--oc-bg-*`, `--oc-text-*`, `--oc-accent-*` | Theme-aware UI intent |
| Scale | `--oc-space-*`, `--oc-font-size-*`, `--oc-radius-*` | Shared dimensions |
| Motion | `--oc-duration-*`, `--oc-ease-*` | Shared interaction timing |
| Layer | `--oc-layer-*` | Popover and non-modal notification stacking roles |
| Product | `--oc-status-*`, `--oc-input-*`, `--oc-diff-*` | Opt-in operational UI |
| Consumer alias | Unprefixed legacy names | Migration compatibility only |
Component styles consume semantic and product roles in their owning
stylesheet; Carapace does not define a global component-token namespace. When
a component genuinely needs a local custom property, scope it to the component
root and document the override point beside that component rather than turning
it into a second palette.
## Semantic Choices
- Page background: `--oc-bg-page`
- Ordinary surface: `--oc-bg-surface`
- Elevated surface: `--oc-bg-elevated`
- Inset and inverted surfaces: `--oc-bg-recessed`, `--oc-bg-contrast`
- Primary, secondary, muted, inactive, inverse, and link text:
`--oc-text-primary`, `--oc-text-secondary`, `--oc-text-muted`,
`--oc-text-inactive`, `--oc-text-inverse`, `--oc-text-link`
- Primary action: `--oc-accent-primary`; hover:
`--oc-accent-primary-hover`
- Secondary accent: `--oc-accent-secondary`
- Neutral control backgrounds: `--oc-control-bg`, `--oc-control-bg-hover`
- Modal isolation: `--oc-surface-modal-backdrop`; ordinary translucent
surfaces continue to use `--oc-surface-overlay`
- Product fields: `--oc-input-*`; status feedback: paired `--oc-status-*-bg`
and `--oc-status-*-fg` roles
- Subtle, strong, and accent borders: `--oc-border-subtle`,
`--oc-border-strong`, `--oc-border-accent`
- Focus: `--oc-focus-ring`
Use `color-mix()` from semantic variables for a local translucent state. Add a
new shared semantic token only when the same intent recurs across consumers.
## Radius
Use semantic geometry roles in product UI:
- `--oc-radius-surface`: cards, panels, and framed sections
- `--oc-radius-control`: buttons, fields, chips, and segmented controls
- `--oc-radius-inset`: nested interactive or decorative surfaces
- `--oc-radius-round`: avatars, status dots, and genuinely circular indicators
The first three roles are square in the canonical OpenClaw system. Raw
`--oc-radius-*` scale values remain available for documented exceptions, but
must not replace the semantic defaults.
## Ownership
Consumer repositories own page composition and application states. This package
owns stable visual foundations, framework-neutral component primitives, and
thin migration aliases.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |