Add-on Cart
Prov1.0.0An add-on store for an existing plan that shows the prorated cost today and the next bill.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { AddonCart } from "@/components/ui/notchset/blocks/addon-cart";
export function Capacity() {
return (
<AddonCart
context="ACME LABS · TEAM PLAN"
addons={[{ id: "seats", glyph: "+1", name: "Extra seat", description: "One more person.", price: 29, unit: "MO PER SEAT", max: 20 }]}
planPrice={990}
planLabel="TEAM PLAN"
nextBill="NOV 01"
proration={{ fraction: 0.6, label: "18 OF 30 DAYS" }}
onCheckout={(lines) => fetch("/api/addons", { method: "POST", body: JSON.stringify(lines) })}
confirmation={(n) => `Added ${n} to Acme Labs`}
/>
);
}Props
addons–{ id, glyph, name, description, price, unit, max, active? }[]The cards; active means already on the plan.
planPrice / planLabel / nextBill–number / string / stringThe plan's line and the next bill's date.
proration–{ fraction, label }Today's share of the month ("18 OF 30 DAYS" → 0.6).
onCheckout / confirmation / currency–(lines) => Promise / (count) => string / (n) => stringAdd the cart to the subscription (resolve to confirm), the confirmation line, money formatting.
Anatomy
- One block with its own stepper and drawer.
- Prices and proration are data you pass.
- Adding to the subscription is your onCheckout.
AddonCartdata-slot="addon-cart"Cards, cart chip and the drawer.
Source
components/ui/notchset/blocks/addon-cart.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Build for your project
Code/install build
Installation
pnpm dlx shadcn@latest add @beautiful-ui-pro/addon-cartNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Selling seats, runs or features on top of a subscription
- Upgrades where the prorated charge today should be clear
Use something else when
- A first purchase: use Checkout
- Changing plans: use Plan Compare
Mistakes to avoid
- Proration comes from your billing API; the block only multiplies for display
- Undo must restore the exact quantity removed
Agents find it by
- add-ons, cart, extra seats, capacity, upsell, subscription add-ons, proration, billing drawer, Notchset
Where agents read it
- Guide for this component: https://beautiful-ui.dev/md/addon-cart.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://beautiful-ui.dev/api/mcp(setup)
Behaviour
Keyboard
- Esc
- Close the drawer
- Tab
- Cards, the cart and the drawer's controls
Accessibility
- The drawer is a modal dialog named Cart; focus moves into it and returns to the cart button when it closes (Esc, ×, or the scrim)
- Steppers name their action (More Extra seat); a capped + is aria-disabled
- Undo and the confirmation are announced
Motion
- Cart chip
- Bumps when the count changes (260ms bloom)
- Drawer
- Opens over 420ms (unfold) and closes over 280ms
- Amounts
- Line totals, the next bill and today's charge roll
- Remove
- The line goes and UNDO stays for 4.5s
Responsive
- Cards wrap at 250px; the drawer is 380px or the full width.
Performance
- One timer for the undo bar; nothing else runs while idle.
Changelog
v1.0.0 · 2026-10-04
First release
Part of
Included with Pro
Pro is in early access.
