DS
Published-package documentation wired to the real DS runtime so the same routes reveal how tenant and engine reshape identical component contracts.
Rottay / modernPublished package
Premium Docs

Design System Showroom

Primary
#FFFFFF
Rottay
Radius
14px
Surface shape
DensitynormalPlatform Flagship
NavigatorLibrary map
8 sections212 routes
Foundations first, then primitives, patterns, structures, and surfaces. Keep this rail legible enough to scan without hunting.
Foundations4 documented routes
4
Tokens
Themes
109
93
24
36
3
1
2
Runtime fingerprintToken readout from the active provider chain.
Live DS
Runtime
PlatformRottay
Rottay / ModernPlatform Flagship
Primary
#FFFFFFSecondary #A0A0A5
Radius
Compact runtime evidence across 3+ token signals.
Published DS package · Pattern Library · Rottay / modernShared route metadata for the active runtime, kept inline so the shell reads like a thin header band.
Palette
#FFFFFFRottay
Chrome
Modernrenderer posture
Radius
14pxsurface shape
Density
normalPlatform Flagship
Patterns/Charts/CalendarHeatMap
TemporalRuntime-driven docs

CalendarHeatMap

Daily activity grid showing value intensity over calendar months
Continuous or scheduled time data where sequence and cadence are essential.
How to read this page
Use the sidebar showroom controls to change engine and tenant, then judge whether the chart still reads clearly without extra editorial staging around it.
TierChartA specialized visualization pattern.
Live preview

Validate the chart in the active showroom runtime

Sidebar engine and tenant drive thisTemporal
This preview should stand on the chart itself: legibility, token use, spacing, and interaction rhythm all need to hold without extra local storytelling chrome.
Loading chart preview...The interactive chart canvas mounts client-side so the docs page stays stable while the preview runtime boots.
ImportPublished package entrypoint, ready to copy.
tsx
1 line
Consumption
Runtime-aware snippet
import { CalendarHeatMap } from '@rottay/design-system';
UsagePaste-ready example that shows the base contract first.
tsx
11 lines
Consumption
Runtime-aware snippet
<CalendarHeatMap
  data={[
    { date: '2025-06-01', value: 3 },
    { date: '2025-06-15', value: 12 },
    { date: '2025-07-04', value: 8 },
  ]}
  startDate="2025-06-01"
  endDate="2025-09-30"
  height={180}
  animate
/>
API surface

Props

22 rows
CalendarHeatMap propsProp contracts stay readable across dark-first and light-first tenants.
22 props1 required21 optional
Fast readStart with required props, then scan defaults before dropping to per-row details.
Contract postureThis reference stays intentionally concise so the primitive contract remains scannable.
data
Required
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Related charts

Continue within Temporal

Browse all
GanttChartTemporal
Horizontal bar timeline for project scheduling and dependencies
SparklineTemporal
Compact inline SVG trend chart with area fill and end dot
Engines
Icons
Primitives93 documented routes
Display
Inputs
Feedback
Layout
Navigation
Overlay
PatternsCurrent section
49
Data
Forms
Visualization
Calendar View
Structures24 documented routes
Headers
Workspace
Shell
Record
Dashboard
Feedback
Surfaces36 documented routes
Admin
Data
Experience
Forms
Operations
Workspace
Verticals3 documented routes
Platform
Bit Hire
Evnto
Playground1 documented routes
Playground
Developers2 documented routes
Developers
14pxxl 18px
Density
normalBorder-light cards
Accent
Badge
roundedtop bar · solid dividers
PatternsVisualizationChartsCalendar Heatmap

Calendar Heatmap

Active profilePlatform Flagship
Runtime postureRottay / modern
D3-backed chart recipes with token-aware styling.
Runtime controls
TenantRottay
EngineModern
FamilyTemporalStart with time pacing.
Best forshowing schedulesCompare against basic charts.

Choose this when

3 items
showing schedules
compressing long histories
mapping activity over time

Review checklist

3 items
time pacing
range readability
cadence recognition

Compare against

2 items
basic charts
flow charts
ImportTSX
Quick copy
UsageTSX
Quick copy
Name
Type
Default
Required
Description
CalendarHeatMapDataPoint[]
none
Dated activity values.
startDate
Date | string
none
Visible range start; defaults to one year ago.
endDate
Date | string
none
Visible range end; defaults to today.
colorRange
[string, string]
none
Low/high intensity colors.
colorSteps
number
5
Number of discrete color steps.
cellSize
number
14
Day-cell size in pixels.
cellGap
number
2
Gap between day cells.
showMonthLabels
boolean
true
Displays month labels.
showDayLabels
boolean
true
Displays weekday labels.
formatTooltip
(date: Date, value: number) => string
none
Formats cell tooltips.
onCellClick
(date: Date, value: number) => void
none
Runs when a day cell is clicked.
colorScheme
ChartColorScheme
none
Named palette overriding the active tenant chart personality.
width
number | string
none
Chart container width; falls back to the family default.
height
number
none
Chart height; falls back to the family default.
className
string
none
Additional class name applied to the chart wrapper.
style
CSSProperties
none
Inline styles applied to the chart wrapper.
loading
boolean
false
Displays the governed loading state.
title
string
none
Accessible chart title displayed above the plot.
subtitle
string
none
Supporting text displayed below the title.
animate
boolean
none
Overrides the active tenant animation personality.
responsive
boolean
true
Measures and follows the container width.
tooltip
boolean
none
Enables the family tooltip behavior.
dataRequired
CalendarHeatMapDataPoint[]none
Dated activity values.
startDateOptional
Date | stringnone
Visible range start; defaults to one year ago.
endDateOptional
Date | stringnone
Visible range end; defaults to today.
colorRangeOptional
[string, string]none
Low/high intensity colors.
colorStepsOptional
number5
Number of discrete color steps.
cellSizeOptional
number14
Day-cell size in pixels.
cellGapOptional
number2
Gap between day cells.
showMonthLabelsOptional
booleantrue
Displays month labels.
showDayLabelsOptional
booleantrue
Displays weekday labels.
formatTooltipOptional
(date: Date, value: number) => stringnone
Formats cell tooltips.
onCellClickOptional
(date: Date, value: number) => voidnone
Runs when a day cell is clicked.
colorSchemeOptional
ChartColorSchemenone
Named palette overriding the active tenant chart personality.
widthOptional
number | stringnone
Chart container width; falls back to the family default.
heightOptional
numbernone
Chart height; falls back to the family default.
classNameOptional
stringnone
Additional class name applied to the chart wrapper.
styleOptional
CSSPropertiesnone
Inline styles applied to the chart wrapper.
loadingOptional
booleanfalse
Displays the governed loading state.
titleOptional
stringnone
Accessible chart title displayed above the plot.
subtitleOptional
stringnone
Supporting text displayed below the title.
animateOptional
booleannone
Overrides the active tenant animation personality.
responsiveOptional
booleantrue
Measures and follows the container width.
tooltipOptional
booleannone
Enables the family tooltip behavior.
Charts
18
Kanban Board
Map View
Timeline
Tree View
Communication
Feedback
Workflow
Navigation
Commerce
Customization
Identity
Shell