Skip to content

openclaw/carapace / openclaw-carapace

openclaw-carapace

Verified

Build or modify OpenClaw application UI using canonical semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives. Use for product interfaces, component styling, theme work, or design-token integration.

references/tokens.md

View on GitHub
# Token Contract

Import `@openclaw/carapace` for the complete foundation or use focused
exports when the consumer must control reset and adapter order.

## 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.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall