Pluma
v5.14.0
Theme
Auto
Overview
About
Agent skill
MCP server
CLI
plan
scaffold
upgrade
report-gap
Codemods
5.0.0
Color Variant Rename
Text Icon Color Rename
Theme Tokens Rename
3.0.0
Button Variant Rename
Css Token Rename
Data Table Tanstack V9
Deprecated Props Removal
Event Handler Rename
Icon Deprecations
Label Icon To Coin
Label To Badge
Primitive Rename
Size Longhand Rename
Test Helper Get Rename
Text Size Shorthand Rename
Toggle Button To Button
2.204.0
Flex To Stack
2.170.0
Banner Description Prop
Getting started
Contributing
Breaking changes
Migrating to v3
Migrating to v5
Changelog
Foundations
Icons
Interaction states
Motion
Principles
Responsive layout
Style utilities
Content
Grammar and mechanics
Voice and tone
Word list
Writing for AI features
Writing for product
Tokens
Using Pluma tokens
All Tokens
Color
Spacing
Typography
Elevation
Motion
AI
Components
Status
Test helpers
Layout
Accordion
AccordionGroup
AppLayout
AspectRatio
Box
Card
CenterBaseline
Divider
EmptyState
Flex
FormLayout
Grid
InlineStack
Panel
Scrollable
SplitView
Stack
Typography
Code
DescriptionList
Emphasis
Heading
List
Paragraph
Strong
Text
TextLabel
Truncated
Content
Avatar
CodeBlock
Coin
Icon
Image
Navigation
Breadcrumbs
Link
NavItem
Page
Pagination
PlainLink
SetupFlow
SideNav
Stepper
Tabs
TabNav
Buttons
Button
ButtonGroup
CloseButton
DropdownMenu
PlainButton
Forms
Checkbox
CheckboxGroup
ColorPicker
Combobox
ConditionEditor
Alpha
DatePicker
FileField
Form
JsonField
NumberField
OptionCard
OptionCardGroup
Radio
RadioGroup
Search
SegmentedControl
Select
SelectPalette
Slider
TextArea
TextField
Toggle
Data display
Badge
ConditionViewer
DataTable
Filters
FormattedDateTime
FormattedRelativeTime
KeyboardShortcut
ProgressBar
ProgressCircle
StatusIndicator
Table
Tag
Timeline
Feedback
Banner
PageLoader
SkeletonShape
SkeletonText
Snackbar
Spinner
Overlays
Blanket
ConfirmationModal
Drawer
Drawer manager
Modal
Modal manager
Popover
Tooltip
Misc
VisuallyHidden
Data visualization
Colors
Chart
Alpha
Marks
Line and area
Bar
Sparkline
Dot
Arc
Sankey
Reference line
Axes
Series and legend
Interaction
Animation
Exporting
Patterns
Density
List page
Menu keyboard shortcuts
Setup flow with a preview
States
Wizard layout
Recipes
Choose a type
Dashboard overview
Editor with preview
List with drawer detail
List with filters
Object detail
Segment builder
Settings form
Setup wizard
Empty state with call to action
Form section
Panel with description list
Advanced
Ember Floating UI
Ember prop spreading
ESLint plugin
tooltip-custom-interactive
no-banned-imports
enforce-pluma-elements
no-deprecated-apis
no-deprecated-icons
no-raw-pluma-classnames
no-raw-pluma-css-variables
require-form-control-label
prefer-managed-modals
no-ineffective-stack-props
no-raw-html-elements
prefer-stack-over-flex
require-accessible-name
sprinkle-values-are-literals
prefer-resolved-vars
Item
PlainItem
PlainModal
PlainPopover
PlumaProvider
Portal
React yield
Fly Migration
fly-alert
fly-btn
fly-close
fly-label
fly-panel
fly-range
Forms
Lists
Tailwind
Components
v5.14.0
Icons
v2.1.0
MCP
v0.10.12
Tokens
v2.0.0
Foundations
Explore the design principles, tokens, content guidance, and utilities behind Pluma.
Pages
Icons
Icons are used to visually communicate core actions and concepts in the product. They are used to enhance the user experience and provide visual cues to help users understand the product.
Interaction states
Which helper to use for hover, pressed, disabled and scope backgrounds when you write your own styles for a Pluma component or a one-off element.
Motion
Guidelines for using motion purposefully, accessibly, and consistently across Customer.io interfaces.
Principles
Guiding ideas to building Customer.io interfaces.
Responsive layout
Breakpoints, media queries, responsive style utilities and hooks for layouts that adapt to the viewport.
Style utilities
All Pluma components accept a set of utility props to aid with layout and styling.
Content
How to write copy across Customer.io interfaces.
Grammar and mechanics
Capitalization, punctuation, and how to format numbers, time, and dates.
Voice and tone
How Customer.io sounds, how tone adjusts to context, and how to address people directly and inclusively.
Word list
Word choices to use consistently across Customer.io interfaces.
Writing for AI features
Copy rules for the Agent and other AI-driven features, including naming, hedging, and outcome-first framing.
Writing for product
Copy patterns for buttons, dialogs, empty states, onboarding, errors, and accessibility that span components.
Tokens
Design tokens for color, spacing, typography, elevation, motion, and AI surfaces. Browse the full list or a single category.
Using Pluma tokens
How primitive and semantic tokens relate, how a semantic token's name reads, and how the color tokens use both.
All Tokens
Design tokens for colors, spacing, typography, and more
Color
Palette primitives, semantic fills and text colors, the shared data visualization layer, and component colors.
Spacing
Space, border width, and border radius tokens.
Typography
Font family, size, and weight primitives plus composite text styles.
Elevation
Box shadow and filter shadow tokens for depth and focus.
Motion
Duration and easing tokens, with live previews of each timing and curve.
AI
Fill and ring tokens for AI surfaces and affordances.
Theme
Auto