mrkeyoor.com_
Fri 23 Oct 19:29 UTC
Webevaluationupdated 23 Oct 2026

jiangshan-map review

Chronicles of the Realm (jiangshan-map) is an interactive historical atlas of China. Its README documents English access, historical place-name genealogy and routes for historical figures. These are documented capabilities, not browser behavior verified in this assessment.

Verdict

Consider jiangshan-map as a Chinese-history reading companion after checking a familiar place, year and intended device. Data reuse requires separate checks of schematic geometry, layer-specific non-commercial terms and the 1948 export cutoff. We did not run commit 5e940f6, and the supplied README is not pinned to that checkout.

We ran it

Screenshot of jiangshan-map (deanchen.me/jiangshan-map)

Answers from our run

Did you run jiangshan-map yourself?

No. Its code is JavaScript, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use jiangshan-map?

Commercial projects assuming every included layer is available under GPL-3.0. Specified CHGIS and Hartwell-derived layers retain academic, non-commercial terms.

What are the alternatives to jiangshan-map?

QGIS, historical-basemaps. Consider jiangshan-map as a Chinese-history reading companion after checking a familiar place, year and intended device.

SetupN/AThe harness did not run the project, and the documented static-serving workflow was not reproduced.
Docs4/5The rubric is visible in the body: 1 means no usable entry point, 2 a partial starting procedure, 3 a navigable reference, 4 explicit task instructions with stated limitations, and 5 a task reproduced from those instructions. The supplied README meets level 4 through local-serving and export instructions, example links and explicit data exceptions. No task was reproduced.
CommunityN/APush and release records show repository activity, but the supplied evidence does not establish support response quality or contributor experience.
MaturityN/ABrowser reliability and historical-data accuracy were not independently exercised, so research fitness and operational reliability remain unknown.

Who it’s for

Readers of Chinese history or poetry looking for geographic context.
Teachers who can check a selected place and year against their lesson sources and classroom devices.
Developers evaluating historical geographic data who can inspect layer permissions, approximation limits and export coverage.

Who it’s NOT for

Commercial projects assuming every included layer is available under GPL-3.0. Specified CHGIS and Hartwell-derived layers retain academic, non-commercial terms.
Researchers requiring surveyed boundary precision. The README describes historical contours and prefecture boundaries as schematic approximations.
Projects requiring exported modern province boundaries or years after 1948. The documented GeoJSON export excludes both.

Setup reality

We did not run jiangshan-map at commit 5e940f6 on October 23, 2026. The harness recorded no supported ecosystem for this JavaScript repository and no Dockerfile. Installation, build, test and audit results are absent.

The recorded sandbox configuration was 3 CPUs and 8 GB RAM, with no image identified. Those resources do not establish browser requirements, and actual runtime and operating-system versions are unknown.

The supplied README documents serving the checkout with Python's HTTP server and opening it in a browser. It also documents English access through lang=en. This workflow was not reproduced. The README extracts are not pinned to commit 5e940f6, so their instructions and capabilities should not be treated as verified behavior of that exact checkout.

A reading companion and a reusable dataset need different checks

An old place name in a poem gives you a concrete starting point for evaluating Chronicles of the Realm, the project named jiangshan-map. Its README describes Trace Place cards for following changes in a place's name and administrative jurisdiction, plus Person Chronicle routes for figures such as Su Shi. English documentation and an English interface are documented.

That makes it a candidate for readers and teachers seeking geographic context. Reusing its geometry requires a separate decision: the README specifies approximate borders, exceptions to GPL-3.0 licensing and an export cutoff. Those limits matter before a developer adapts the data for another product.

What our assessment could verify

We did not run jiangshan-map. On October 23, 2026, the harness recorded commit 5e940f6 and reported no supported ecosystem for this JavaScript repository and no Dockerfile. This establishes a limit of the harness assessment, not a product failure. There are no installation, build, test or audit results.

The recorded sandbox had 3 CPUs and 8 GB RAM, with no image identified. It provides no evidence about rendering speed, mobile behavior or browser requirements. Actual runtime and operating-system versions are unknown.

The supplied README extracts are not pinned to that commit. This review therefore separates the recorded checkout assessment from the repository's documented workflows; it does not establish that every documented feature exists or works at commit 5e940f6.

Check one place before planning a lesson

The README documents cloning the repository, serving it with Python's HTTP server and opening the page in a browser. It also documents shareable year-and-place links and the English option lang=en. None of those browser steps was reproduced here.

For a lesson, start with one location from the assigned text. Check the selected year, place-name interpretation and displayed jurisdiction against the lesson's sources, then open the link on the intended classroom device. This is a suggested evaluation procedure, not an exercise conducted for this review.

Schematic borders need their qualification

The atlas describes its historical borders as schematic approximations. Its credits explain that the territorial contours and prefecture boundaries illustrate broad historical jurisdictions rather than modern surveyed borders.

Keep that qualification with any screenshot or exported layer. A reader seeking geographic context may find a broad outline useful; a researcher making a precise jurisdiction claim needs to inspect the relevant historical evidence. The README's credits identify references, but this assessment does not independently validate their use for individual places and years.

Some layers retain non-commercial terms

The README says prefecture-level boundaries and Warring States territories derived from CHGIS V6 and the Hartwell China Historical GIS retain their original academic, non-commercial terms and are not relicensed under GPL-3.0.

A commercial developer should resolve the terms for the intended layer before incorporating it into a product. The repository's GPL-3.0 label does not settle permissions for those exceptions. This review has not audited the licensing chain or determined whether a particular reuse is permitted.

GeoJSON export stops at 1948

The documented GeoJSON export covers 403 BCE through 1948 and excludes later years and the modern province layer. The interface's advertised coverage through the present should therefore not be read as the export's coverage.

Check the required years and layers before adapting the output. If the project needs modern provincial polygons, this documented export does not supply them. Export generation and downstream use were not tested here.

Alternatives depend on the work you need to do

QGIS supports spatial-data editing and georeferencing. Consider it when you need a GIS workspace to assemble and inspect your own geographic evidence. You still need suitable source data and permission to use it.

historical-basemaps provides historical boundary data intended for world or continental mapping. Its README asks users to compare the maps with other sources before academic use. Consider it for broader geographic datasets, while checking its coverage and precision for your project. Jiangshan-map credits this project, so the relationship does not provide independent corroboration of accuracy.

Repository activity does not establish accuracy

The supplied repository metadata records a push on October 23, 2026. The supplied release record dates v1.0.0 to October 17, 2026. These establish repository activity, without showing what the later push corrected or how accurately the atlas represents historical geography. The assessed checkout remains commit 5e940f6; it is not identified here as the v1.0.0 release checkout.

How the documentation rating works

Documentation receives 4 out of 5 for the supplied material. The rubric assigns 1 to material without a usable entry point, 2 to a partial starting procedure, 3 to a navigable reference, 4 to explicit task instructions with stated limitations, and 5 to instructions from which a task was reproduced in the assessment. The README supplies a local-serving procedure, example links, export instructions and explicit data exceptions. No task was reproduced, so it does not meet the fifth level.

Setup ease, community support and maturity remain unassessed. The supplied evidence does not establish successful setup, support response quality, browser reliability or historical accuracy.

For a reading companion, begin with one familiar place and check its interpretation. For data reuse, begin with the intended layer's permissions and export coverage.

Alternatives

ProjectWhat it isPick it when
QGISA GIS workspace supporting spatial-data editing and georeferencing.Consider QGIS when you need to assemble and inspect your own geographic evidence and can supply suitable data with appropriate permissions.
historical-basemapsHistorical boundary data intended for world or continental mapping.Consider historical-basemaps when you need broader geographic datasets and can verify their coverage and precision against other sources.

What people are saying

  1. [github-trending] DeanChensj/jiangshan-map

Sources

  1. Chronicles of the Realm README and data terms
  2. QGIS capabilities
  3. historical-basemaps scope and verification warning
  4. Jiangshan Map repository metadata
  5. Jiangshan Map v1.0.0 release

More web reviews

ziwei-doushu · Leaflet · react-virtualized · emdash · dioramas · elpis · the whole board →