Skip to content
ProData

Contribution Grid

A 52-week activity grid that fills in day by day with a color scale. Hover to see each day's date and count.

Plan
Pro · commercial license
Dependencies
React only
Props
18 (14 adjustable)

Included in Pro and Lifetime. See pricing

1,253 contributions in the last year

Made with Furin: Pill Nav · Metal Button · Copy Morph

Props

PropTypeDefaultDescription
datanumber[]"sample activity"Contributions per day, 7 per week starting on Sunday (a sample is used if you pass none).
weeksnumber52How many weeks the grid shows.
endDatestring"2026-09-30"Date of the last day, in YYYY-MM-DD format.
colorstring"#4ade80"Color of the most intense level of the scale.
labelsbooleantrueShows the month and day labels and the legend.
durationnumber2.6Seconds the grid takes to fill in.
replayEverynumber0Seconds between refills (0 leaves it still).
monthsstring[]"Jan … Dec"Short names of the 12 months, January to December (shown above the grid).
monthsLongstring[]"January … December"Full names of the 12 months, January to December (shown in the hover tooltip).
weekdaysstring[]"Sunday … Saturday"Names of the 7 weekdays, starting on Sunday; the first 3 letters are used next to the grid.
lessLabelstring"Less"Legend text to the left of the color scale.
moreLabelstring"More"Legend text to the right of the color scale.
totalLabelstring"{n} contributions in the last year"Heading with the total; "{n}" is replaced by the number (in bold).
emptyLabelstring"No contributions"Tooltip text when the day has no contributions.
oneLabelstring"{n} contribution"Tooltip text when the day has a single contribution; "{n}" is the number.
otherLabelstring"{n} contributions"Tooltip text when the day has several contributions; "{n}" is the number.
dateFormatstring"{weekday}, {month} {day}, {year}"Date format in the tooltip; use {weekday}, {month}, {day} and {year}.
localestring"en-US"Locale used to format numbers (e.g. "en-US" or "es-MX").

Installation

With your license

1Set up the Pro registry once

Pro components aren't on npm or in the public shadcn registry: you install them with your license from Furin's private registry.

Use my license

2Install Contribution Grid

npx shadcn@latest add @furin-pro/contribution-grid

Dependencies

React
18 or later
Other libraries
none
License
commercial

Pro components install into your project: the code is yours and there's nothing else to download.

Keep exploring

  • A donut chart that assembles segment by segment, with a legend. On hover, one segment pulls out and the rest dim.

    Data

  • A gradient progress ring with a glowing leading tip and a counting number; click to fill it again.

    Data

  • A trend line that draws itself with a leading dot, a soft area fill and a live dot that pulses at the end; the cursor shows each point's value and a double-click redraws it.

    Data