nextui.dev
Home
Docs
Saved
Pricing
Components37
  • Forms & inputs7
  • Cards13
  • Buttons, badges & avatars8
  • Feedback & display6
  • Effects3
Agents17
  • Chat inputNew
  • Task checklistNew
  • ReasoningNew
  • Tool callNew
  • Tool approvalNew
  • SourcesNew
  • Agent timelineNew
  • Artifact panelNew
  • Streaming messageNew
  • Conversation shellNew
  • Voice agentNew
  • Voice orbNew
  • Thinking ring
  • Thinking waveNew
  • Thinking sparkle
  • Thinking bot
  • Prompt deckNew
Blocks20
  • Agent chatNew
  • Pill heroNew
  • Grid hero
  • Moodboard generatorNew
  • Waitlist heroNew
  • Intro bannerNew
  • Creative home heroNew
  • Chat heroNew
  • App shelfNew
  • Usage card
  • Design resultsNew
  • Pricing tiers
  • Dashboard home
  • The shiftNew
  • Launch perksNew
  • Testimonials
  • Quote
  • Team
  • Leads tableNew
  • Sign in
Pages10
  • ASCII workspace$49
  • CRM overviewNew
  • Marketing dashboardNew
  • Developer portfolio$49
  • Particle landing$49
  • Particle story$49
  • Statement converter$49
  • AI photo studio$49
  • Group card launch$49
  • Month-end storyNew
Themes9
  • Default
  • Ember
  • Ocean
  • Forest
  • Grape
  • Rose
  • Amber
  • Clay
  • Brutal
Upgrade
nextui.dev

nextui components, blocks and themes you install with one command.

Product

  • Components
  • Blocks
  • Themes
  • Pricing

Resources

  • Docs
  • Roadmap
  • GitHub

Legal

  • License
  • Privacy
  • Terms
  • Refunds

nextUI

[ 200 OK ] · nextUI

© 2026 NEXTUI • All rights reserved.

Upgrade
BlocksUsage card
Copy promptCopy prompt

Customize

Workspace or product name in the header

Muted line under the name

Credit allowance the bar and percentage use

10000

Seats allowed

10

Storage allowed, in GB

5 GB

Footer button while under the limit

Footer button once the limit is reached

JSX · copied with Copy prompt

<UsageCard />

Usage card

Animated credit usage card with period tabs, stacked breakdown, daily chart and plan limits.

Installation

Set your access key from API keys as NEXTUI_TOKEN in .env.local and add the @nextui namespace below to components.json once. Then every item installs by name. Each install counts as a copy on a free account.

$pnpm dlx shadcn@latest add @nextui/usage-card
1{
2 "registries": {
3 "@nextui": {
4 "url": "https://nextui.dev/r/{name}.json",
5 "headers": { "Authorization": "Bearer ${NEXTUI_TOKEN}" }
6 }
7 }
8}

Usage

1"use client";
2
3import { UsageCard } from "@/components/blocks/usage-card";
4
5export function Billing() {
6 return (
7 <UsageCard
8 name="Northwind"
9 planLabel="Team plan · Resets in 4 days"
10 limit={20_000}
11 periods={{
12 month: {
13 label: "This month",
14 total: 12_400,
15 sources: [
16 { name: "Chat", credits: 8_000 },
17 { name: "API", credits: 4_400 },
18 ],
19 days: [400, 520, 610, 380, 450],
20 slots: 30,
21 dayLabel: (i) => `Nov ${i + 1}`,
22 seats: 6,
23 storage: 1.4,
24 projects: 9,
25 },
26 }}
27 onUpgrade={() => location.assign("/billing")}
28 />
29 );
30}

API reference

Edit props live in the preview above, or see all 15 props
PropTypeDefaultDescription
namestring"Acme AI"Workspace or product name in the header
planLabelstring"Pro plan · Resets in 9 days"Muted line under the name
periodsRecord<string, UsagePeriod>This month, Last month, 7 daysTabs keyed by id: totals, sources, daily credits and limits used
periodstring–Controlled selected period id
defaultPeriodstringfirst keyPeriod selected on first render
onPeriodChange(period: string) => void–A tab was clicked
limitnumber10000Credit allowance the bar and percentage use
seatLimitnumber10Seats allowed
storageLimitnumber5Storage allowed, in GB
shadesRecord<string, string>Chat, Search, Image, APITailwind background class per source name
upgradeLabelstring"Upgrade"Footer button while under the limit
addCreditsLabelstring"Add credits"Footer button once the limit is reached
onUpgrade() => void–Upgrade was clicked
onAddCredits() => void–Add credits was clicked
classNamestring–Extra classes on the section

Related

All blocks

Design resultsNew

Pricing tiers

Sign in to see the code

Preview it freely. A free account copies code and prompts a few times a day.

Sign in