# Clementine DS ## Docs - [Clementine DS: Token-Driven, AI-Ready React Components](https://clementineds.mintlify.app/introduction.md): Clementine DS ships 10 React components, a 3-tier token cascade, and per-component specs that AI agents read to write correct, token-bound code. - [Clementine DS Quickstart: Install and Render Components](https://clementineds.mintlify.app/quickstart.md): Install Clementine DS, wrap your app in ClementineDSProvider, and render your first token-bound React component in under five minutes. - [Add a New Component to Clementine DS: Six-Step Guide](https://clementineds.mintlify.app/first-component.md): Follow the six-step workflow to scaffold a spec, define component tokens, implement the TSX, write Storybook stories, and reach AI-Ready status. - [How AI Agents Read and Validate Clementine DS Specs](https://clementineds.mintlify.app/concepts/agentic-specs.md): Clementine DS ships machine-readable per-component specs so AI agents validate tokens, ARIA, and states before writing code — no guessing, no drift. - [Clementine DS Token Cascade: Primitives to Components](https://clementineds.mintlify.app/concepts/token-cascade.md): Three strict tiers — primitive, semantic, component — form the Clementine DS token cascade, enabling safe theming and mechanical drift detection. - [Contract Rules: All 15 agentic-spec Validation Checks](https://clementineds.mintlify.app/concepts/contract-rules.md): The 15 validation rules that agentic-spec enforces on every spec — from identity checks to cascade correctness to AI-Ready honesty gates. - [Primitive Tokens: Raw Design Scales in Clementine DS](https://clementineds.mintlify.app/tokens/primitives.md): Tier 1 of the Clementine DS cascade. Primitive tokens are raw scales with no intent — literal hex colors, pixel dimensions, and type scales. - [Semantic Tokens: Intent-Based Design Vocabulary](https://clementineds.mintlify.app/tokens/semantic.md): Tier 2 of the cascade. Semantic tokens name what a value is for, not what it looks like — enabling dark mode, theming, and intent-driven design. - [Component Tokens: Per-Component Design Bindings](https://clementineds.mintlify.app/tokens/component-tokens.md): Tier 3 of the cascade. Component tokens give each component an explicit, named binding between semantic intent and a visible part — powering retheming and agent contracts. - [Clementine DS Component Library Overview](https://clementineds.mintlify.app/components/overview.md): Ten React components in Clementine DS — each with a closed token contract, required ARIA attributes, and interaction state specs for AI-safe usage. - [Button Component: Variants, States, and Token Contract](https://clementineds.mintlify.app/components/button.md): The Clementine DS Button — AI-Ready, 4 variants, 3 sizes, 6 interaction states, 15 component tokens, full ARIA coverage. Backed by Mantine. - [Badge Component: Status and Risk Level Indicators](https://clementineds.mintlify.app/components/badge.md): The Clementine DS Badge renders inline status and risk level labels with semantic color coding across 8 intent variants including 4 risk tiers. - [TextInput Component: Single-Line Input for React Apps](https://clementineds.mintlify.app/components/text-input.md): The Clementine DS TextInput for single-line text entry — supports error states, helper text, labels, focus ring, and full keyboard accessibility. - [Textarea Component: Multi-Line Text Input for React Apps](https://clementineds.mintlify.app/components/textarea.md): The Clementine DS Textarea for multi-line text input — extends TextInput behavior with resizable height, autosize option, and consistent token binding. - [Select Component: Accessible Dropdown for React Apps](https://clementineds.mintlify.app/components/select.md): The Clementine DS Select renders an accessible dropdown with searchable options, error states, and token-bound styling for all interaction states. - [Checkbox Component: Binary Form Input for React Apps](https://clementineds.mintlify.app/components/checkbox.md): The Clementine DS Checkbox for binary on/off selections — supports indeterminate state, error display, and accessible keyboard interaction. - [Radio and RadioGroup Components: Single-Select Groups](https://clementineds.mintlify.app/components/radio.md): Use Radio and RadioGroup to present a mutually exclusive set of options — users pick exactly one, with full keyboard and screen-reader support. - [Switch Component: Instant On/Off Toggle for Settings](https://clementineds.mintlify.app/components/switch.md): Use Switch to toggle a single setting on or off with immediate effect, no Save button required. Distinct from Checkbox, which is for form state. - [Tabs Component: Switchable Panels and Tab Navigation](https://clementineds.mintlify.app/components/tabs.md): Use Tabs, TabsList, TabsTab, and TabsPanel to organize related content into switchable panels with full keyboard navigation and ARIA tab semantics. - [Modal Component: Focus-Trapped Accessible Overlay Dialog](https://clementineds.mintlify.app/components/modal.md): Use Modal to interrupt the current page with a focus-trapped dialog for confirmations, short forms, or detail views that require a user decision. - [Figma Integration: Clementine DS Variable Collections](https://clementineds.mintlify.app/integrations/figma.md): Clementine DS mirrors its 3-tier token cascade as three Figma variable collections — Primitives, Semantic Light+Dark, and Components — all auto-synced. - [Storybook: Clementine DS Components and Token Bindings](https://clementineds.mintlify.app/integrations/storybook.md): Clementine DS includes a live Storybook at clementine-ds-storybook.vercel.app — every component, interaction state, and token binding in one sandbox. - [AI Coding Agents with Clementine DS: Using Component Specs](https://clementineds.mintlify.app/integrations/ai-agents.md): Point Claude, Cursor, GitHub Copilot, or any MCP server at Clementine DS specs for token-correct, ARIA-complete code without hallucinated tokens. - [agentic-spec CLI Overview: Validate and Scaffold Specs](https://clementineds.mintlify.app/cli/overview.md): agentic-spec validates Clementine DS component specs against 14 rules, scaffolds new spec directories, and produces machine-readable JSON for CI. - [agentic-spec validate: Component Spec Validation Command](https://clementineds.mintlify.app/cli/validate.md): agentic-spec validate checks a spec directory against 14 rules — identity, token cascade, metadata sanity, and honesty gates. Non-zero exit on errors. - [agentic-spec init: Scaffold a New Component Spec Directory](https://clementineds.mintlify.app/cli/init.md): agentic-spec init scaffolds a new spec directory with index.md and tokens.json stubs — the starting point for adding a component to the system. - [agentic-spec CLI Troubleshooting: Fix Validation Failures](https://clementineds.mintlify.app/cli/troubleshooting.md): Common agentic-spec CLI errors, validation failures, and how to fix them — from missing-token-entry to lying-check to ai-ready-gate. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.