About HistoryMap
An open-source community project mapping historical events around the world
Our Mission
HistoryMap aims to make world history more accessible and engaging by visualizing historical events on an interactive map. We believe that understanding history through geography helps people connect with the past in a more meaningful way.
How It Works
HistoryMap combines three powerful technologies to deliver a seamless experience:
- •GitHub Data Repository: All historical events are stored as JSON files in a public GitHub repository, allowing anyone to contribute through pull requests.
- •Supabase Database: Events are synced to a PostgreSQL database with PostGIS for efficient geographic queries and filtering.
- •Next.js Application: The website uses Incremental Static Regeneration (ISR) to serve pre-rendered pages that update hourly with new events.
Community Driven
HistoryMap is built by history enthusiasts from around the world. Every event on the map has been researched and submitted by community members who are passionate about preserving and sharing historical knowledge.
Open Source
All our data is freely available under CC BY-SA 4.0 license, ensuring historical knowledge remains accessible to everyone.
Quality Controlled
Every submission is reviewed for accuracy and includes citations to reliable historical sources.
Contribute Events
Have a historical event to add? We welcome contributions from everyone! Whether it's a major world event or an important local occurrence, your contribution helps make history more complete.
How to Contribute:
- 1.Visit our GitHub Data Repository
- 2.Read the CONTRIBUTING.md guide for detailed instructions
- 3.Create a JSON file for your event following our schema
- 4.Submit a pull request with your event and sources
- 5.Our maintainers will review and merge your contribution!
Built With
Frontend
- • Next.js 15 (App Router)
- • React 19
- • TypeScript
- • Tailwind CSS
- • Mapbox GL JS
Backend
- • Supabase (PostgreSQL)
- • PostGIS
- • GitHub Actions
- • ISR (Incremental Static Regeneration)
About the Creator
HistoryMap was created by Adam Kmet, a developer passionate about making history accessible through technology. The project started as an exploration of combining geographic visualization with historical data and has grown into a community-driven platform.
Ready to Explore History?
Discover thousands of historical events from around the world