Townlapse

Watch your town change, one storefront at a time.

A free, open-source map with a timeline from 1900 to today. Drag the slider and see which shops, restaurants and theaters stood on each block. Neighbors add the places they remember, and every one is checked against old directories and newspapers before it goes on the map.

Satellite map of downtown Palo Alto with pins for the businesses open in 1955

How it works

Slide through time

A satellite map with a timeline across the top. Every pin is a place that was open in the year you're on. Click one for its story.

Neighbors remember

Anyone can suggest a place, fix a date, or join the discussion about a building. Memory fills in what the archives missed.

Every fact is checked

An AI researches each suggestion against city directories, phone books and local news, and posts its verdict and sources in public before anything changes.

Towns

Downtown Palo Alto on Townlapse

Downtown Palo Alto, California

1900 to today. Nearly 2,000 places, from the 1904 city directory and decades of phone books to today's shops, plus the ones neighbors remembered.

Open the map
Your town could be next. Start one, then tell us about it and we'll list it here.

Start a Townlapse for your town

You need a free GitHub account and about 15 minutes. No coding, just editing two files. Everything runs on free services.

  1. Copy the templateOpen github.com/unotdys/townlapse and click Use this template.
  2. Describe your neighborhoodIn config.json: its name, a few corner points of its boundary, and which way should point up on screen.
  3. Add the places you knowList a handful in data/history.json. Neighbors will add the rest.
  4. Turn on the websiteIn your copy's Settings → Pages, choose GitHub Actions. Your map goes live at your-name.github.io.
  5. Load today's businessesRun the "Refresh today's businesses" action once. It pulls your area's current shops from OpenStreetMap, and refreshes them every week.
  6. Optional extrasAn AI key for automatic fact-checking (Claude or Gemini), a free Cloudflare Worker so anyone can suggest without a GitHub account, and a connector for searching local Facebook history groups with Meta's Muse.

The README walks through every step. Historical societies and libraries make natural hosts, since they have the archives and the volunteers.

Contribute

Add what you remember

On any Townlapse map, press Suggest a place or Suggest a fix. It takes a minute, and it's checked before it's published.

Find old sources

City directories, phone books, newspapers and building histories are where the dates come from. If you know of digitized ones for your town, tell us.

Improve the code

Townlapse is MIT-licensed on GitHub. Issues and pull requests are welcome, from bug fixes to new data sources.