EEnterUI
DocsComponentsThemesDonation
Get Started
      • StatGrid
      • KPISection
      • UsageMeter
      • PlanUsage
      • FileList
EnterUIDocsProduct OperationsProduct SurfacesUsage and FilesUsageMeter
Product OperationsUpdated 6 May 2026

UsageMeter

Reusable horizontal usage meter primitive with auto-derived warning and error tones.

UsageMeter is the building block for "X used out of Y" surfaces. Tone auto-shifts when the value crosses configurable thresholds.

#Default usage

API usage

Defaults to neutral; auto-shifts to warning at 75% and error at 95%.

API calls7500 / 10000
Code
<UsageMeter label="API calls" limit={10000} value={7500} />

#Import

Code
import { UsageMeter, type UsageMeterTone } from "@froggdesign/enter-ui-react";

#Accessibility

Renders with role="meter" plus aria-valuemin/max/now. The label doubles as aria-label when it's a string.

#API

  • value, limit: required numbers.
  • tone: optional override ("neutral" | "success" | "warning" | "error").
  • thresholds: ratios (0–1) for warning/error tone derivation.
  • formatValue(value, limit): customise the right-hand display (default ${value} / ${limit}).
  • description: muted line below the bar.

#Styling

Every exported component accepts className. EnterUI styles use .eui-* classes and --eui-* variables mapped from FroggDesign theme tokens.

PreviousKPISection
NextPlanUsage

On this page

  1. Default usage
  2. Import
  3. Accessibility
  4. API
  5. Styling