Staaarter

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.

By Staaarter Team
Billing
Updated July 6, 2026
Docs
Live preview

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.json

Prefer 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

PropTypeDefaultDescription
headingstring"Free plan usage"Card heading.
descriptionstringnoneOptional supporting text under the heading.
limitsUsageLimit[]noneResources rendered as progress bars, in the order given.
resetLabelstringnoneOptional note appended after the description, e.g. "Resets in 9 days."
upgradeLabelstring"Upgrade plan"Label on the bottom CTA button.
upgradeHrefstringnoneDestination for the upgrade button.
classNamestringnoneExtra 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