whatisgithub

What is us-warming-map?

dibz15/us-warming-map — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

An interactive map showing how each US county's temperature has changed since 1895, with all climate data precomputed so the live site never calls an external API.

Mindmap

mindmap
  root((repo))
    What it does
      Maps county temperature trends
      Shows historic charts per county
      Multiple metrics and scales
    Tech stack
      TypeScript
      D3
      Vite
      Python pipeline
    Use cases
      Explore local warming trends
      Compare metrics over time
      Study NOAA climate data
    Audience
      Curious general public
      Climate researchers
    Data
      NOAA county dataset
      Precomputed at build time

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

What do people build with it?

USE CASE 1

Look up how much your own county has warmed since 1895.

USE CASE 2

Compare warming trends across different temperature metrics like max, min, and seasonal swing.

USE CASE 3

Study NOAA's county-level climate dataset through a visual, interactive chart.

USE CASE 4

Learn how to build a static data visualization with precomputed data and no runtime API calls.

What is it built with?

TypeScriptD3VitePython

How does it compare?

dibz15/us-warming-map0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Regenerating the underlying dataset requires running the Python data pipeline separately.

No license information was stated in the README.

So what is it?

This project is an interactive map of the United States that shows how temperatures have changed in every county since 1895. Each county is colored based on how its temperature is trending, and clicking on any county pulls up its full year by year temperature history as a chart. The creator built it after searching online for a simple way to see how much their own local area has warmed over their lifetime and not finding anything that fit the bill, since most existing tools only let you look up one county at a time. The map lets you choose between several different temperature measures, including maximum, mean, minimum, the daily swing between hot and cold, and seasonal changes, and you can calculate warming either as a century long trend or as a direct comparison between two chosen year ranges. The color scales used are designed to be readable for colorblind users. A notable design choice is that all the climate data is calculated ahead of time and baked into the site during the build process. This means the live website never has to call out to NOAA or any outside weather data service while someone is browsing it, so it stays fast and does not depend on an external API being available. The underlying temperature numbers come from NOAA's National Centers for Environmental Information, using their county level climate dataset. There is a Python based data pipeline included in the project that fetches and processes this NOAA data into the JSON files the map actually reads, and this pipeline can be rerun to regenerate the dataset from scratch. The frontend itself is built with Vite and TypeScript, and uses the D3 library both for drawing the map itself and for rendering the historical trend charts. The finished site is a static build that gets deployed to GitHub Pages automatically.

Copy-paste prompts

Prompt 1
Explain how this project precomputes NOAA climate data at build time instead of calling an API live.
Prompt 2
Show me how the data pipeline in data-pipeline/ fetches and processes NOAA county data.
Prompt 3
Help me run this map locally with npm install and npm run preview.
Prompt 4
Walk me through how the color scales work for showing temperature trend versus period comparison.

Frequently asked questions

What is us-warming-map?

An interactive map showing how each US county's temperature has changed since 1895, with all climate data precomputed so the live site never calls an external API.

What language is us-warming-map written in?

Mainly TypeScript. The stack also includes TypeScript, D3, Vite.

What license does us-warming-map use?

No license information was stated in the README.

How hard is us-warming-map to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is us-warming-map for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.