Mapshell is an experimental command-driven generative map interface built on MapLibre GL JS. Maps are controlled with simple verb–noun commands, similar to a shell interface.

show roads
hide buildings
zoom sapporo
inspect waterways

→ Live demo

Current demo status: the GitHub Pages page is built with Vite as a single self-contained docs/index.html runtime using MapLibre GL JS, Protomaps basemaps, and PMTiles-backed terrain. The runtime now parses typed commands in the UI, logs the parsed structure, and leaves command execution work to future issues.

mapshell/
├── SPEC.md               # Vocabulary, commands, and architecture
├── README.md
├── Justfile              # just dev / build / preview wrappers
├── index.html            # Vite entry HTML
├── package.json          # Pinned runtime dependencies
├── config/
│   ├── datasets.json     # Maps vocabulary terms to style layer patterns
│   └── styles.json       # Default paint/layout properties
├── docs/
│   ├── index.html        # Built single-file GitHub Pages runtime
│   ├── vocabulary.json   # Public semantic vocabulary registry
│   └── vocabulary.js     # Browser lookup helpers for the registry
├── src/
│   ├── main.js              # Runtime entrypoint
│   ├── command_parser.js    # parseCommand(input) → { verb, objects } / { verb, target }
│   ├── dataset_resolver.js  # DatasetResolver – resolve terms to datasets
│   ├── action_engine.js     # ActionEngine – execute actions on a MapLibre map
│   └── map.js               # initMap(container, options) – create a map

Install the pinned dependencies once:

npm install

Use just to wrap the Vite workflow:

just dev
just build
just preview

just dev and just preview both run Vite with --host, so LAN access stays available. The production build is written directly to docs/index.html as a self-contained single file.

Full vocabulary and architecture: see SPEC.md.

Canonical geographic terms (plural nouns) are published in docs/vocabulary.json and exposed in the browser console through getVocabulary(term) and listVocabulary():

roads · railways · airports · buildings · waterways · rivers · inlandwater · coastline · coast · ocean · elevation · contours · landuse · pois · schools · hospitals

• Simplicity first – minimal vocabulary, minimal code
• Command-driven interaction – all map state changes via commands
• JSON configuration – vocabulary and datasets are data, not code
• Single-file deploy – Vite builds a self-contained docs/index.html
• No heavy frameworks – vanilla JavaScript only

The runtime uses a Protomaps dark basemap from the Martin TileJSON endpoint:

• https://tunnel.optgeo.org/martin/protomaps-basemap

Terrain and hillshade come from:

• https://tunnel.optgeo.org/martin/mapterhorn

CC0 1.0 Universal – public domain