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, 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 mapStart 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.
- Copy the templateOpen github.com/unotdys/townlapse and click Use this template.
- Describe your neighborhoodIn
config.json: its name, a few corner points of its boundary, and which way should point up on screen. - Add the places you knowList a handful in
data/history.json. Neighbors will add the rest. - Turn on the websiteIn your copy's Settings → Pages, choose GitHub Actions. Your map goes live at your-name.github.io.
- 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.
- 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.
