gitwtfhub

wtf is quantify-your-year?

tanykim/quantify-your-year — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2024-10-31

★ 29JavaScriptAudience · generalComplexity · 2/5StaleSetup · moderate

TL;DR

Turns a year of personal activity data (steps, mileage, spending, etc.) into a colorful calendar-grid visualization, like a GitHub contribution graph for anything you track about your own life.

Mindmap

mindmap
  root((repo))
    What it does
      Calendar heatmap
      Personal data viz
    Inputs
      Daily data file
      Settings per activity
    Features
      Streak detection
      Custom colors and units
    Audience
      Quantified self fans
      Runners and trackers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Visualize a year of daily running mileage as a color-coded calendar to spot the most consistent months.

REASON 2

Track daily spending or savings and see streaks of good habits highlighted automatically.

REASON 3

Turn exported health-app or Google Sheets data into a personal quantified-self dashboard you host yourself.

What's in the stack?

ReactJavaScript

How it stacks up

tanykim/quantify-your-yearable-rip/cc-visionrouteraisatan/poe2dire
Stars292929
LanguageJavaScriptJavaScriptJavaScript
Last pushed2024-10-31——
MaintenanceStale——
Setup difficultymoderateeasyeasy
Complexity2/52/51/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Data from external sources (Google Sheets, health apps) must be converted to the project's expected format first.

Yoink these prompts

Prompt 1
Help me format a year of daily step-count data into the JSON structure quantify-your-year expects, then generate the calendar visualization.
Prompt 2
Using quantify-your-year, set up a tracked activity with a custom color and unit, and explain how the streak detection works.
Prompt 3
How do I export data from a health app or Google Sheets into the format quantify-your-year needs to build a calendar heatmap?
Prompt 4
Show me how to self-host quantify-your-year and add a second tracked activity alongside an existing one.

Frequently asked questions

wtf is quantify-your-year?

Turns a year of personal activity data (steps, mileage, spending, etc.) into a colorful calendar-grid visualization, like a GitHub contribution graph for anything you track about your own life.

What language is quantify-your-year written in?

Mainly JavaScript. The stack also includes React, JavaScript.

Is quantify-your-year actively maintained?

Stale — no commits in 1-2 years (last push 2024-10-31).

How hard is quantify-your-year to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is quantify-your-year for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane