Billing Toggle
Freev1.0.0A monthly and yearly switch for pricing pages, with the plan price updating.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { BillingToggle, PlanPrice, type BillingPeriod } from "@/components/ui/notchset/billing-toggle";
export function TeamPlanPrice() {
const [period, setPeriod] = React.useState<BillingPeriod>("yearly");
return (
<div className="grid gap-4">
<BillingToggle value={period} onValueChange={setPeriod} />
<PlanPrice monthly={99} yearly={79} period={period} />
</div>
);
}Props
value / onValueChange–"monthly" | "yearly"Controlled.
labels–{ monthly, yearly, save, saving, switch }The words.
PlanPrice–{ monthly, yearly, period, index?, unit? }A plan's rolling price; index staggers rows.
Anatomy
- No primitive needed: one file serves both builds.
- The knob is placed by left and right, so it stretches instead of sliding.
- The tag is fixed-width, so nothing jumps.
BillingToggledata-slot="billing-toggle"The control.
PlanPricedata-slot="plan-price"A price.
Source
components/ui/notchset/billing-toggle.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/billing-toggle.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/billing-toggle.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/billing-toggle.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
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
- Pricing pages and plan pickers with two billing periods
Use something else when
- More than two periods: use Segmented Control
Mistakes to avoid
- Pass yearly as the per-month price; show the yearly total yourself
Agents find it by
- billing toggle, monthly yearly, pricing switch, annual discount, plan price, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/billing-toggle.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- Space
- Switch
- Tab
- The period labels
Accessibility
- role=switch with a label; the period words are buttons too
- Prices are read as plain numbers (the rolling digits are hidden from screen readers)
Motion
- Switch
- The knob's leading edge moves first, the trailing edge 90ms later (300ms)
- Tag
- SAVE and SAVING pass each other (420ms after 80ms)
- Price
- Digits roll, ones first, 40ms apart (620ms); rows 60ms apart
Responsive
- A fixed row; prices keep their width.
Performance
- CSS transitions only.
Changelog
v1.0.0 · 2026-10-02
First release
