Krizaka
Documentation
Composants

Credit usage

What is left of an allowance: the remaining amount in large, a meter that turns to warning then danger, the use per day and the day it runs out.

Web + MobileBêtaGraphiques

Web et mobile — le même composant pour React et React Native. Bêta : son API peut encore changer à une version mineure.

Pourquoi il est là. Orazaka's credits left and Orochia's allowance (PS-C ready-made charts).

Quand l’utiliser

  • Orazaka's billing: the credits left this month and when they run out at the current pace.
  • A storage plan (Orochia's console): gigabytes used of the plan, with a unit format.
  • Any quota that renews: API calls, minutes of video.

Quand ne pas l’utiliser

  • Money raised towards a goal.À la place : Goal progress
  • A value in a range with no notion of running out (a load, a score).À la place : Gauge

Installation

Installer

npm install @krizaka/charts

Importer

import { CreditUsage } from "@krizaka/charts/credits";

Exemples

Monthly credits

An Orazaka plan: credits left, the daily use, the run-out date.

Credits this month

Pro plan

1,880credits left of 5,000

3,120 used (62.4%)Renews on Nov 1, 2026

Use per day

Sparkline, 14 (1 – 14). Use per day: from 120 to 300, lowest 60 (7), highest 310 (10), up 150%.

Use per day — data
CategoryUse per day
1120
2180
395
4210
5260
6140
760
875
9230
10310
11280
12190
13240
14300

At this pace, runs out on Oct 19, 2026

Storage plan

Orochia's console: gigabytes of the plan, past the warning level.

Platform storage

Bunny Stream · Growth plan

258 GBfree of 2,000 GB

1,742 GB used (87.1%)

Props

What is left of an allowance: the remaining amount, a meter in tones, the use per day and the run-out date.

PropTypeDéfautDescription
limitrequisnumber—The allowance.
titlerequisstring—What the allowance is (“Credits this month”): the heading and the meter's name.
usedrequisnumber—How much is used.
brandBrandId—The brand whose palette the charts use. Without it, a chart follows a .brand-<id> ancestor, else Krizaka. Set it when the app loads a brand stylesheet on :root (@krizaka/tokens/brands/orazaka.css).
classNamestring—A class on the figure (layout).
dailyreadonly (number | null)[]—The use of each recent day, oldest first: the sparkline and the projection.
daysreadonly unknown[]—The days of daily (ISO dates), for the sparkline's summary.
descriptionReactNode—A line under the title: the plan, the period.
formatValueFormatintegerHow the amounts are written. Default "integer"; a { style: "unit", unit: "gigabyte" } for storage.
hideTitleboolean—Visually hide the title (it stays the accessible name).
labelsPartial<CreditLabels>—The words, passed translated; English by default.
levelsreadonly [number, number][0.8, 0.95]The share where the meter turns to warning, then danger. Default [0.8, 0.95].
loadingboolean—The data is on its way.
localeLocale—The locale of every figure and date ("fr-FR"). Default "en-US".
nowDate—Today, for the projection (pass it from the server to render the same date on both sides). Default: now.
renewsAtstring | Date—When the allowance renews (an ISO date or a Date).
styleCSSProperties—Inline style on the figure (layout only).

Accessibilité

  • The meter is a meter named by the title, its value said in words (“3,120 used (62 %)”).
  • The warning and danger tones come with words: the projection says when it runs out.

Bonnes pratiques

  • Pass the use of the recent days: the projection and the sparkline need it.
  • Pass now from the server when the page is server-rendered: both sides write the same date.
  • Lead with what is left, not what is used: it is what people decide on.

Générée depuis le code de @krizaka/ui 3.6.0 : son meta.ts, ses exemples et ses types.Modifier cette documentation sur GitHub

Sur cette page