Repolode
Submit
DeanChensj

DeanChensj/jiangshan-map

An interactive browser map of China's history from 403 BCE to today, with dynasty-by-dynasty territory snapshots, city genealogies and poetry routes.

View on GitHubWebsite
Stars
237
Forks
16
Open issues
2
Last commit
11 hours ago

What is it?

Chronicles of the Realm (jiangshan-map) is a browser-based historical atlas of China. A timeline lets you scrub from the Warring States period (403 BCE) to the present, and the map redraws polity borders, prefecture boundaries, rivers, lakes, walls and canals for each stop. It covers 18 historical periods with 164 territory snapshots and shows the reigning monarch and era name alongside each year.

Clicking an ancient city or mountain pass opens a genealogy card that traces its administrative names and jurisdictions across dynasties, along with events that happened at that site. Person timelines follow figures such as Qin Shi Huang, Xuanzang and Su Shi across the map, and a pinpoint quiz asks users to locate historical cities. The project runs as static files with no build step, and it exposes URL parameters and a JavaScript API so external tools can open specific years, places or routes.

Key features

  • 01Timeline scrubbing across 18 historical periods with changing polity borders
  • 02City and mountain-pass genealogy cards showing names and jurisdictions by dynasty
  • 03Person timelines that plot a historical figure's journeys on the map
  • 04Map pinpoint quiz for locating ancient cities
  • 05Deep links and a JavaScript API for opening specific years, places or routes

Use cases

  • Students or readers following Chinese history or classical poetry with a map at hand
  • Teachers building visual lessons on dynastic change and territory
  • Developers embedding historical place-and-time views via URL parameters or the JS API
  • Digital humanities projects that need an example of a historical GIS web atlas

Quick start

  1. 1

    Open the live demo in your browser (English UI)

Topics

#historical-map#gis#interactive-map#chinese-history#cartography#digital-humanities#ancient-china#china-map#classical-chinese-poetry#historical-atlas

FAQ

What is jiangshan-map?
An interactive browser map of China's history from 403 BCE to today, with dynasty-by-dynasty territory snapshots, city genealogies and poetry routes. Chronicles of the Realm (jiangshan-map) is a browser-based historical atlas of China. A timeline lets you scrub from the Warring States period (403 BCE) to the present, and the map redraws polity borders, prefecture boundaries, rivers, lakes, walls and canals for each stop. It covers 18 historical periods with 164 territory snapshots and shows the reigning monarch and era name alongside each year.
Is jiangshan-map free to use? What license does it have?
jiangshan-map is open source under the MIT license. Check the license terms before using it in commercial products.
Is jiangshan-map still maintained?
Actively maintained. The last commit to jiangshan-map was on Oct 21, 2026.
What can I use jiangshan-map for?
Students or readers following Chinese history or classical poetry with a map at hand Teachers building visual lessons on dynastic change and territory Developers embedding historical place-and-time views via URL parameters or the JS API Digital humanities projects that need an example of a historical GIS web atlas
How do I install jiangshan-map?
Open the live demo in your browser (English UI)
Where can I get jiangshan-map?
The source code and installation instructions are on GitHub: https://github.com/DeanChensj/jiangshan-map

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects