DeanChensj/jiangshan-mapPublic

江山时序 · 中国历史交互地图时间轴 (403 BCE – Present) | Interactive Historical Atlas of China across 18 dynasties, 198 territory snapshots, ancient-to-modern place genealogy & classical poetry routes

AI summary: Interactive 2,400‑year Chinese atlas with timeline scrubbing, place genealogy and person chronicles

Stars
8.6K
+193 today
Forks
1.1K
Watchers
31
Open issues
5
Open PRs
3
Contributors
~15
Commits
422
Branches
10
Views (30d)
2

JavaScriptGPL-3.0Created Jul 23, 2026Last push todayLatest release v1.3.0+1.9K stars this week+1.9K this month

Quick answers

What is jiangshan-map?
Interactive 2,400‑year Chinese atlas with timeline scrubbing, place genealogy and person chronicles
What does jiangshan-map do?
It solves the difficulty of visualizing millennia‑spanning Chinese territorial changes and cultural landmarks in a single interface. The project renders 18 dynastic periods, 198 territorial snapshots, and dynamic layers (rivers, lakes, walls) using WebGL/Canvas in the browser. Users scrub a draggable timeline to animate boundary shifts, view ghost‑diff borders, and see the reigning monarch for each year. Clicking any city, pass, or historical figure opens a genealogy card that lists administrative evolution, events, and links to related milestones. Multi‑person search merges several biographies on the same map, highlighting shared encounters, while voice narration can read events aloud.
Who is jiangshan-map for?
The atlas is aimed at scholars, educators and hobbyists interested in Chinese history, geography and literature. It runs in any modern browser and assumes basic familiarity with web navigation; no programming knowledge is required.
How do I get started with jiangshan-map?
npm install
How popular is jiangshan-map on GitHub?
DeanChensj/jiangshan-map has 8,593 stars and 1,059 forks on GitHub, and gained 1,930 stars in the last 7 days.
What license does jiangshan-map use?
DeanChensj/jiangshan-map is released under the GPL-3.0 license.

Star history

since Nov 16, 2026
02.5K5K7.5KNov 2026Nov 2026Nov 2026Nov 2026
8.6K stars as of Nov 21, 2026. Measured daily since Nov 16, 2026; GitHub no longer exposes earlier star timestamps.

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 0 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 0 commits2026-04-23: 0 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 0 commits2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 0 commits2026-05-17: 0 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 0 commits2026-06-05: 0 commits2026-06-06: 0 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 0 commits2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 0 commits2026-06-16: 0 commits2026-06-17: 0 commits2026-06-18: 0 commits2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 0 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 0 commits2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 4 commits2026-07-24: 0 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 0 commits2026-07-30: 0 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 0 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 0 commits2026-08-13: 0 commits2026-08-14: 0 commits2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 0 commits2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 0 commits2026-09-02: 0 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 23 commits2026-10-10: 15 commits2026-10-11: 48 commits2026-10-12: 15 commits2026-10-13: 15 commits2026-10-14: 16 commits2026-10-15: 4 commits2026-10-16: 10 commits2026-10-17: 6 commits2026-10-18: 8 commits2026-10-19: 5 commits2026-10-20: 8 commits2026-10-21: 5 commits2026-10-22: 10 commits2026-10-23: 12 commits2026-10-24: 10 commits2026-10-25: 15 commits2026-10-26: 1 commit2026-10-27: 7 commits2026-10-28: 9 commits2026-10-29: 6 commits2026-10-30: 5 commits2026-10-31: 4 commits2026-11-01: 8 commits2026-11-02: 4 commits2026-11-03: 14 commits2026-11-04: 14 commits2026-11-05: 12 commits2026-11-06: 8 commits2026-11-07: 16 commits2026-11-08: 12 commits2026-11-09: 5 commits2026-11-10: 13 commits2026-11-11: 3 commits2026-11-12: 14 commits2026-11-13: 10 commits2026-11-14: 15 commits2026-11-15: 7 commits2026-11-16: 6 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
422 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Rising fast

    +1,930 stars this week

  • Actively maintained

    Pushed within 48 hours

  • Continuous integration

    Automated checks passing

  • Repeat trending

    4 trending appearances

What jiangshan-map does

It solves the difficulty of visualizing millennia‑spanning Chinese territorial changes and cultural landmarks in a single interface. The project renders 18 dynastic periods, 198 territorial snapshots, and dynamic layers (rivers, lakes, walls) using WebGL/Canvas in the browser. Users scrub a draggable timeline to animate boundary shifts, view ghost‑diff borders, and see the reigning monarch for each year. Clicking any city, pass, or historical figure opens a genealogy card that lists administrative evolution, events, and links to related milestones. Multi‑person search merges several biographies on the same map, highlighting shared encounters, while voice narration can read events aloud.

The atlas is aimed at scholars, educators and hobbyists interested in Chinese history, geography and literature. It runs in any modern browser and assumes basic familiarity with web navigation; no programming knowledge is required.

  • Timeline Scrubbing: Drag the timeline to animate territorial evolution, ghost‑diff borders and monarch labels.
  • Place Genealogy: Click a city or pass to view a bilingual card tracing its 2,400‑year administrative history and associated events.
  • Person Chronicle: Search any historical figure to plot their life’s milestones across changing borders, with multi‑person merging.
  • Layer Controls: Toggle modern province overlays, river courses, ancient walls and Silk Road routes for comparative study.
  • Voice Narration: Enable speech synthesis to have the map read year labels and event descriptions automatically.
  • Zoomable Map: Pinch or scroll to zoom while preserving high‑resolution parchment styling and detailed borders.

Where teams use it

History Students

Explore dynastic boundaries and locate sites mentioned in textbooks without consulting bulky atlases.

Literary Scholars

Trace the routes of poets like Su Shi or Li Bai and see the exact locations of verses and exile routes.

GIS Researchers

Compare ancient territorial data with modern provincial layers to analyze long‑term geopolitical shifts.

Educators

Create interactive lessons by scrubbing through eras, highlighting events, and playing narrated timelines.

Cultural Tour Guides

Generate visual itineraries that link historic battlefields, mountain passes, and heritage sites for visitors.

Getting started: npm install

README

main branch

Chronicles of the Realm · 江山时序

English · 简体中文 (Chinese) · 繁體中文 (Traditional Chinese) · 日本語 (Japanese)

An Interactive Historical Atlas of China from the Warring States (403 BCE) to the Present — Scrub Through Time, Trace Ancient Cities, and Walk in the Footsteps of History

Play Live Demo (English UI) → https://deanchen.me/jiangshan-map/?lang=en

The story behind it (in Chinese): From textbook maps to 1k GitHub stars

GitHub Trending · Repository of the Day #2

Chronicles of the Realm — 15s Interactive Overview (Warring States Unification, 2,400-Year Dynastic Scrubbing, Chang'an Place Genealogy & Su Shi's Exile Route)


Why It's Fun to Explore

Have you ever wondered while reading Chinese history or classical poetry:

  • "Where exactly on today's map are Jiankang (the Six Dynasties capital), Huangzhou (where Su Dongpo composed the Red Cliffs Rhapsody in exile), Languan Pass in the Qinling Mountains (where Han Yu halted his horse in the snow), or Zhuxianzhen (Yue Fei's northern campaign frontier)?"
  • "How many names did Chang'an hold across two millennia, and what pivotal events unfolded on that soil?"
  • "How did the realm evolve step by step—from the Partition of Jin and the Seven Warring States at the opening of Sima Guang's Zizhi Tongjian (403 BCE), Qin's unification campaigns, Emperor Wu of Han opening the Hexi Corridor, High Tang's Four Garrisons of Anxi, and Yuan's Xuanzhengyuan jurisdiction over Tibet, to Zeng Jize's recovery of Ili (1881 CE) and the 20th-century shift from the 'Begonia Leaf' (秋海棠) map to the 'Rooster' (雄鸡) map?"

Chronicles of the Realm (jiangshan-map) brings together 2,400+ years of Chinese history across 18 historical periods into a single interactive parchment atlas—featuring multi-stage territorial and prefecture snapshots, ancient cities, strategic mountain passes, poetic and battlefield landmarks, chronological milestones, and reigning monarchs & imperial eras. No heavy print atlases required—just drag the timeline and click any city to travel through space and time.


Feature 1: Scrub the Timeline to Watch Realms Rise & Fall, Track Monarchs, and Compare Ancient & Modern Borders

  • Multi-Polity Confrontations on a Single Canvas: From the Seven Warring States (Qin, Chu, Qi, Yan, Zhao, Wei, Han) alongside Zhou, Yue, Ba-Shu, Zhongshan, and Yiqu, to the Three Kingdoms warlords (Yuan Shao, Cao Cao, Liu Bei, Sun Quan, Gongsun's Liaodong), Northern & Southern Dynasties, Five Dynasties & Ten Kingdoms, and Song, Liao, Western Xia, Dali, Jin, and the Mongols—all rendered side-by-side in high-contrast traditional parchment hues. Hover over any polity in the bottom-left legend to highlight its territory, or click to open that polity's profile (lifespan, capitals and a short history) and zoom to its territory.
  • Multi-Stage Territorial Evolution & Dashed "Ghost Boundary Diffs": At every major territorial milestone—such as Qin's conquest of Ba-Shu (316 BCE), Yan General Qin Kai's expansion into Liaodong (300 BCE), Ma Yuan's bronze pillars in Jiaozhi (43 CE), Sima Yi's campaign in Liaodong (238 CE), Li Jing's conquest of Tuyuhun (635 CE), the Four Garrisons of Anxi & Wang Xuance's campaign in Central India (648 CE), Yuan's Xuanzhengyuan rule over Tibet (1288 CE), Ming's Jiaozhi Province in Annam (1407 CE), the 1881 Treaty of Saint Petersburg recovering Ili, the 1898 foreign leased territories, the 1945 retrocession of Taiwan, and the 1946 transition from the "Begonia Leaf" (秋海棠) map to the "Rooster" (雄鸡) map—click any milestone or phase dot to switch maps and reveal the previous phase's dashed vermilion Ghost Boundary Diff so territorial gains and losses are immediately visible.
  • Reigning Monarch on the Timeline: The bubble above the timeline names the monarch on the throne in the current year (e.g. 100 BCE · Western Han · Emp. Wu, 630 CE · Tang · Emp. Taizong, 1700 CE · Qing · Kangxi Emp. (Shengzu)); the Chinese interface also shows the regnal era year (唐太宗·贞观四年).
  • Ancient Prefecture Hover Inspection & Modern Province Overlay: First-level administrative divisions (Commanderies, Circuits, Routes, and Provinces) are rendered with deduplicated Parchment Casing borders. Zoom in and hover over any prefecture (e.g., Ming Yingtian Prefecture or Three Kingdoms Jingzhou) to inspect its jurisdiction and modern provincial equivalents. In the top-right Layers menu, Provinces (on by default) draws today's provincial boundaries over the historical map, and Prov. Names adds their names.
  • Dynamic River Courses, Ancient Lakes & Grand Engineering Works: As you scrub through time, historical shifts of the Yellow River, expanding and shrinking ancient lakes (Yunmeng Marsh, Lop Nur / Puchanghai), Warring States/Qin/Han/Ming Great Walls, Sui-Tang & Grand Canals, the Silk Road, and Zheng He's maritime routes evolve in lockstep with each era; ancient coastlines around the Bohai Gulf, northern Jiangsu, the Yangtze estuary, and the Pearl River Delta also advance and retreat by era.
  • Zoomable Timeline: Drag the handles at either end of the timeline inward to zoom into one stretch of history (handy for short eras such as Qin, the Three Kingdoms, or the Five Dynasties); double-click the timeline to return to the full overview.
  • Voice Narration: Turn on the narration toggle next to the play button and autoplay reads out each year and its events in the browser's built-in voice; it also follows a person's chronicle on autoplay (requires a browser with speech synthesis).

Try It Live: Ming Dynasty Yongle 13 (1415 CE) · Two Capitals, Thirteen Provinces & "Yingtian Prefecture" Inspection →

Ming Dynasty 1415 CE · Yingtian Prefecture Hover Preview


Feature 2: Click Any Ancient City or Strategic Pass to Uncover 2,400 Years of History (Trace Place)

Click any ancient city or mountain pass on the map (or double-click anywhere on the canvas) to open its Trace Place genealogy card:

  • Bilingual City Lore Banner & 2,400-Year Administrative Genealogy: At the top of the card, read a curated poetic epigraph and historical biography for the city; below, trace how its name and administrative jurisdiction evolved across all 18 historical eras—from Warring States and Qin commanderies, Han regional inspectorates, Tang circuits, and Song routes to Yuan/Ming/Qing provinces and modern municipalities—complete with Capital badges and dynastic seat remarks.
  • Site-Specific Landmark Events: Beneath each dynasty row, inspect major historical events that took place right on that spot (e.g., Shang Yang's Reforms and Qin's Unification at Xianyang, Guan Yu Flooding the Seven Armies at Fancheng, the Xuanwu Gate Incident at Chang'an, or Yue Fei's Martyrdom at Lin'an). Click the Chronicles pill in the top-right of the card to filter for dynasties with major events, and click any event to time-travel straight to that year!
  • Strategic Mountain Passes & Poetic / Battlefield Landmarks: Explore famous mountain passes—including Hangu Pass, Tongguan, Jianmen Pass, Yanmen Pass, Yumen Pass, Yangguan, and Shanhai Pass—rendered with traditional Hanque gatehouse icons and strategic terrain notes, alongside famous battlefields and literary landmarks such as Red Cliffs (Chibi), Gaixia, Wuzhang Plains, Orchid Pavilion (Lanting), Yueyang Tower, Pavilion of Prince Teng, Languan Pass, Loulan, Lop Nur, and Issyk-Kul.

Try It Live: High Tang Kaiyuan 29 (741 CE) · Open Chang'an's 2,400-Year Genealogy Card →

High Tang 741 CE · Chang'an Trace Place & Key Events


Feature 3: Person Chronicles — Trace Any Historical Figure Across Time & Space

Click the top-left Universal Search Box (with a rotatable e.g. figure preview and quick-search chips, or type any monarch, general, statesman, monk, or poet such as Cao Cao, Huo Qubing, Sima Qian, Yue Fei, or Zheng He) to open Person Chronicle (点人溯事), marking every milestone of their life with numbered pins across changing dynastic borders:

  • Qin Shi Huang's Unification Campaigns (238–221 BCE): From suppressing the rebellion at Xianyang and Wang Jian's attack on Ye, to the fall of Han, Zhao, Yan, Wei, Chu, and Dai, culminating in the surrender of Qi at Linzi—as you advance stop by stop, watch the six rival kingdoms merge into the Qin Empire right on the map!
  • Zhang Qian's Mission to the Western Regions (138–126 BCE): Depart Chang'an, endure over a decade of Xiongnu captivity without surrendering the Han imperial staff, and blaze the trail to Dayuan (Fergana), Kangju, and the Greater Yuezhi.
  • Zhuge Liang's Emergence & Northern Expeditions (207–234 CE): From the Three Visits at Longzhong and the alliance at Chaisang before Red Cliffs, to entering Shu, the White Emperor City entrustment, the Southern Campaign across the Lu River, Hanzhong's Memorial on Deploying the Troops, Mount Qi, and the autumn winds of Wuzhang Plains.
  • Xuanzang's Pilgrimage to India (627–645 CE): Slip past Yumen Pass alone across the Moheyan Desert, scale the icy Bedel Pass, cross the Indus, study at Nalanda Monastery, and debate at Kanyakubja (Kanauj) before returning to Chang'an.
  • Li Bai's Grand Travels Across Tang China (701–762 CE): From Suyab and boyhood in Shu, sailing out through the Three Gorges at twenty-four, scattering gold in Yangzhou, serving in the Hanlin Academy at Chang'an, meeting Du Fu in Luoyang, receiving amnesty at White Emperor City, to his final years at Dangtu.
  • Su Shi's Literary Exile Across Song China (1056–1101 CE): From leaving Meishan for the capital Kaifeng and gazing at the moon in Mizhou, to composing the Red Cliffs Rhapsody in Huangzhou exile, Huizhou, and crossing the sea to Danzhou on Hainan Island.
  • Wang Yangming's Unity of Knowledge & Action (1472–1529 CE): From birth in Yuyao and imprisonment in Beijing, to his enlightenment at Longchang in Guizhou, pacifying bandits in Southern Ganzhou, capturing the rebel Prince of Ning in 35 days, teaching at the Tianquan Bridge in Shaoxing, and his final words "This mind is bright and clear; what more is there to say?" at Nan'an.
  • Multi-Person Chronicles: Type two or three names into the search box (e.g. Li Bai, Du Fu, Gao Shi or Cao Cao, Liu Bei, Sun Quan) to merge their journeys onto one timeline. Places where they met in the same year are marked as shared encounters, and the Shared N pill narrows the list to just those stops.
  • Event Storylines: Major events unfold stop by stop, just like a person's life. The Chu–Han Contention (207–202 BCE), the An Lushan Rebellion (755–763 CE) and the Jingkang Catastrophe (1125–1142 CE) are each laid out in ten stops across three acts, with the two sides drawn in different colors so each side's advances are easy to follow.

Each time you step to the next event (‹ / ›, ← / →, or Space to auto-play), the timeline year, reigning monarch, imperial era, and dynastic territories evolve in sync with their footsteps, highlighting the active transition arc alongside bilingual primary-source excerpts and poems written at that exact site.

Try It Live: Su Dongpo's Life & Exile Across Song China (1037–1101 CE) →

Person Chronicle · Su Shi's Life & Exile Route


Feature 4: Easter Egg · Map Pinpoint Challenge — What Imperial Court Rank Would You Earn?

Think you know Chinese historical geography? Click Quiz › in the corner of the Universal Search Box guide bar (or type quiz for Map Pinpoint · Ancient Place Quiz):

  • Dynastic Historical Clues + Blind Map Pinpointing: City labels are hidden while the prompt asks you to locate an ancient city across a 10-round progressive difficulty deck—accompanied by dynastic historical clues (without spoiling the modern city name). Drop your pin to preview and adjust, click the Confirm ↵ chip next to the pin to lock in your answer with concentric distance score rings, and earn points based on great-circle distance to the true coordinates!
  • Complete 10 rounds to receive a traditional imperial cartographic title such as Grand Historian & Master Cartographer (太史令 · 舆图大家), Director of the Bureau of Operations (职方郎中), or Prefectural Retainer (州郡从事).

Try It Live: Western Han Emperor Wu, Yuanshou 2 (121 BCE) · Start the Map Pinpoint Challenge →

Western Han 121 BCE · Map Pinpoint Challenge Preview


Keyboard Shortcuts & Shareable Deep Links

Keyboard Shortcuts

Key / Action Effect
/ or Cmd/Ctrl + K Focus the Universal Search Box: search historical figures (Qin Shi Huang/Zhang Qian/Su Shi), ancient & modern cities (Xianyang/Chang'an/Luoyang/Kaifeng), reigning monarchs (Emperor Wu of Han/Taizong of Tang/Liu Che/Li Shimin), imperial eras (Zhenguan/Yongle/Kangxi), poetic & battlefield landmarks (Red Cliffs/Wuzhang Plains/Languan/Lanting), mountain passes (Hangu Pass/Jianmen Pass/Yumen Pass), historical events, or the Ancient Place Quiz
← / → or bottom ‹ / › Jump to the previous / next historical phase, milestone event, or person event stop (hold Shift + ← / → to step by 10 years)
Space Auto-play / pause timeline evolution (or auto-advance stops in Person Chronicle mode)
Esc Close active popups/cards, clear search highlights, or exit custom multi-stop routes
Single-click city / Double-click map Open the 18-era Trace Place & Key Events genealogy card for that location
Hover / Click legend swatch Hover to isolate & highlight that polity's territory; click to open its profile and zoom to its territory

Shareable Deep Links

Append query parameters to share any historical moment, battle, city genealogy, or multi-stop route:

Embed in Your Page

Put any view of the atlas into a blog post, Notion page, or course site:

  1. Open the atlas and set up the view you want (a year, a regime profile, a place card, or a person's trajectory). The address bar always mirrors what you see.
  2. Copy the URL and add &embed=1.
  3. Paste it into an <iframe>:
<iframe
  src="https://deanchen.me/jiangshan-map/?embed=1&year=1104&trace=101.778,36.617&from=1072&to=1126&lang=en"
  width="100%" height="480" loading="lazy" style="border:0"
  title="Chronicles of the Realm · 1104 CE, Northern Song"></iframe>

The embedded map hides the site chrome and keeps only the map, a compact timeline, a title chip, an "Open in Jiangshan Atlas ↗" link, and a note that historical borders are approximate. Readers click once to start panning and zooming, so scrolling your page never gets stuck on the map.

Parameter Effect
embed=1 Turn on embed mode (required)
year, polity, person, stop, trace, lang Same as the share links above
from=1072&to=1126 Limit the timeline to this range; the timeline zooms to show only it
lock=1 Freeze the map at year and hide the timeline
autoplay=1 Play a person's trajectory stop by stop (with person), or play the timeline

WeChat Official Accounts, Zhihu, and Xiaohongshu do not allow iframes; share the plain link there instead.


AI Agent, MCP & LLM Integration

Chronicles of the Realm works out of the box as a historical-geography visualization engine for LLMs, MCP Clients, and AI Agents. Models never need to guess latitude/longitude coordinates—simply extract two semantic parameters from a poem or historical text, year and place, and the atlas automatically resolves ancient/modern place names, centers the camera, renders dynastic borders and multi-stop trajectories, and opens the Trace Place genealogy card:

  • Machine-Readable Specification: llms.txt
  • Zero-Dependency Local MCP Server (stdio): scripts/mcp_server.js — add to Claude Desktop, Cursor, Windsurf, or Gemini CLI mcpServers:
    {
      "mcpServers": {
        "jiangshan-atlas": {
          "command": "node",
          "args": ["/absolute/path/to/jiangshan-map/scripts/mcp_server.js"]
        }
      }
    }
    Exposes 3 native MCP tools (<5ms offline response, zero npm dependencies):
    • inspect_place({ year, place, lang? }): Returns reigning monarch/era, controlling regime (polity), macro-region (dao/lu/province), prefecture (jun/zhou/fu), modern province/city, 2,400-year lore, and shareable deep-link URL.
    • inspect_person({ person, stop?, lang? }): Returns a historical figure or monarch's biography, chronological geocoded stops across dynasties, and shareable deep-link URL.
    • search_atlas({ query, limit?, lang? }): Searches across all ancient cities, poetic & battlefield landmarks, mountain passes, historical figures, imperial eras, and chronological milestones.
  • Ready-to-Use Agent Skill: skills/jiangshan-atlas/SKILL.md (includes the zero-dependency CLI renderer skills/jiangshan-atlas/scripts/jiangshan.py)
    # Install into Claude Code / Gemini / Jetski global skills directory:
    mkdir -p ~/.claude/skills ~/.gemini/config/skills && cp -r skills/jiangshan-atlas ~/.claude/skills/ && cp -r skills/jiangshan-atlas ~/.gemini/config/skills/

1. Zero-Coordinate Dual-Parameter URL Protocol (0D Pinpoint / 1D Same-Year Route / 4D Multi-Year Route)

Mode Example URL Automatic Rendering Behavior
Single-Point Pinpoint (0D) ?year=819&place=蓝关&lang=en
(Han Yu's 819 CE exile poem at Languan Pass)
Jumps to Tang Yuanhe 14 (819 CE), drops a pin on Languan Pass in the Qinling Mountains, and opens its 2,400-year administrative genealogy card
Same-Year Multi-Stop Route (1D) ?year=763&place=剑外,巴峡,巫峡,襄阳,洛阳&lang=en
(Du Fu's 763 CE poem on recapturing Henan & Hebei)
Plots numbered vermilion arcs 1 → 5 across the 763 CE Tang map and auto-fits the viewport; click any stop to inspect its genealogy
Multi-Year Space-Time Route (4D) ?year=1079,1080,1094,1097&place=湖州,黄州,惠州,儋州&lang=en
(Su Shi's career across Huzhou, Huangzhou, Huizhou & Danzhou)
Pairs year[i] with place[i], labeling stops with their historical years and switching the underlying dynastic map whenever you click a stop

2. CLI One-Command Screenshot & JSON Lookup (for Agent Tool Calls)

# Single-point poetic landmark screenshot
python3 skills/jiangshan-atlas/scripts/jiangshan.py --year 819 --place 蓝关 --out /tmp/languan_819.png

# Same-year multi-stop trajectory screenshot
python3 skills/jiangshan-atlas/scripts/jiangshan.py --year 763 --place 剑外,巴峡,巫峡,襄阳,洛阳 --out /tmp/dufu_763.png

# Multi-year space-time trajectory screenshot
python3 skills/jiangshan-atlas/scripts/jiangshan.py --year 1079,1080,1094,1097 --place 湖州,黄州,惠州,儋州 --out /tmp/sushi_exile.png

3. Browser JavaScript API (window.atlasAPI) & In-Browser WebMCP (navigator.modelContext)

In browser automation environments (Playwright) or WebMCP-enabled AI browsers (navigator.modelContext), the page automatically registers jiangshan_locate, jiangshan_inspect, and jiangshan_open_person, and exposes window.atlasAPI:

  • window.atlasAPI.locate({ year, place, zoom? }): Drives the map to a single location or multi-stop trajectory and returns structured historical-geographic metadata.
  • window.atlasAPI.inspect({ year, place, person?, stop? }): Read-only query returning the controlling polity, ancient prefecture, modern province/city, leg distances, person events, and canonical shareable URL.
  • window.atlasAPI.resolvePlace(place, year?): Resolves ancient and modern names for cities, strategic passes, poetic landmarks, and battlefields.
  • window.atlasAPI.openPerson(person, stop?) & window.atlasAPI.search(query): Opens a person chronicle on the map or searches across the entire atlas.

Run Locally

No dependencies or build steps required. Clone and serve with any static HTTP server:

git clone https://github.com/DeanChensj/jiangshan-map.git
cd jiangshan-map
python3 -m http.server 8000

Then open http://localhost:8000 in your browser.

Run with Docker

No local dependency needed. Build and start with Docker Compose:

docker compose up -d --build

Then open http://localhost:8008 (the port mapping 8008:80 is set in docker-compose.yml).

The image is a plain nginx:alpine that serves this repository as static files: Dockerfile copies the working tree into /usr/share/nginx/html, and .dockerignore keeps the build context small by excluding .git, .github, data/, docs/, scripts/, skills/, workers/, Markdown files, geojson/demo.html and the README demo images (assets/hero_demo_*.webp, assets/preview_*.webp) — the site does not need any of them at runtime.

To use another port, change the ports mapping in docker-compose.yml (e.g. "9000:80") and run docker compose up -d again.

After pulling upstream changes, rebuild with docker compose up -d --build. Without Compose: docker build -t jiangshan-map:latest . then docker run -d -p 8008:80 --name jiangshan-map jiangshan-map:latest.

Note: the image is built locally; it is not published to any registry.


GeoJSON Export (for Leaflet / MapLibre / QGIS)

The app ships its geometry as compact topology-deduplicated VLQ bundles. To use the vector layers in other projects, generate standard RFC 7946 GeoJSON (EPSG:4326, lon/lat) locally; the output goes to geojson/ and is not committed. The export covers 403 BCE to 1948; later years and the modern province layer are not included. The prefecture layer (郡 / 州 / 府) is left out by default because it derives from CHGIS, whose terms forbid redistribution; add --with-prefectures to include it for local academic, non-commercial use, and do not publish the result.

node scripts/export_geojson.js            # or: node scripts/export_geojson.js <outDir>
node scripts/export_geojson.js --with-prefectures   # adds the CHGIS-derived prefecture layer (local academic use only)
  • snapshots/<id>.geojson — one file per territorial phase; each feature has a bbox and layer (polity / region, plus prefecture with --with-prefectures), title, title_en, category, tint, anchor.
  • index.json — every dynasty's phases with from / to years (negative = BCE, no year 0) and the matching snapshot file.
  • corridors.geojson (walls, canals, roads, sea routes), settlements.geojson, milestones.geojson, neighbors.geojson, and modern/ (rivers, lakes, hydro labels; appear / vanish give the years historical river courses and lakes are shown).

To look up a point without loading every phase, use geojson/jiangshan-locate.js: it loads index.json plus only the snapshot covering the year, then runs a bbox-filtered point-in-polygon test.

const atlas = JiangshanLocate.create(); // or create({ base: '<url of geojson/>' })
const hit = await atlas.locate(118.78, 32.06, 1415); // lon, lat, year
hit.polity.properties.title;     // 明
hit.region.properties.title;     // 南直隶
hit.prefecture;                  // null unless exported with --with-prefectures (then 应天府)

After exporting, serve the repository (python3 -m http.server 8000) and open http://localhost:8000/geojson/demo.html for a Leaflet example: drag the year slider, click the map, or open demo.html?year=1415&lon=118.78&lat=32.06 to load, highlight and zoom automatically. Historical borders are schematic approximations, not surveyed boundaries. The data is GPL-3.0 except the prefecture-level boundaries; see Data Sources & License.


Data Sources & License

Code and the data created by this project are released under GPL-3.0. One layer is not: the prefecture-level boundaries derived from CHGIS, which stay under CHGIS's own terms.

Layer Source License
Code (app, scripts, CLI, MCP server) This project GPL-3.0
Polity outlines (polity) Started from aourednik/historical-basemaps (GPL-3.0), then redrawn by hand against historical texts GPL-3.0
First-level divisions (region: 刺史部 / 道 / 路 / 省 …) Drawn by hand from historical texts; the source of early versions was not recorded GPL-3.0
Prefecture-level boundaries (prefecture: 郡 / 州 / 府, incl. Warring States and Qin commanderies) Derived from CHGIS V6 and the Robert M. Hartwell China Historical GIS, simplified to 0.01° and edited by hand Not GPL-3.0. Academic, non-commercial use only; do not redistribute. See below
Settlements, milestones, journeys, person chronicles, place lore Compiled by this project from historical texts GPL-3.0
Modern provinces DataV GeoAtlas (Alibaba Cloud) Subject to DataV GeoAtlas terms
Rivers, lakes, neighbouring countries Public-domain data Public domain
Terrain hillshade Rendered by scripts/build_terrain_tiles.py from AWS Terrain Tiles (public-domain SRTM, GMTED2010, ETOPO1); only shaded images at no finer than about 1 km per pixel are published GPL-3.0 (images)
Guqin audio Wikimedia Commons (Liu Shui, Pingsha Luoyan, Yangguan Sandie, Zuiyu Changwan, Jiu Kuang) Public domain

Scholarly references (not data sources). Boundaries are checked against historical texts and Tan Qixiang's The Historical Atlas of China (谭其骧主编《中国历史地图集》). No map images or data from that atlas are included in this repository.

Prefecture-level boundaries (CHGIS). This layer is not covered by GPL-3.0 and is shown here for non-commercial, educational use. Do not republish it from this repository; if you need prefecture boundaries, download CHGIS from its official distribution (Harvard Dataverse) under its terms. scripts/export_geojson.js leaves this layer out unless run with --with-prefectures. Cite it as: CHGIS, Version: 6. © Fairbank Center for Chinese Studies of Harvard University and the Center for Historical Geographical Studies at Fudan University, 2016. Provenance details: data/atlas/README.md.

Approximate boundaries. Historical territories and administrative boundaries are schematic approximations of broad jurisdictions, not surveyed borders. Do not cite them as precise or authoritative.

Reusing this project. For the GPL-3.0 layers, credit 江山时序 Jiangshan Atlas with a link to https://github.com/DeanChensj/jiangshan-map and cite the upstream sources above. Screenshots that show the prefecture layer carry the CHGIS terms as well.

Rights holders. If you hold rights in any material here and believe it is used improperly, please open an issue; we will respond and remove it if needed.

Contributing: see CONTRIBUTING.md (中文贡献指南) for repository structure, data conventions, and validation checks.

Report a data error: found a wrong year, place or description? Open a data correction issue and cite a source if you can.

Copyright © 2026 DeanChensj. Licensed under GPL-3.0 (see LICENSE), except as noted above.

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Discussions

all 12

Releases and announcements

4 total
  1. ## 江山时序 · 中国历史交互地图时间轴 v1.3.0 (Chronicles of the Realm v1.3.0) 🌐 **在线体验 (简体中文)**: https://deanchen.me/jiangshan-map/ 🌐 **在线体验 (繁體中文)**: https://deanchen.me/jiangshan-map/?lang=zh-tw 🌐 **Live Interactive Atlas (English)**: https://deanchen.me/jiangshan-map/?lang=en 📖 **背后的故事 (Author's Story)**: [从历史课本里的插图,到 GitHub 1k star:「江山时序」背后的故事](https://deanchen.me/history/atlas/2026/10/25/jiangshan-map-story.html) --- ### ✨ v1.3.0 七项主要更新 (What's New in v1.3.0) #### 1. 古海岸线演变:海岸不再是今天的样子 - **9 处古海域随年代进退 (`#295`:`#310`, `#320`, `#326`)**:渤海湾与黄河三角洲、苏北与长江口、珠江三角洲各分「东汉以前 / 魏晋至北宋 / 金·南宋至清中期」三期,另有 1823 年以前的台南台江内海。拖动时间轴,可以看到渤海湾西岸、苏北平原、崇明岛和珠三角一步步成陆。 - **基岩海岸与河口对齐**:沿海政权与政区边界统一贴合山东半岛、浙闽粤等基岩海岸,黄河、海河、淮河、长江等河口按年代收束到当时的入海位置。 #### 2. 点事溯局:三场大事的双阵营沙盘 - **安史之乱、靖康之变、楚汉之争 (`#317`, `#332`, `#347`, `#369`)**:[`?event=anshi`](https://deanchen.me/jiangshan-map/?event=anshi)、[`?event=jingkang`](https://deanchen.me/jiangshan-map/?event=jingkang)、[`?event=chuhan`](https://deanchen.me/jiangshan-map/?event=chuhan) 各以 10 个节点、三幕展开,对阵双方用两种颜色区分行军与攻守路线;靖康之变与楚汉之争跨朝代时底图随年份切换。 - **可检索、可从时间轴进入 (`#327`, `#353`)**:在搜索框输入事件名,或点击时间轴大事旁的「始末」标记即可打开。 #### 3. 高清山体晕渲地形 (`#268`) - 放大地图后按需加载 z5–z6 山体晕渲瓦片(约 2 km / 1 km 每像素),关中、秦岭—汉中、

  2. ## 江山时序 · 中国历史交互地图时间轴 v1.2.0 (Chronicles of the Realm v1.2.0) 🌐 **在线体验 (简体中文)**: https://deanchen.me/jiangshan-map/ 🌐 **在线体验 (繁體中文)**: https://deanchen.me/jiangshan-map/?lang=zh-tw 🌐 **Live Interactive Atlas (English)**: https://deanchen.me/jiangshan-map/?lang=en 📖 **背后的故事 (Author's Story)**: [从历史课本里的插图,到 GitHub 1k star:「江山时序」背后的故事](https://deanchen.me/history/atlas/2026/10/25/jiangshan-map-story.html) --- ### ✨ v1.2.0 六大核心更新 (What's New in v1.2.0) #### 1. 点国溯史:110 个历代政权百科、都城变迁与君主世系 - **110 个正统与割据政权档案 (`点国溯史`)**:支持直接点击地图上的政权版图、左下角图例色块或在搜索框输入国号(如 `前秦`、`西辽`、`南唐`、`吴越`、`大顺`),展开该政权的存续纪年、都城迁徙、核心疆域概述、完整君主世系(含庙号/谥号、名讳与在位年份)及关联大事。 - **第一性原理搜索排序**:搜索框按「政权 → 人物/年号 → 古今地名 → 历史大事」本体层级精准排序,输入国号或朝代名即可一键聚焦对应疆域与历史阶段。 #### 2. 多人同看 · 青史交会:双人/三人轨迹同屏对比与 124 位人物纪传 - **双人/三人时空轨迹同屏对比 (`多人同看`)**:支持在搜索框或 URL 中传入 2–3 位历史人物(如 [`?person=libai,dufu`](https://deanchen.me/jiangshan-map/?person=libai,dufu)、[`?person=libai,dufu,gaoshi`](https://deanchen.me/jiangshan-map/?person=libai,dufu,gaoshi)、[`?person=zhugeliang,simayi`](https://deanchen.me/jiangshan-map/?person=zhugeliang,simayi)),以高对比度分色游丝同屏绘制多人生平足迹,自动识别并高亮 **「同时同地交会」**(如天宝三载李白、杜甫、高适梁宋壮游)与 **「异时同地重逢」**。 - **人物库扩充至 124 位**:新增高适、陈胜、吕布、袁绍、张飞、赵云、姜维、邓艾、桓

  3. ## 江山时序 · 中国历史交互地图时间轴 v1.1.0 (Chronicles of the Realm v1.1.0) 🌐 **在线体验 (简体中文)**: https://deanchen.me/jiangshan-map/ 🌐 **在线体验 (繁體中文)**: https://deanchen.me/jiangshan-map/?lang=zh-tw 🌐 **Live Interactive Atlas (English)**: https://deanchen.me/jiangshan-map/?lang=en 📖 **背后的故事 (Author's Story)**: [从历史课本里的插图,到 GitHub 1k star:「江山时序」背后的故事](https://deanchen.me/history/atlas/2026/10/25/jiangshan-map-story.html) --- ### ✨ v1.1.0 六大核心更新 (What's New in v1.1.0) #### 1. 点人溯事 & 点物溯史:104 位历史人物生平轨迹 + 「传国玉玺」千载流转彩蛋 - **104 位历史人物时空纪传 (`点人溯事`)**:将原有的 7 条独立行迹全面升级为统一的「点人溯事」引擎,覆盖从战国至明清的 **104 位帝王将相、文豪名僧与航海家**(如秦始皇、张骞、霍去病、曹操、诸葛亮、司马懿、玄奘、李白、杜甫、苏轼、辛弃疾、岳飞、文天祥、王阳明、郑和等)。 - 支持底栏书页式翻站(`上一站 / 下一站` 或键盘 `← / →`)与空格键自动巡礼,王朝版图、在位君主与年号随人物足迹同步演进;支持从任意站点点开城池查看政区沿革后,一键 `‹ 返回` 人物主线。 - **「传国玉玺」千载流转彩蛋 (`点物溯史`)**:严格依据《资治通鉴》本纪与胡三省注,考订串联从公元前 283 年邯郸「完璧归赵」、前 221 年咸阳李斯磨璧制玺、前 206 年子婴轵道奉玺、公元 8 年未央宫王政君投玺崩角、191 年孙坚洛阳甄官井得玺,直至 936 年后唐末帝李从珂登洛阳玄武楼自焚失传的 **10 朝 13 站 1,219 年流转轨迹**。 - **双入口探索**:既可在搜索框检索 `传国玉玺` / `玉玺` / `和氏璧` / `受命于天`(👉 [一键直达 `?person=yuxi`](https://deanchen.me/jiangshan-map/?person=yuxi)),也可在浏览相关重大历史事件时点击素墨方印 **`[玺]`** 偶遇切入。 #### 2. 二十四史与《资治通鉴》全朝代疆域精校(164 → 183 幅多阶段快照) - **18 个历史时期全面史料校勘**:对照《史记》《汉书》《三国志》《晋书》《资治

  4. ## 江山时序 · 中国历史交互地图时间轴 (Jiangshan Historical Atlas v1.0.0) 🌐 **在线体验 / Live Interactive Atlas**: **[https://deanchen.me/jiangshan-map/](https://deanchen.me/jiangshan-map/)** 📚 **专题图志总目录 / Static Historical Geography Directory**: **[https://deanchen.me/jiangshan-map/topics/index.html](https://deanchen.me/jiangshan-map/topics/index.html)** 🤖 **AI / LLM Documentation (`llms.txt`)**: **[https://deanchen.me/jiangshan-map/llms.txt](https://deanchen.me/jiangshan-map/llms.txt)** --- ### 核心特性 (Key Highlights) 1. **两千四百年连续时间轴与 164 幅多阶段版图快照(403 BCE – Present)** - 涵盖战国、秦、西汉、东汉、三国、西晋、东晋十六国、南北朝、隋、唐、五代十国、北宋(辽·西夏·大理)、南宋(金·蒙·大理)、元、明、清、中华民国与现代共 **18 个历史时期**。 - 支持逐年/逐事件推演、帝王年号与庙号谥号显示(342 段年号区间)、1,382 座历代城池古今地名对照与 395 项重大历史事件空间浮签。 2. **点地溯源 · 两千四百年古今政区沿革(Place Genealogy)** - 点击地图任意坐标或检索古今地名(如长安、建康、江州、黄州、临安、蓝关、京口),即刻生成该地点从战国秦汉郡县、唐道、宋路到元明清行省与现代省市的 **18 朝完整政区沿革卡片**。 3. **动态历史水系、三大工程走廊与天下二十名关** - 内置黄河五次重大改道(禹贡故道、东汉王景故道、北宋北流、金元明清夺淮入海、1855 铜瓦厢改道)与历史湖泊(云梦泽、巨野泽/梁山泊、彭蠡泽、洪泽湖)动态消长。 - 标绘秦汉明万里长城、隋唐元京杭大运河、丝绸之路,以及函谷关、潼关、剑门关、雁门关、玉门关、阳关、山海关、居庸关等 **20 座天下名关雄隘**。 4. **青史行迹与古诗词多维时空路线引擎(`window.atlasAPI`)** - 内置秦始皇、张骞、诸葛亮、玄奘、李白、苏轼、王阳明 **7 条人物时空巡礼**。 - 支持通过 URL 参数(`?year=...&place=...`)一键绘制古诗词名篇路线

Code frequency

additions and deletions
+1.4M-1.4MWeek of 2026-07-19: +4,967 linesWeek of 2026-07-19: -863 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesWeek of 2026-08-02: +0 linesWeek of 2026-08-02: -0 linesWeek of 2026-08-09: +0 linesWeek of 2026-08-09: -0 linesWeek of 2026-08-16: +0 linesWeek of 2026-08-16: -0 linesWeek of 2026-08-23: +0 linesWeek of 2026-08-23: -0 linesWeek of 2026-08-30: +0 linesWeek of 2026-08-30: -0 linesWeek of 2026-09-06: +0 linesWeek of 2026-09-06: -0 linesWeek of 2026-09-13: +0 linesWeek of 2026-09-13: -0 linesWeek of 2026-09-20: +0 linesWeek of 2026-09-20: -0 linesWeek of 2026-09-27: +0 linesWeek of 2026-09-27: -0 linesWeek of 2026-10-04: +126,953 linesWeek of 2026-10-04: -108,870 linesWeek of 2026-10-11: +88,571 linesWeek of 2026-10-11: -29,198 linesWeek of 2026-10-18: +37,988 linesWeek of 2026-10-18: -10,224 linesWeek of 2026-10-25: +28,340 linesWeek of 2026-10-25: -7,385 linesWeek of 2026-11-01: +1,403,297 linesWeek of 2026-11-01: -439,109 linesWeek of 2026-11-08: +288,880 linesWeek of 2026-11-08: -172,965 linesWeek of 2026-11-15: +1,463 linesWeek of 2026-11-15: -312 linesJul 19, 2026Nov 15, 2026
+2M lines added, -768.9K removed over the last year.

Commits per week

last 52 weeks
1140Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 0 commitsWeek of 2026-03-29: 0 commitsWeek of 2026-04-05: 0 commitsWeek of 2026-04-12: 0 commitsWeek of 2026-04-19: 0 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 0 commitsWeek of 2026-05-10: 0 commitsWeek of 2026-05-17: 0 commitsWeek of 2026-05-24: 0 commitsWeek of 2026-05-31: 0 commitsWeek of 2026-06-07: 0 commitsWeek of 2026-06-14: 0 commitsWeek of 2026-06-21: 0 commitsWeek of 2026-06-28: 0 commitsWeek of 2026-07-05: 0 commitsWeek of 2026-07-12: 0 commitsWeek of 2026-07-19: 4 commitsWeek of 2026-07-26: 0 commitsWeek of 2026-08-02: 0 commitsWeek of 2026-08-09: 0 commitsWeek of 2026-08-16: 0 commitsWeek of 2026-08-23: 0 commitsWeek of 2026-08-30: 0 commitsWeek of 2026-09-06: 0 commitsWeek of 2026-09-13: 0 commitsWeek of 2026-09-20: 0 commitsWeek of 2026-09-27: 0 commitsWeek of 2026-10-04: 38 commitsWeek of 2026-10-11: 114 commitsWeek of 2026-10-18: 58 commitsWeek of 2026-10-25: 47 commitsWeek of 2026-11-01: 76 commitsWeek of 2026-11-08: 72 commitsWeek of 2026-11-15: 13 commitsNov 23, 2025Nov 15, 2026
422 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 3 commitsSun 1:00 — 2 commitsSun 2:00 — 6 commitsSun 3:00 — 2 commitsSun 4:00 — 1 commitsSun 5:00 — 2 commitsSun 6:00 — 3 commitsSun 7:00 — 2 commitsSun 8:00 — 4 commitsSun 9:00 — 2 commitsSun 10:00 — 5 commitsSun 11:00 — 5 commitsSun 12:00 — 1 commitsSun 13:00 — 7 commitsSun 14:00 — 3 commitsSun 15:00 — 3 commitsSun 16:00 — 7 commitsSun 17:00 — 6 commitsSun 18:00 — 5 commitsSun 19:00 — 6 commitsSun 20:00 — 9 commitsSun 21:00 — 4 commitsSun 22:00 — 6 commitsSun 23:00 — 4 commitsMon 0:00 — 6 commitsMon 1:00 — 6 commitsMon 2:00 — 1 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 0 commitsMon 8:00 — 1 commitsMon 9:00 — 4 commitsMon 10:00 — 3 commitsMon 11:00 — 4 commitsMon 12:00 — 0 commitsMon 13:00 — 1 commitsMon 14:00 — 1 commitsMon 15:00 — 0 commitsMon 16:00 — 0 commitsMon 17:00 — 0 commitsMon 18:00 — 0 commitsMon 19:00 — 0 commitsMon 20:00 — 0 commitsMon 21:00 — 4 commitsMon 22:00 — 1 commitsMon 23:00 — 4 commitsTue 0:00 — 5 commitsTue 1:00 — 2 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 1 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 0 commitsTue 10:00 — 3 commitsTue 11:00 — 1 commitsTue 12:00 — 2 commitsTue 13:00 — 3 commitsTue 14:00 — 5 commitsTue 15:00 — 3 commitsTue 16:00 — 1 commitsTue 17:00 — 2 commitsTue 18:00 — 5 commitsTue 19:00 — 2 commitsTue 20:00 — 5 commitsTue 21:00 — 6 commitsTue 22:00 — 8 commitsTue 23:00 — 3 commitsWed 0:00 — 9 commitsWed 1:00 — 3 commitsWed 2:00 — 0 commitsWed 3:00 — 0 commitsWed 4:00 — 1 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 0 commitsWed 9:00 — 3 commitsWed 10:00 — 4 commitsWed 11:00 — 3 commitsWed 12:00 — 1 commitsWed 13:00 — 1 commitsWed 14:00 — 0 commitsWed 15:00 — 2 commitsWed 16:00 — 0 commitsWed 17:00 — 2 commitsWed 18:00 — 2 commitsWed 19:00 — 3 commitsWed 20:00 — 2 commitsWed 21:00 — 3 commitsWed 22:00 — 3 commitsWed 23:00 — 5 commitsThu 0:00 — 3 commitsThu 1:00 — 4 commitsThu 2:00 — 2 commitsThu 3:00 — 0 commitsThu 4:00 — 3 commitsThu 5:00 — 1 commitsThu 6:00 — 0 commitsThu 7:00 — 0 commitsThu 8:00 — 0 commitsThu 9:00 — 0 commitsThu 10:00 — 1 commitsThu 11:00 — 2 commitsThu 12:00 — 1 commitsThu 13:00 — 3 commitsThu 14:00 — 2 commitsThu 15:00 — 1 commitsThu 16:00 — 1 commitsThu 17:00 — 2 commitsThu 18:00 — 1 commitsThu 19:00 — 6 commitsThu 20:00 — 6 commitsThu 21:00 — 6 commitsThu 22:00 — 3 commitsThu 23:00 — 2 commitsFri 0:00 — 2 commitsFri 1:00 — 7 commitsFri 2:00 — 5 commitsFri 3:00 — 1 commitsFri 4:00 — 4 commitsFri 5:00 — 1 commitsFri 6:00 — 1 commitsFri 7:00 — 3 commitsFri 8:00 — 1 commitsFri 9:00 — 5 commitsFri 10:00 — 1 commitsFri 11:00 — 2 commitsFri 12:00 — 3 commitsFri 13:00 — 2 commitsFri 14:00 — 2 commitsFri 15:00 — 3 commitsFri 16:00 — 2 commitsFri 17:00 — 6 commitsFri 18:00 — 2 commitsFri 19:00 — 1 commitsFri 20:00 — 2 commitsFri 21:00 — 3 commitsFri 22:00 — 4 commitsFri 23:00 — 5 commitsSat 0:00 — 2 commitsSat 1:00 — 6 commitsSat 2:00 — 1 commitsSat 3:00 — 1 commitsSat 4:00 — 4 commitsSat 5:00 — 3 commitsSat 6:00 — 3 commitsSat 7:00 — 3 commitsSat 8:00 — 1 commitsSat 9:00 — 3 commitsSat 10:00 — 2 commitsSat 11:00 — 4 commitsSat 12:00 — 1 commitsSat 13:00 — 3 commitsSat 14:00 — 4 commitsSat 15:00 — 4 commitsSat 16:00 — 5 commitsSat 17:00 — 1 commitsSat 18:00 — 3 commitsSat 19:00 — 1 commitsSat 20:00 — 3 commitsSat 21:00 — 3 commitsSat 22:00 — 2 commitsSat 23:00 — 3 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing

last 52 weeks
Maintainer commits388 (94%)
Community commits23 (6%)

411 commits in total over the last year.

DateListRankStars gained
Nov 19, 2026daily#13+991
Nov 18, 2026daily#13+991
Nov 17, 2026daily#6+285
Nov 16, 2026daily#6+285
  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • react/react

    The library for web and native user interfaces.

    252.8K stars · JavaScript

  • DietrichGebert/ponytail

    Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

    195.7K stars · JavaScript

  • vercel/next.js

    The React Framework

    143.6K stars · JavaScript

  • addyosmani/agent-skills

    Production-grade engineering skills for AI coding agents.

    119.4K stars · JavaScript

  • Leonxlnx/taste-skill

    Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

    119.4K stars · JavaScript