Skip to main content
Clementine DS ships 10 React components backed by Mantine. Each component has a spec in specs/<component>/ containing a closed token contract, required ARIA attributes, and interaction state definitions. Components earn an AI-Ready status only after all five spec gates pass — until then they carry Draft status and should be treated as unverified.

Component Status

AI-Ready vs Draft

AI-Ready means all five spec gates pass:
  • aria_correct — required ARIA attributes are documented and implemented correctly
  • structure_correct — semantic HTML structure matches the spec
  • states_complete — every interaction state is defined with tokens
  • tokens_valid — every token reference resolves through the 3-tier cascade without a gap
  • no_invented_styles — no hardcoded hex values or out-of-contract color bindings
Draft means the component exists and ships, but at least one gate has not been verified. You can use Draft components in production, but their token bindings and variant definitions should not be modified until spec verification is complete.

Installation

Install the package and import components directly from @clementine-ds/ui:
Wrap your application in ClementineDSProvider to apply the Clementine theme:

Components

Button

Primary action trigger. AI-Ready with 4 variants, 3 sizes, and 15 component tokens.

Badge

Inline status and risk level labels with 8 intent variants including 4 risk tiers.

TextInput

Single-line text entry backed by Mantine TextInput with Clementine token bindings.

Textarea

Multi-line text entry for longer free-form content.

Select

Accessible dropdown selection for choosing one option from a list.

Checkbox

Binary toggle for boolean choices in forms and settings.

Radio

Single selection from a mutually exclusive group of options.

Switch

On/off toggle for immediately applied settings. Prefer over Checkbox for live changes.

Tabs

Tabbed content navigation for switching between related views or sections.

Modal

Overlay dialog for confirmations, forms, and focused sub-tasks.