render_hero_metric
Create visual hero metric widgets to display key performance indicators with variants for trends, progress, status, comparisons, rankings, and specialized contexts.
Instructions
Render a purpose-driven hero metric widget. Pick the variant that answers your question:
big_number: 'How much? Which direction?' Default hero metric - clean, professional, works in any context. Large value + trend arrow + optional sparkline. Params: value, unit, change, changePeriod, sparkline[]
progress_ring: 'How close to goal?' Animated ring or half-gauge. Params: value, unit, label, progress (0-100), style ('ring'|'gauge'), size, color
status: 'Good or bad?' Pulsing dot + subsystem badges. Params: label, statusLevel ('good'|'warn'|'bad'), subsystems[{name,status}], count, peak
comparison: 'How do we compare?' Before/after + improvement. Params: before, after, improvement, beforeLabel, afterLabel
rank: 'Where do I stand?' Badge + percentile. Params: rank, total, percentile, rankChange
countdown: 'How long left?' Time segment boxes. Params: segments[{value,label}] OR deadline (ISO date)
threshold: 'Above or below limit?' Gradient bar + marker. Params: value, max, threshold, unit, zones[{label,from,to,color}]
breakdown: 'What is the split?' Stacked bar + legend. Params: items[{label,value,color?}]
nps: 'How satisfied?' Score + rating scale. Params: value, max (default 100), rating ('good'|'neutral'|'bad')
orb: 'What is the headline?' Dramatic glowing sphere. Use golden orb for resumes/portfolios. For tech meetings use only black, white, or crystal-colored orbs as subtle flair. Best with dark themes (tokyo-midnight, ops-control, startup). Avoid for formal contexts (boardroom, clinical, consultant). Params: value, unit, label, color
gem: 'Premium gem metric' Faceted/spherical gem - for wealth, fintech, trading, crypto, luxury contexts ONLY. Best with golden-treasury, tokyo-midnight themes. Do NOT use for corporate, clinical, consultant, or boardroom dashboards - use big_number instead. Params: value, unit, label, gemType. gemTypes: crystal='Future' (forecasts, projections) | black_pearl='Rare find' (alt investments, crypto) | golden_pearl='Treasure' (gold, commodities) | white_pearl='Clean total' (savings) diamond='Crown number' (net worth, total revenue) | ruby='What's critical' (urgent, burn rate) | sapphire='Foundation' (stability, uptime) | emerald='Growth' (YoY, appreciation)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Chart title | |
| variant | No | Widget variant (default: big_number) | |
| value | No | Main metric value | |
| unit | No | Unit label (e.g. 'grams', '%', 'USD') | |
| label | No | Sub-label | |
| color | No | Override accent color (hex) | |
| progress | No | Ring fill 0-100 | |
| size | No | Size: sm/md/lg/xl | |
| style | No | progress_ring style | |
| change | No | Percentage change | |
| changePeriod | No | Period label for change (e.g. 'vs last month') | |
| sparkline | No | Mini bar sparkline data | |
| statusLevel | No | Status level | |
| subsystems | No | Subsystem badges | |
| count | No | Live count | |
| peak | No | Peak count | |
| before | No | Before value | |
| after | No | After value | |
| improvement | No | Improvement label | |
| beforeLabel | No | Before column label | |
| afterLabel | No | After column label | |
| rank | No | Current rank | |
| total | No | Total in ranking | |
| percentile | No | Percentile | |
| rankChange | No | Positions moved | |
| segments | No | Time segments | |
| deadline | No | ISO deadline date | |
| max | No | Maximum value for threshold/nps | |
| threshold | No | Threshold limit line | |
| zones | No | Color zones | |
| items | No | Breakdown items | |
| rating | No | NPS rating override | |
| gemType | No | Gem type for variant=gem: diamond, ruby, sapphire, emerald, golden_pearl, white_pearl, black_pearl, crystal | |
| theme | No | Theme preset: boardroom, corporate, sales-floor, golden-treasury, clinical, startup, ops-control, tokyo-midnight, zen-garden, consultant, black-tron, black-elegance, black-matrix, forest-amber, forest-earth, sky-light, sky-ocean, sky-twilight, gray-hf, gray-copilot | |
| palette | No | Override palette only (mix-and-match) | |
| typography | No | Override typography: professional, luxury, cyberpunk, editorial, mono, bold, system, techno | |
| effects | No | Override effects: none, subtle, shimmer, neon, energetic |