/

Calendar Chart

Display data over time in a calendar grid layout. Ideal for daily activity, contribution history, and seasonal patterns.

Usage

example.tsx
import { CalendarChart } from "@chartts/react"

<CalendarChart
  data={commitHistory}
  startDate="2025-01-01"
  endDate="2025-12-31"
  colorScale={["#0f172a", "#10b981"]}
/>

Props

PropTypeDescription
data{ date: string; value: number }[]Date-value pairs
startDatestringStart date (YYYY-MM-DD)
endDatestringEnd date (YYYY-MM-DD)
colorScalestring[]Color range from low to high
cellSizenumberCell size in px. Default: 12

Features

  • GitHub-style contribution grid
  • Monthly labels
  • Day-of-week labels
  • Configurable color scales
  • Tooltip with date/value
  • Responsive cell sizing

Other Charts