ColorSwatchPicker

A grid of color swatches for picking from a predefined palette.

Basic

Prop	Type	Default	Description
`colors`	`string[]`	—	Array of hex color strings to display as swatches.
`value`	`string`	—	The selected color value (controlled).
`defaultValue`	`string`	—	The initial selected color value (uncontrolled).
`onValueChange`	`(value: string) => void`	—	Called when the selected color changes.
`swatchSize`	`number`	`32`	Size of each color swatch in pixels.
`--mantle-bg`	`CSS variable`	`theme default`	Override the background color via style. e.g. style={{ "--mantle-bg": "#1a1a2e" }}
`--mantle-border`	`CSS variable`	`theme default`	Override the border color via style. Set to "transparent" to remove. e.g. style={{ "--mantle-border": "#e94560" }}
`--mantle-text`	`CSS variable`	`theme default`	Override the text color via style. e.g. style={{ "--mantle-text": "#ffffff" }}
`--mantle-ring`	`CSS variable`	`accent`	Override the focus ring color via style. e.g. style={{ "--mantle-ring": "#e94560" }}

colors

string[]

Array of hex color strings to display as swatches.

value

string

The selected color value (controlled).

defaultValue

string

The initial selected color value (uncontrolled).

onValueChange

(value: string) => void

Called when the selected color changes.

swatchSize32

number

Size of each color swatch in pixels.

--mantle-bgtheme default

CSS variable

Override the background color via style. e.g. style={{ "--mantle-bg": "#1a1a2e" }}

--mantle-bordertheme default

CSS variable

Override the border color via style. Set to "transparent" to remove. e.g. style={{ "--mantle-border": "#e94560" }}

--mantle-texttheme default

CSS variable

Override the text color via style. e.g. style={{ "--mantle-text": "#ffffff" }}

--mantle-ringaccent

CSS variable

Override the focus ring color via style. e.g. style={{ "--mantle-ring": "#e94560" }}