MaplatEditor is the desktop data-authoring tool for the
Maplat historical map viewer. It
provides a GUI for registering maps, setting ground control points, generating
tiles, and assembling the app data consumed by the Maplat viewer libraries
(@maplat/ui / @maplat/core). MaplatEditor runs on Windows and macOS.
MaplatEditor is open-source under the Apache License 2.0 (from version 0.7.0).
The package is not published to npm (private: true in package.json);
binaries are distributed via GitHub Releases.
Read this document in Japanese / 日本語で読む
- Desktop application for authoring Maplat historical map data (Windows / macOS)
- GUI for map registration, control-point setting, and tile generation
- Creates data consumable by Maplat viewer libraries (
@maplat/ui/@maplat/core) - Bundles OpenLayers and the Maplat core libraries — no separate install needed
- Open-source (Apache 2.0 from version 0.7.0) — companion to the Maplat viewer ecosystem
Release-dependent information (ADR-0012). The version
0.7.0below is the current release; update it on each new release.
MaplatEditor is distributed as a desktop installer via GitHub Releases.
| Platform | Download |
|---|---|
| Windows (x64) | MaplatEditor-Windows-0.7.0-x64-Setup.exe |
| macOS (Apple Silicon) | MaplatEditor-Mac-0.7.0-arm64.dmg |
| macOS (Intel x64) | MaplatEditor-Mac-0.7.0-x64.dmg |
See the v0.7.0 release page for the full list of assets (including Linux AppImage and Windows arm64) and release notes.
Screenshots of the MapList and MapEdit screens are pending. The legacy Wiki tutorial images are preserved in the Wiki Gallery.
Clone the repository and install dependencies.
git clone https://github.com/code4history/MaplatEditor.git
cd MaplatEditor
pnpm installStart the development server with hot reload.
pnpm devpnpm build # Build the Vite app
pnpm dist # Build desktop installer for the current OS
pnpm dist:mac # macOS (universal)
pnpm dist:win # Windows
pnpm dist:linux # LinuxMaplatEditor is a desktop application built with Electron + Vite. There is no
enginesfield inpackage.json; the versions below are the tested development environment.
- Node.js: v20 or v22 (LTS tested via GitHub Actions)
- pnpm:
>=9.0.0(required; the project uses pnpm)
MaplatEditor is part of the Maplat ecosystem by Code for History. See the full ecosystem map (8 repositories + product/corporate sites):
📖 Ecosystem Map — (the diagram is currently kept in a private planning repository; the Sister repositories table below is the public substitute)
| Repository | License | npm | Role |
|---|---|---|---|
| Maplat | Apache 2.0 | @maplat/ui |
Main viewer |
| MaplatCore | Apache 2.0 | @maplat/core |
Core library |
| MaplatTin | Apache 2.0 | @maplat/tin |
TIN conversion |
| MaplatTransform | Apache 2.0 | @maplat/transform |
Coordinate transform |
| MaplatEditor | Apache 2.0 | — | Data authoring tool (desktop) |
MaplatEditor is the data authoring tool used to create the maps and POIs that the viewers above render. The Maplat ecosystem is end-to-end: author with MaplatEditor, serve with any of the viewer libraries.
| Audience | Link | Purpose |
|---|---|---|
| Project info / features / cases | https://www.maplat.jp/en/ | Product site |
| Sponsor / business inquiry | https://www.nayuta-inc.co.jp/en/ | Corporate site (Nayuta, Inc.) |
ADR-0013: Apache-licensed repositories (this one) link to both sites. MIT-licensed sister repos (Weiwudi / Quyuan / Chuci) carry no Nayuta link.
Apache License 2.0 — see LICENSE.
Copyright 2019-2026 Kohei Otsuka, Code for History / Nayuta, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.