Skip to content

xinetzone/SpecWeave / .agents/skills/nimbus-core-design

nimbus-core-design

Verified

Use this skill to generate well-branded interfaces and assets for TraeCode / Nimbus Core — a dark-first product design system with 23 components, 2 UI kits, and 115 SVG icons. Contains tokens, component specs, previews, and architecture documentation. Use when the user needs TraeCode / Nimbus Core-style UI, dashboards, or design assets, or asks to apply the TraeCode / Nimbus Core tokens and components.

Nimbus Core Design System

Dark-first product design system (core subset — 23 components covering both UI Kits). Tokens authored verbatim from the project root colors_and_type.css; component/UI-Kit references derived from the previews/ HTML pages.

Library Layout

The library root directory shown below is named nimbus-core/ for documentation. The deployed location is consumer-defined — it can be node_modules/@nimbus/core/, packages/design/nimbus-core/, a CDN base URL, or anywhere else. All paths in this document are relative to the library root; treat the root prefix as {NIMBUS_ROOT} and resolve it from your consumer project.

{NIMBUS_ROOT}/                 # nimbus-core library root (location is consumer-defined)
├── colors_and_type.css        # Authoritative token source (verbatim, dark-only)
├── css.json                   # Machine-readable token projection (auto-generated)
├── scaffold.css               # Page chrome: reset, layout helpers, shared atoms (hand-authored)
├── components.css             # Aggregated component class definitions — AUTO-GENERATED
├── icons.js                   # Inline icon sprite renderer
├── uikit-plan.json            # Component whitelist + slot assignments + screen blueprint
├── library-consumption.json   # Recommended downstream read order for agents
├── assets/
│   └── icons/                 # 115 bundled SVG icons (default + .0c0c0d / status-tinted variants)
├── components/                # Component layer (1 JSON contract per slug, 23 total)
│   ├── index.json
│   ├── activity-rail.json     │ ├── page-header.json
│   ├── alert.json             │ ├── pagination.json
│   ├── avatar.json            │ ├── setting-row.json
│   ├── buttons.json           │ ├── stat-card.json
│   ├── cards.json             │ ├── status-bar.json
│   ├── chat-composer.json     │ ├── table.json
│   ├── dialog.json            │ ├── table-panel.json
│   ├── editor-tabs.json       │ ├── tabs.json
│   ├── file-tree.json         │ ├── tag.json
│   ├── forms.json             │ └── workbench-titlebar.json
│   ├── kbd.json               │
│   ├── menu.json              │
│   └── nav-list.json          │
├── preview/                   # 23 component preview pages (1 HTML per slug)
└── ui_kits/                   # Page-level showcases composing components + tokens
    ├── dashboard/index.html
    └── dev-explorer/index.html

scaffold.css is hand-authored and stable. components.css is regenerated by design-library-creator/scripts/extract-components-css.mjs, which scans every preview/component-*.html for the CSS between /* @component-css-start */ and /* @component-css-end */ markers inside its <style> block and aggregates the result. Edit component CSS in the preview HTML, then re-run the script — never edit components.css directly.

Brand Essentials

  • Surface: dark canvas --bg-base-default #1A1B1D, layered with --bg-base-secondary / --bg-base-tertiary and --bg-overlay-l1..l4 tints.
  • Primary text: --text-default #D1D3DB; muted: --text-secondary / --text-tertiary.
  • Brand accent: --bg-brand #32F08C (green), with --bg-brand-hover and --bg-brand-popup tint.
  • Status palette: primary / success / alert / warning / error each provide default | hover | active | surface-l1..l3.
  • Typography: SF Pro / SF Pro Text body, JetBrains Mono for code; heading scale 3xs → 3xl, body scale xs → base with *-strong 500-weight pairs.
  • Radii: 2 / 4 / 6 / 8 / 10 / full. Spacers: 0 / 4 / 6 / 8 / 12 / 16 / 24 / 32 / 40.

Token Naming Convention

Tokens preserve their source naming verbatim. There are no portable aliases — components consume the source variables directly:

  • --bg-* surface fills (base / overlay / brand / menu / tooltip / invert)
  • --text-* and --icon-* content tokens (mirroring color states)
  • --border-neutral-l1..l3, --border-brand, --border-contrast
  • --status-{primary|success|alert|warning|error}-{default|hover|active|surface-l1..l3}
  • --accent-*, --brand-{green|red|yellow|blue|purple}-100..1000, --viz-*
  • Typography: --{body|heading}-{size}-{font-family|font-size|font-weight|line-height}
  • Code: --code-editor-*, --code-terminal-*, plus --code-{text|doc|link|number|action|...} hues.

Components reference tokens directly via var(--token-name). Do not rename tokens; do not introduce new color scales.

Components (23)

SlugTypeNotes
activity-railIDE railvertical activity bar with active state + divider
alertNotification matrix4 tones × simple/complex layouts
avatarUser chipsm/md/lg, square/accent, stacked group + overflow
buttonsButton matrixbrand/primary/ghost/danger × sizes × states
cardsSurface cardheader / actions decorations
chat-composerAI inputtool row + model chip + mic + send
dialogModaloverlay + footer actions
editor-tabsIDE tabslayered tab strip + close affordance + actions
file-treeIDE explorermulti-depth rows, chevron, file-type colors
formsForm controlsinput / textarea / select / checkbox / radio / switch
kbdShortcut hintkeyboard key caps
menuDropdown menusection labels, shortcut, destructive item
nav-listSidebar navgrouped menu items with active state
page-headerPage headtitle + actions region
paginationPage navigatornumeric pages with ellipsis
setting-rowPreference rowtitle + description + control (select / button / select-with-icon); group panels with .ds-settingrow__group + .ds-settingrow__grouplabel
stat-cardKPI cardtabular numerals + delta
status-barIDE status barstatus items + dot indicators
tableData tableavatar + tag cells, toolbar/footer, scoped status colors
table-panelTable containerbordered table with toolbar + footer pagination slot
tabsTabsunderline / filled / closable styles
tagStatus tagdefault / success / warning / danger / brand / count / neutral-strong
workbench-titlebarIDE top bartraffic lights + project selector + icon actions

UI Kits (2)

TypeComposition
dashboardKPI stats + recent-activity table
dev-explorerIDE shell: title-bar + activity-bar + explorer + editor + chat + status bar

Each UI Kit is a single, self-contained interactive React 18 index.html that links ../../colors_and_type.css and ../../components.css, renders icons via ../../assets/icons/*.svg, and writes a sibling quality-report.json. The shell is capped at max-width: 1184px per design-library-creator skill spec — UI Kits are showcases, not real-canvas page templates (see README → "Downstream Consumption Guide").

Icons

Bundled SVG icons live at assets/icons/ (115 files). Optional runtime sprite renderer at icons.js.

Authoring Rules

  1. Never hardcode hex/rem values. Always reference var(--token).
  2. Status color is local. Tag/cell-level colorization only — never tint full table rows.
  3. Surface lifts. Use --bg-base-secondary (regular) and --bg-base-tertiary (raised) for layered surfaces.
  4. Borders stay neutral. --border-neutral-l1 for default chrome; only state-specific borders use status/brand.
  5. Icons are 2px stroke rendered through icons.js; size via data-size.

Out of Scope (Not Generated)

  • Token-only previews (colors, typography, spacing, radius) — by user request, foundational previews are NOT included; they are represented purely by colors_and_type.css + css.json.
  • Auto-derived light theme — source tokens are dark-only (/* @dark-only */).
  • React UI Kit interactivity — UI Kits ship as static HTML showcases, matching the source previews/ structure.

Conversation Continuity

  • Add components: expand-components
  • Refine tokens or rename groups: refine-library
  • Generate an additional kit (e.g., mobile / marketing site): generate-additional-kit
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: 319kUpdated 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: 196kUpdated 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: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall