Billing Free Tier Status
A usage status card for free-tier accounts, listing each metered resource (storage, API calls, seats, and so on) as a labeled progress bar. Bars shift to amber past 80% used and to the destructive color once a limit is reached, with a short note explaining why. An upgrade button sits at the bottom for when someone needs more room.
Docs
Installation
A real shadcn registry command, not a copy-paste stand-in: it fetches this block plus its card, button dependencies and any missing npm packages, and installs them straight into your project.
npx shadcn add https://staaarter.com/r/billing-free-tier-status.jsonPrefer not to use the CLI? Copy the source from the Code toggle above into src/components/blocks/billing/billing61.tsx instead.
Usage
The file also exports billing61Demo, the exact props behind the preview above. Spread it to get a working section in one line, then replace it with your own data.
import { Billing61, billing61Demo } from "@/components/blocks/billing/billing61"; export default function Page() { return <Billing61 {...billing61Demo} />; }
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| heading | string | "Free plan usage" | Card heading. |
| description | string | none | Optional supporting text under the heading. |
| limits | UsageLimit[] | none | Resources rendered as progress bars, in the order given. |
| resetLabel | string | none | Optional note appended after the description, e.g. "Resets in 9 days." |
| upgradeLabel | string | "Upgrade plan" | Label on the bottom CTA button. |
| upgradeHref | string | none | Destination for the upgrade button. |
| className | string | none | Extra classes for the outer card. |
Types
interface UsageLimit { id: string; label: string; used: number; limit: number; unit?: string; }
Behavior notes
- Each bar's percentage is used / limit, clamped to 100 so it never overflows visually even if used exceeds limit.
- A bar turns amber at 80% or higher and switches to the destructive color at 100%, with a short status line underneath explaining which resource is affected.
- The limits array is rendered as-is; sort or filter it before passing it in if you want a specific order.
- The upgrade button is a plain anchor rendered through the Button component's render prop, so upgradeHref can point straight at a pricing or checkout route.
- This is a static display component with no local state; nothing here recomputes on the client beyond normal re-renders when props change.
Frequently asked questions
More Billing Blocks
View all →Billing Invoice List
Invoice history table with status badges, formatted amounts, and a per-row download link, built with shadcn/ui and Tailwind CSS.
Billing Failed Payment Alert
High-contrast failed-payment alert with a message, a retry button, and an optional update-payment-method button, built with shadcn/ui and Tailwind CSS.
Billing Credit Balance
Compact credit balance card with a large total, an optional purchased-versus-promotional breakdown, a low-balance notice, and a top-up button.
Billing Payment Methods
A saved payment method list for React and Next.js with brand icons, a default badge, near-expiry warnings, and remove/set-default actions per row.
Billing Add Card
A card entry form for React and Next.js with auto-formatted fields, internal brand detection, and per-field validation feedback built with shadcn/ui and Tailwind CSS.
Billing Coupon Code
An inline promo code input for React and Next.js with a simulated loading state, an applied summary showing the discount amount, and an invalid-code message.