# Plasma Design System — LLM Documentation

Plasma is Coveo's design system built on top of Mantine. It provides a curated set of React components, a custom Mantine theme, design tokens, and icons for use in Coveo Cloud products.

> Always import from `@coveord/plasma-mantine`, not directly from a `@mantine/*` package.
> Wrap your app with the `Plasmantine` provider from `@coveord/plasma-mantine/plasmantine`.

For a single consolidated file with all component documentation, use:

- [https://plasma.coveo.com/llms-full.txt](https://plasma.coveo.com/llms-full.txt)

## Components

- [Accordion](https://plasma.coveo.com/llms/components/Accordion.md): Collapsible content group for progressively revealing related sections without leaving the current page.
- [ActionIcon](https://plasma.coveo.com/llms/components/ActionIcon.md): Icon-only button that can trigger actions and can show a disabled-state tooltip.
- [Alert](https://plasma.coveo.com/llms/components/Alert.md): Alert callout for contextual information, advice, warnings, critical errors, and success states.
- [Anchor](https://plasma.coveo.com/llms/components/Anchor.md): Inline text link that navigates the user to another page or section.
- [AppShell](https://plasma.coveo.com/llms/components/AppShell.md): Application layout shell with a scrollable main content area.
- [Badge](https://plasma.coveo.com/llms/components/Badge.md): Status label that can display short text, counts, or metadata tags.
- [BlankSlate](https://plasma.coveo.com/llms/components/BlankSlate.md): Empty state container for views with no content to display.
- [Breadcrumbs](https://plasma.coveo.com/llms/components/Breadcrumbs.md): Horizontal trail of navigation links showing the user's position within a page hierarchy.
- [BrowserPreview](https://plasma.coveo.com/llms/components/BrowserPreview.md): Renders a simulated browser chrome frame around preview content.
- [Button](https://plasma.coveo.com/llms/components/Button.md): Action button that triggers tasks and provides async loading and disabled-tooltip feedback.
- [Card](https://plasma.coveo.com/llms/components/Card.md): Container that groups related content into a visually distinct surface, optionally interactive with hover and selection states.
- [Checkbox](https://plasma.coveo.com/llms/components/Checkbox.md): Boolean selection control for choosing zero, one, or many visible options, including stand-alone opt-in choices.
- [ChildForm](https://plasma.coveo.com/llms/components/ChildForm.md): Expandable nested sub-form within a parent form context.
- [Chip](https://plasma.coveo.com/llms/components/Chip.md): Selectable pill-shaped control that strips the Mantine variant prop to enforce Plasma styling.
- [CloseButton](https://plasma.coveo.com/llms/components/CloseButton.md): Icon-only button for dismissing or closing an overlaying element such as a modal, drawer, or tag.
- [CodeEditor](https://plasma.coveo.com/llms/components/CodeEditor.md): Monaco-based code editor that supports syntax highlighting, validation, search, and copy actions.
- [Collection](https://plasma.coveo.com/llms/components/Collection.md): Dynamic list input that can render items with column-based layouts or a legacy children render prop.
- [Components](https://plasma.coveo.com/llms/components/ComponentsOverview.md): Complete list of Plasma design system components, grouped by function with library origin.
- [CopyToClipboard](https://plasma.coveo.com/llms/components/CopyToClipboard.md): Action icon that copies a string value to the clipboard and shows tooltip feedback.
- [DatePickerInput](https://plasma.coveo.com/llms/components/DatePickerInput.md): Form input that opens a calendar popover for selecting a single date, multiple dates, or a date range.
- [DateRangePicker](https://plasma.coveo.com/llms/components/DateRangePicker.md): Date range picker with an input trigger, inline calendar, presets, and optional URL synchronization.
- [EllipsisText](https://plasma.coveo.com/llms/components/EllipsisText.md): Text component that truncates overflowing content and can show the full value in a tooltip.
- [Facet](https://plasma.coveo.com/llms/components/Facet.md): Facet renders a searchable list of selectable filter options with optional counts and grouping.
- [Header](https://plasma.coveo.com/llms/components/Header.md): Page-level header with a title and optional breadcrumbs, actions, and a documentation link.
- [Image](https://plasma.coveo.com/llms/components/Image.md): Displays a responsive image with configurable object-fit behaviour inside a sized container.
- [InfoToken](https://plasma.coveo.com/llms/components/InfoToken.md): Inline token for displaying semantic metadata with a predefined icon.
- [Input](https://plasma.coveo.com/llms/components/Input.md): Base input wrapper extended with a LabelInfo tooltip sub-component for contextual help.
- [Kbd](https://plasma.coveo.com/llms/components/Kbd.md): Renders keyboard key names or shortcuts in a styled monospace badge that visually resembles a physical key.
- [LastUpdated](https://plasma.coveo.com/llms/components/LastUpdated.md): Component that displays a human-readable last-updated timestamp with default or custom formatting.
- [Loader](https://plasma.coveo.com/llms/components/Loader.md): Animated spinner that communicates an ongoing asynchronous operation to the user.
- [Menu](https://plasma.coveo.com/llms/components/Menu.md): Dropdown menu with transparent support for disabled-state tooltips on `Menu.Item`.
- [Modal](https://plasma.coveo.com/llms/components/Modal.md): Overlay dialog that focuses user attention and can render a description, help link, and footer actions.
- [MonthPickerInput](https://plasma.coveo.com/llms/components/MonthPickerInput.md): Form input that opens a calendar popover for selecting a single month, multiple months, or a month range.
- [MultiSelect](https://plasma.coveo.com/llms/components/MultiSelect.md): Dropdown input that allows users to select multiple values from a predefined list, with optional search and clear capabilities.
- [NavLink](https://plasma.coveo.com/llms/components/NavLink.md): Navigation link component for sidebars and menus that supports active state, icons, badges, and nested child links.
- [Navigation](https://plasma.coveo.com/llms/components/Navigation.md): Sidebar navigation component with collapsible sections, active link tracking, and customizable accent colors.
- [Notification](https://plasma.coveo.com/llms/components/Notification.md): Toast notification that communicates the outcome of an action with info, success, warning, or error severity.
- [NumberInput](https://plasma.coveo.com/llms/components/NumberInput.md): Numeric text field with increment/decrement controls, configurable formatting, and optional prefix, suffix, and range constraints.
- [Pagination](https://plasma.coveo.com/llms/components/Pagination.md): Page navigation control that lets users move through a multi-page dataset with numbered pages, ellipsis, and optional first/last shortcuts.
- [PasswordInput](https://plasma.coveo.com/llms/components/PasswordInput.md): Password input with support for a read-only visual state.
- [Pill](https://plasma.coveo.com/llms/components/Pill.md): Compact tag-style element used to display a selected value or token, optionally with a remove button for multi-value inputs.
- [PrerequisitesList](https://plasma.coveo.com/llms/components/PrerequisitesList.md): Displays a list of prerequisites with status indicators (complete, incomplete).
- [Progress](https://plasma.coveo.com/llms/components/Progress.md): Horizontal bar that communicates how far along a task or process has advanced.
- [Prompt](https://plasma.coveo.com/llms/components/Prompt.md): Confirmation modal with semantic variants and optional footer actions.
- [Radio](https://plasma.coveo.com/llms/components/Radio.md): Single-selection control that lets users pick exactly one option from a visible set.
- [RadioCard](https://plasma.coveo.com/llms/components/RadioCard.md): Selectable card control that presents a radio option with a label, supporting text, and validation feedback.
- [ScrollArea](https://plasma.coveo.com/llms/components/ScrollArea.md): Container that clips overflowing content and adds a styled scrollbar within a fixed-height or fixed-width region.
- [SegmentedControl](https://plasma.coveo.com/llms/components/SegmentedControl.md): Compact toggle bar for switching between a small, fixed set of mutually exclusive views or modes.
- [Select](https://plasma.coveo.com/llms/components/Select.md): Select input for choosing a single option with support for a read-only visual state.
- [Skeleton](https://plasma.coveo.com/llms/components/Skeleton.md): Animated placeholder block that represents content still loading, preventing layout shift.
- [Slider](https://plasma.coveo.com/llms/components/Slider.md): Range input that lets users select a numeric value by dragging a thumb along a track.
- [StatusToken](https://plasma.coveo.com/llms/components/StatusToken.md): Status indicator with semantic color coding.
- [Stepper](https://plasma.coveo.com/llms/components/Stepper.md): Progress indicator that guides users through a linear multi-step flow with labelled, clickable steps.
- [StickyFooter](https://plasma.coveo.com/llms/components/StickyFooter.md): Action footer that remains fixed to the bottom of the viewport.
- [Switch](https://plasma.coveo.com/llms/components/Switch.md): Toggle control for a binary on/off setting, with optional group support for multiple related toggles.
- [Table](https://plasma.coveo.com/llms/components/Table.md): Table for displaying tabular data with optional filtering, pagination, row actions, and layout switching.
- [Tabs](https://plasma.coveo.com/llms/components/Tabs.md): Navigation pattern that organises related content into labelled panels, showing one at a time.
- [TextInput](https://plasma.coveo.com/llms/components/TextInput.md): Single-line text field for free-form string input, with support for icons, labels, descriptions, and validation.
- [Textarea](https://plasma.coveo.com/llms/components/Textarea.md): Multi-line text input for collecting longer-form free-text content such as descriptions, comments, or notes.
- [TimePicker](https://plasma.coveo.com/llms/components/TimePicker.md): Form input for selecting a specific time of day in 12-hour or 24-hour format, with optional seconds.
- [Tooltip](https://plasma.coveo.com/llms/components/Tooltip.md): Non-interactive popover that reveals supplementary text when a user hovers or focuses its trigger element.
- [YearPickerInput](https://plasma.coveo.com/llms/components/YearPickerInput.md): Form input that opens a year-grid popover for selecting one year, multiple years, or a year range.

## Content Guidelines

- [Glossary](https://plasma.coveo.com/llms/content/Glossary.md): Definitions for terms used in the Plasma design system. Use these definitions when interpreting or generating design-system-related content.
- [Content Guidelines — Product Vocabulary](https://plasma.coveo.com/llms/content/ProductVocabulary.md): Required spelling and capitalization for product terminology in the UI. Includes banned terms and approved replacements.
- [Content Guidelines — Target Audience](https://plasma.coveo.com/llms/content/TargetAudience.md): Who UX content in the Administration Console is written for, and how to write for them.
- [Content Guidelines — Voice](https://plasma.coveo.com/llms/content/Voice.md): Coveo's required voice qualities (clear, human, helpful) and how to apply tone by context.
- [Content Guidelines — Writing Mechanics](https://plasma.coveo.com/llms/content/WritingMechanics.md): Required rules for grammar, punctuation, capitalization, structure, and length in Coveo UX copy.

## Optional

Plasma re-exports ~90 Mantine components unchanged. For components not listed above, refer to Mantine's documentation — but always import from `@coveord/plasma-mantine`, not from `@mantine/*` packages.

- [Mantine component index](https://mantine.dev/llms.txt): index of all Mantine components
- [Mantine full documentation](https://mantine.dev/llms-full.txt): complete Mantine component docs (props, usage)