Skip to content

mrcndn/chronomap

Repository files navigation

ChronoMap

ChronoMap

An open-source tool for digitizing the borders of every civilization in world history.

ChronoMap aims to become the collaborative atlas that history has always needed — a place where anyone can define the borders of any state, empire, or city-state at any point in time, and where anyone else can explore, use, and build upon that data. Think of it as a Wikipedia for historical maps.

Phase 1 (current): A full-featured browser-based editor for creating historical map projects — drawing territory polygons, defining polities and eras, placing landmarks, and aligning reference images from historical atlases.

Phase 2 (planned): An open platform where contributors worldwide can publish, browse, and reuse community-created maps — making the sum of all historical borders freely available to researchers, educators, and enthusiasts.

Features

  • Territory Drawing — Draw polygons on an interactive map with vertex editing, undo/redo, and automatic coastline clipping
  • Timeline — Scrub through years to see territories and landmarks change in real time
  • Polities & Eras — Define empires, kingdoms, republics, tribes, and more with custom colors and time ranges
  • Landmarks — Place cities, capitals, forts, ports, monasteries, and battle sites
  • Reference Image Overlay — Import historical map images, align them using corner dragging or ground control point (GCP) matching with thin-plate spline warping
  • Import / Export — Save and load projects as .chronomap.json files, import data between projects
  • Coastline Clipping — Automatically trim territory polygons to realistic coastlines using Natural Earth data

Getting Started

bun install
bun run dev

The dev server runs at http://localhost:4010.

Build

bun run build    # type-check + production build → dist/
bun run preview  # preview production build locally

Project Format

Projects are saved as .chronomap.json files containing polities, eras, territories, landmarks, and reference images. See public/examples/ for sample projects.

Tech Stack

Contributing

ChronoMap is in active development. Contributions are welcome — whether it's fixing bugs, improving the editor UX, or helping build the Phase 2 community platform.

License

MIT — see LICENSE.

About

An open-source tool for digitizing the borders of every civilization in world history.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors