PricingPlan
PricingPlanComplete offer A complete plan card with a price, billing period, feature list and navigation action.
Landing & pricingA plan with all its context
The price and period are display text, so the application owns currency formatting and billing logic.
PricingPlan puts the plan name, price, and features in a clear reading order. The action and note stay at the bottom so neighboring plans remain easy to compare. An icon or badge adds context without competing with the price.
Studio workspace
A home for the projects you want to bring to life.
- Unlimited example projects
- A shared component library
- Theme-aware documentation
Your own workspace
A flexible starting point for something a little different.
- Choose the scope you need
- Bring your own content and integrations
A price, a readable feature list, and a clear next step, even with different amounts of content.
<Grid columns="1" columnsXl="2" alignItems="stretch" class="gap-4">
<PricingPlan
title="Studio workspace"
summary="A home for the projects you want to bring to life."
price="$24"
period="/ month"
badge="Popular"
icon="lucide:layers"
note="Illustrative pricing. No purchase is available."
ctaLabel="Explore components"
ctaLink="/components/"
tone="accent"
>
<PricingFeature tone="accent">Unlimited example projects</PricingFeature>
<PricingFeature tone="accent">A shared component library</PricingFeature>
<PricingFeature tone="accent">Theme-aware documentation</PricingFeature>
</PricingPlan>
<PricingPlan
title="Your own workspace"
summary="A flexible starting point for something a little different."
price="Custom"
icon="lucide:users"
note="Illustrative plan. Configure it for your own product."
ctaLabel="Read the guides"
ctaLink="/guides/"
tone="neutral"
variant="surface"
>
<PricingFeature>Choose the scope you need</PricingFeature>
<PricingFeature>Bring your own content and integrations</PricingFeature>
</PricingPlan>
</Grid> A quiet plan without an action
Omit either CTA prop to leave out the link. A note can explain how to proceed.
Custom workspace
A configuration you define.
- Flexible composition
<PricingPlan
title="Custom workspace"
summary="A configuration you define."
price="Custom"
note="Use this layout with your own plan data."
variant="surface"
>
<PricingFeature>Flexible composition</PricingFeature>
</PricingPlan> All ten semantic tones
The same composition in every semantic tone. Child tones are explicit where the composition owns them, including navigation actions.
neutral Plus
Room to build together.
- Theme-aware components
accent Plus
Room to build together.
- Theme-aware components
feature Plus
Room to build together.
- Theme-aware components
secondary Plus
Room to build together.
- Theme-aware components
custom Plus
Room to build together.
- Theme-aware components
ghost Plus
Room to build together.
- Theme-aware components
info Plus
Room to build together.
- Theme-aware components
success Plus
Room to build together.
- Theme-aware components
warning Plus
Room to build together.
- Theme-aware components
danger Plus
Room to build together.
- Theme-aware components
Switch the site theme to compare the same samples in both palettes.
All eighteen visual variants
Every supported variant is shown in accent, including none. Variant controls the outer treatment; nested content may use its own treatment.
solid surface Plus
Room to build together.
- Theme-aware components
surfaceAlt Plus
Room to build together.
- Theme-aware components
spotlight Plus
Room to build together.
- Theme-aware components
glass Plus
Room to build together.
- Theme-aware components
flat Plus
Room to build together.
- Theme-aware components
flatAlt Plus
Room to build together.
- Theme-aware components
flatSolid outlineFill outline Plus
Room to build together.
- Theme-aware components
subtle Plus
Room to build together.
- Theme-aware components
subtleBtn Plus
Room to build together.
- Theme-aware components
link Plus
Room to build together.
- Theme-aware components
sheen underline Plus
Room to build together.
- Theme-aware components
rail bracket Plus
Room to build together.
- Theme-aware components
none Plus
Room to build together.
- Theme-aware components
Switch the site theme to compare the same samples in both palettes.
Both variant modes
Hover these outlineFill examples to compare stateless and stateful treatments. Stateful styling adds interaction states; it does not turn a container into a button.
stateless stateful Switch the site theme to compare the same samples in both palettes.
Price, decoration, and action conditions
Free planSolo
A personal starting point.
- Shared themes
Custom priceCustom
- Define your own scope
No price or CTAIncluded capabilities
A feature summary can stand alone.
- Readable source
Rich feature contentTeam
- Shared components
A consistent starting point across your workspace. - Review your own deployment requirements
The component formats no money and performs no checkout. Each CTA requires both ctaLabel and ctaLink; features are native list items.
Feature map
| Public feature | Visible example |
|---|---|
| variant, variantMode, tone | Complete galleries above, with all supported values visible together. |
| title, summary | Compare the free plan, custom plan, and capabilities card. |
| price, period | Free, monthly, custom, and omitted prices are visible together. Period appears only alongside a price. |
| icon, badge | The complete original card includes both; custom price is badge-only and the capabilities card is icon-only. |
| note | The free and rich-feature plans clarify billing context and limits below their features. |
| ctaLabel, ctaLink | Free and team plans navigate to real guides. Custom and capabilities cards omit the CTA; both props are needed to render it. |
| Default slot | PricingFeature children form a native list, with simple and rich detail examples. |
| Native attributes and events | Pass attributes through the root; keyboard behavior belongs to the composed native controls. |
Behavior and accessibility
Use clear billing text and disclose relevant limits alongside the price. A CTA is rendered only when both ctaLabel and ctaLink are set. There is no checkout behavior built into the component.
API reference
PricingPlan contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
title
RefOrValue<string> - Default
not set
Visible heading. Choose a short title that identifies the content or task.
summary
RefOrValue<string> - Default
not set
A concise explanation beneath the heading.
price
RefOrValue<string> - Default
not set
Display price. May include currency or non-numeric text.
period
RefOrValue<string> - Default
not set
Billing period displayed with the price.
badge
RefOrValue<string> - Default
not set
Optional compact label rendered with Badge.
note
RefOrValue<string> - Default
not set
Supporting note after the features and action.
variant
RefOrValue<ComponentVariant> - Default
surface
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
variantMode
RefOrValue<ComponentVariantMode> - Default
stateless
Use stateless for content surfaces; stateful enables the treatment’s hover, focus and active styles. It does not add interaction handlers.
icon
RefOrValue<string> - Default
not set
Registered SVG icon name. In browser apps, include the icon in the resolver passed to defineIconComponents.
ctaLabel
RefOrValue<string> - Default
not set
CTA link text. Requires ctaLink.
ctaLink
RefOrValue<string> - Default
not set
CTA destination. Requires ctaLabel.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
Composition
Default slot: PricingFeature list items inside the generated ul. Register definePricingComponents and its layout, text, button and icon dependencies.