Search packages, repositories and app categories

Package detailsv1.2.8

heatmap_calendar

A Heat Map Calendar based on Github's contributions chart which can be used to visualize values over time

30-day downloads
61
Likes
50
Pub points
40

Install package

flutter pub add heatmap_calendar

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that creates a heat map calendar inspired by GitHub's contribution graph, enabling users to visualize data trends over time. It displays daily data with color gradients to represent intensity or frequency, making it ideal for tracking habits, activity levels, or any time-series metrics. The calendar supports customization of colors, date ranges, and tooltips, offering a clean and intuitive interface. It is lightweight and integrates seamlessly into Flutter apps.

Use cases

  • Tracking daily habits
  • Visualizing user engagement
  • Monitoring productivity over time
  • Displaying event frequency
  • Analyzing historical data trends

Key features

  • GitHub-style color gradients
  • Customizable date range
  • Interactive tooltips
  • Supports dynamic data updates
  • Simple integration with Flutter widgets

Suitable for

  • Fitness and wellness apps
  • Productivity trackers
  • Analytics dashboards
  • Developer activity visualizations
  • Personal habit logging

Considerations

  • Limited to daily granularity
  • No built-in support for non-daily data
  • Requires manual handling of data input
  • Not optimized for very large datasets
  • Platform-specific rendering may vary

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Build Status

Flutter Heat Map Calendar

A Heat Map Calendar based on Github's contributions chart which can be used to visualize values over time

HeatMap Calendar in action

Installing

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  heatmap_calendar: ^1.2.8
2. Install it

You can install packages from the command line:

with pub:

$ pub get

with Flutter:

$ flutter pub get

Example

import 'package:heatmap_calendar/heatmap_calendar.dart';
import 'package:heatmap_calendar/time_utils.dart';
...

HeatMapCalendar(
  input: {
    TimeUtils.removeTime(DateTime.now().subtract(Duration(days: 3))): 5,
    TimeUtils.removeTime(DateTime.now().subtract(Duration(days: 2))): 35,
    TimeUtils.removeTime(DateTime.now().subtract(Duration(days: 1))): 14,
    TimeUtils.removeTime(DateTime.now()): 5,
  },
  colorThresholds: {
    1: Colors.green[100],
    10: Colors.green[300],
    30: Colors.green[500]
  },
  weekDaysLabels: ['S', 'M', 'T', 'W', 'T', 'F', 'S'],
  monthsLabels: [
    "",
    "Jan",
    "Feb",
    "Mar",
    "Apr",
    "May",
    "Jun",
    "Jul",
    "Aug",
    "Sep",
    "Oct",
    "Nov",
    "Dec",
  ],
  squareSize: 16.0,
  textOpacity: 0.3,
  labelTextColor: Colors.blueGrey,
  dayTextColor: Colors.blue[500],
)

Categories

Source repository

Projects using this package