Arc
ComponentsBlocksScreensDocsPricingTry the demo
Get Pro
Saved

Docs

IntroductionInstallationThemingMotionAI and MCPChangelog

Components136

ButtonAction buttonSplit buttonButton groupFloating button groupExpanding button groupCopy buttonAction swapIcon morphConfirm morphTheme switcher

Hold to confirmSwipe actionsReactions

Dropdown menuContext menuUser menu

InputTextareaPassword fieldPassword strengthSearch fieldExpanding searchInline edit

Number fieldMoney inputPhone inputScrub inputTag inputMention inputShortcut recorder

SelectComboboxMulti-selectMorph selectChip group

Radio cardsBilling toggleCheckboxRadio groupSwitchSegmented controlRatingToggle group

SliderElastic sliderRange histogram sliderRuler sliderWindow rangeNewProLens rangeNewPro

CalendarDate pickerDate range pickerTime pickerColor pickerEmoji pickerPro

Rich text editorSignature padFile dropzoneAvatar uploadPro

TabsBreadcrumbPaginationMega menu morphProTable of contents progressPro

Scroll areaAccordionExpandable cardResizable panelsExpandable text

DialogDrawerBottom sheetPopoverHover cardTooltipShare accessProConfirm popoverPro

AlertToastToast stackAnnouncement barCookie consentUndo toastPro

ProgressSkeletonStepperCountdownUsage meterOnboarding checklist

AvatarAvatar groupBadgePresence stackPro

CardMetric cardEmpty stateMetric tickerPro

Line chartBar chartDonut chartStreamgraphBrush chartWaffle chartSlope chartSparklineGaugeActivity heatmapAnimated counterRidgelineTreemapSplit barPro

SunburstProSankey flowProFunnel chartProRadar chartProRealtime streamProRace bar chartProData gridPro

Sortable data tableTree tableTree viewReorderable listFilter toolbarCode blockJSON viewer

TimelineComment threadChat thread

Image compareCarouselCard stack

Text revealIn-view titleText morphText shimmer

Blocks122

KPI drilldownProMetric explorerProRevenue explorerProMRR waterfallProCohort retentionProUsage forecastProJourney flowProUptime statusProPivot builderProChoropleth explorerProConnected scatterProHorizon chartProAccount healthPro

Budget variancePro

Small multiplesProLine replayPro

AI chatProAI composerProAI answerProModel pickerProModel arenaProPrompt studioProDocument extractionProAgent memoryProAI side panelProAI inline editProResearch runProAI insight cardProCatch upProAI feature launchProAI search barProAI setup wizardProCall insightsProLead scoringPro

Agent runProAgent tasksProAgent approvalsProAgent routinesProAgent orchestratorProMCP serversProKnowledge baseProEval suiteProAgent builderProAgent galleryPro

SidebarPro4Page headerCommand paletteNotification centerSelection toolbarProEmpty statesSearch resultsPro

Login and sign up5, free and Pro variantsOnboarding illustrationProOTP inputMulti-step formProTwo-factor setupProMagic linkPro

Settings pageProSettings commandProSecurity settingsProBilling overviewProUsage billingProCancel flowProOnboarding surveyProSpend alertPro

Team membersProInvite peopleProRoles and permissionsProProfile pagePro

API keysProWebhooksProIntegrationsProImport wizardNewProEnvironment variablesProDomain verifyProWebhook testerPro

Plan comparisonPricing calculatorProUsage pricingProCart drawerProCheckout summaryProLive checkoutProSeat managerProCredit top-upPro

Wallet cardProDelivery trackerProSeat mapPro

Activity feedProSupport widgetProFeature votingPro

File uploadMedia playerPro

Availability pickerProRelease readinessProFeedback boardProSmart schedulerProTask breakdownProGoal trackerPro

Hero sectionHero signupPro

Scroll storyProSpotlight gridProFeature bentoProComparison table

Logo marqueeStudio perspectivesProStats band

Changelog feedFAQ sectionContact sectionTeam showcaseProBlog grid

Site headerSite footerCTA sectionNewsletter signup

Activity terrainProRevenue globeProCustomer galaxyProSemantic zoomProLayout morphProExploded viewPro

Screens14

Metrics dashboardProMarket terminalPro

Kanban boardProProject boardProGantt timelinePro

Week calendarProMonth calendarNewPro

Team directoryPro

Inbox triageProSupport conversationProHelp centerPro

Product listingProProduct detailProInvoice studioPro

Special components106

Share sheetProAction morphProMorph navProDockProLiquid tab barProOrbit menuPro

Glass menuProGlass segmentedProGlass cardProGlass tab barPro

Sheet stackProWallet stackProControl centerProHolo cardProCard to articleProLink unfurlPro

Product galleryProLightbox galleryProPhoto gridProCover flowPro

Voice orbProNow playingProVoice recorderPro

Booking pillProActivity ringsProTime dialProDate reelPro

Keycap keyboardProSlot textSand textProTypewriter terminalPro

Stretch refreshProMorph loaderProSkeleton morphProBlack holeProCharge sessionPro

Sticker peelProTicket tearProPage curlProOrbit logosProPrize wheelPro

Dot gridProImage trailProGravity wellProInk fluidProCursor trail drawPro

Agent statusProTool callProAgent planProAgent timelineProContext windowProReasoning blockProSource cardsProModel cardProAI workflowProCode suggestionProGhost textProImage generationProDictation buttonProSpeech playerProMeeting summaryProReply draftProAgent handoffProPII redactionProResponse feedbackProLLM cost calculatorProProvider keysProGeneration statsProAI translateProTL;DR toggleProConnector setupProSmart form fillProEnrich columnProTicket routerProAsk your dataProAgent cursorProProvider statusProTraining runProAI commandProStarter promptsProAI mascotProImage revealProAI sparkProPixel mascotProGhost mascotProCube mascotProTone tunerProUpgrade promptProReferral cardProTrial bannerProTeam switcherProLive visitorsProSocial proof toastProInstall snippetPro

Data flowProPayment flowProDNS resolutionProModel trainingProMulti-region failoverProVector searchProBranch graphProAgent loopProMixture of expertsProSpeculative decodingProPrompt cacheProReasoning treePro
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 · 122 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