Arc
ComponentsBlocksDocsPricingTry the demo
Get Pro
Introduction
Installation
Theming
Motion
AI and MCP
Changelog
Metrics dashboardPro
KPI drilldownPro
Metric explorerPro
Revenue explorerPro
MRR waterfallPro
Cohort retentionPro
Usage forecastPro
Journey flowPro
Uptime statusPro
Pivot builderNewPro
Choropleth explorerPro
Connected scatterPro
Horizon chartPro
Account healthPro
Market terminalPro
Budget variancePro
Small multiplesPro
Line replayPro
AI chatPro
AI composerPro
AI answerPro
Model pickerPro
Model arenaPro
Prompt studioPro
Document extractionPro
Agent memoryPro
AI side panelPro
AI inline editPro
Research runPro
AI insight cardPro
Catch upPro
AI feature launchPro
AI search barPro
AI setup wizardPro
Call insightsPro
Lead scoringPro
Agent runPro
Agent tasksPro
Agent approvalsPro
Agent routinesPro
Agent orchestratorPro
MCP serversPro
Knowledge basePro
Eval suitePro
Agent builderPro
Agent galleryPro
SidebarPro4
Page header
Command palette
Notification center
Selection toolbarPro
Empty states
Search resultsPro
Login and sign up5, free and Pro variants
Onboarding illustrationPro
OTP input
Multi-step formPro
Two-factor setupPro
Magic linkPro
Settings pagePro
Settings commandPro
Security settingsPro
Billing overviewPro
Usage billingPro
Cancel flowPro
Onboarding surveyPro
Spend alertPro
Team membersPro
Invite peoplePro
Team directoryPro
Roles and permissionsPro
Profile pagePro
API keysPro
WebhooksPro
IntegrationsPro
Environment variablesPro
Domain verifyPro
Webhook testerPro
Plan comparison
Pricing calculatorPro
Usage pricingPro
Cart drawerPro
Checkout summaryPro
Live checkoutPro
Seat managerPro
Credit top-upPro
Invoice studioPro
Wallet cardPro
Delivery trackerPro
Product listingPro
Product detailPro
Seat mapPro
Activity feedPro
Inbox triagePro
Support conversationPro
Support widgetPro
Help centerPro
Feature votingPro
File upload
Media playerPro
Week calendarPro
Availability pickerPro
Project boardPro
Gantt timelineNewPro
Release readinessPro
Kanban boardPro
Feedback boardPro
Smart schedulerPro
Task breakdownPro
Goal trackerPro
Hero section
Hero signupPro
Scroll storyPro
Spotlight gridPro
Feature bentoPro
Comparison table
Logo marquee
Studio perspectivesPro
Stats band
Changelog feed
FAQ section
Contact section
Team showcasePro
Blog grid
Site header
Site footer
CTA section
Newsletter signup
Activity terrainPro
Revenue globePro
Customer galaxyPro
Semantic zoomPro
Layout morphPro
Exploded viewPro
What’s new4 new
BlocksUsage forecast

Usage forecast

Pro

A billing period usage chart with a forecast cone and a draggable budget that dates the crossing.

Live block · sample data

Usage forecast

Northwind Labs · Scale plan · Renews Oct 1

AtthispaceyoureachthebudgetonSep26

4daysbeforetheperiodcloses,likelybetweenSep25andSep27.

API calls: At this pace you reach the budget on Sep 26. 4 days before the period closes, likely between Sep 25 and Sep 27.

Used so far
32.30012345678900123456789.00123456789M
85% of budget
Projected by Sep 30
45.20012345678900123456789.00123456789M
Likely 43.3–47.9M
Cost above budget
$1,449$00123456789,001234567890012345678900123456789
At $0.20 per 1k calls
Sep 1Sep 8Sep 15Sep 22Sep 29Today50%80%100%
010M20M30M40M50M
Budget380012345678900123456789M
Sep 26
Alert at
  • Actual
  • Forecast
  • Likely range
  • Over budget

Drag the budget line or use the arrow keys.

API calls, Sep 1 to 30, 2026
DateReadingLikely range
Sep 11.7MMeasured
Sep 23.3MMeasured
Sep 35.0MMeasured
Sep 46.7MMeasured
Sep 57.4MMeasured
Sep 68.1MMeasured
Sep 79.8MMeasured
Sep 811.5MMeasured
Sep 913.1MMeasured
Sep 1014.8MMeasured
Sep 1116.5MMeasured
Sep 1217.3MMeasured
Sep 1318.1MMeasured
Sep 1419.9MMeasured
Sep 1521.6MMeasured
Sep 1623.4MMeasured
Sep 1725.1MMeasured
Sep 1827.0MMeasured
Sep 1927.7MMeasured
Sep 2028.5MMeasured
Sep 2130.4MMeasured
Sep 2232.3MMeasured
Sep 23 (forecast)34.1M33.7 to 34.8M
Sep 24 (forecast)36.0M35.3 to 37.0M
Sep 25 (forecast)37.9M36.9 to 39.2M
Sep 26 (forecast)38.7M37.5 to 40.3M
Sep 27 (forecast)39.5M38.2 to 41.4M
Sep 28 (forecast)41.4M39.9 to 43.6M
Sep 29 (forecast)43.3M41.6 to 45.8M
Sep 30 (forecast)45.2M43.3 to 47.9M

When to use

  • Billing or usage pages that warn customers before they hit a budget.
  • Metered products that show month to date usage with a forecast range.

When not to use

  • Use usage-meter for a simple progress bar against a limit.
  • Use usage-pricing to estimate price from usage before buying.
  • Use metric-explorer for general KPIs without a budget.

Installation

Pro source and install commands unlock with a Pro plan.

Usage

Use this on a billing or usage page to warn before a customer hits a budget. Replace the readings in usage-data.ts with your metering data and connect the budget and alert rules to your billing settings; alert emails in the preview are simulated.

example.tsx
1import { UsageForecast } from "@/components/arc/blocks/usage-forecast/usage-forecast";2 3export default function BillingUsagePage() {4  return (5    <section>6      <UsageForecast />7    </section>8  );9}
Built fromSegmented controlAnimated counterText morph

API reference

UsageForecast

A billing period usage chart with a forecast cone, a draggable budget line and alert rules. Takes no props; readings and metrics are sample data in usage-data.ts, and alert emails are simulated.

No props.

Keyboard interactions

Arrow keys
On the plot, steps one day; on the budget handle, moves the budget one step.
Page uporPage down
Jumps a week on the plot, or five steps on the budget handle.
HomeorEnd
Jumps to the first or last day, or to the minimum or maximum budget.
Escape
Clears the inspected day on the plot.

Accessibility

  • The plot and the budget handle are role="slider" elements with aria-valuetext in plain words.
  • The chart SVG has a full sentence label and is described by a data table; a polite live region reads the forecast summary.
  • Alert rules are toggle buttons with aria-pressed and labels that include their current status.

Motion

  • The budget line follows drags directly and settles on a snappy spring when released or moved by keyboard.
  • The crossing marker and inspection panel follow the scrubbed day on springs; numbers roll with the animated counter.
  • Reduced motion drops the springs and applies changes immediately.

Responsive behavior

  • Chart width follows its container through a ResizeObserver, and below 560px KPIs and the legend tighten.
  • The plot uses touch-action pan-y for scrubbing, while the budget handle uses touch-action none so it can be dragged on touch.

Performance

  • SVG over daily readings for one billing period; the forecast cone is computed once per change, not per frame.
  • Dragging the budget updates one line and label; there is no loop at rest.

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

  • Use on a billing or usage page to warn customers before they hit a budget.
  • Replace METRICS and daily readings in usage-data.ts with your metering data.
  • Persist budget and alert rule changes to your billing settings; they are local state in the preview.
/components/blocks/usage-forecast/markdown

The full library index for assistants is at /llms.txt.

Related

Usage meterComponentShow what fills an allowance and how close it is to the limit.Usage pricingProBlockA pricing calculator that finds your plan as you drag seats and traffic.Billing overviewProBlockA billing page where the plan card morphs into a picker and usage, invoices, and card follow.Segmented controlComponentSwitch between a small set of related views.Metric explorerProBlockKPI cards that open into a scrubbable chart and morph between metrics and ranges.
PreviousUptime statusNextMRR waterfall
Arc · 134 block pagesllms.txt

On this page

  • Preview
  • When to use
  • When not to use
  • Installation
  • Usage
  • API reference
  • Keyboard
  • Accessibility
  • Motion
  • Responsive behavior
  • Performance
  • Notes for AI
  • Related
View as Markdown