How rastapasta/mapscii works
MapSCII renders interactive vector-tile maps in a terminal. The workflow starts with CLI options, initializes tile access and styling, fetches and parses visible tiles, transforms features into terminal drawing operations, and writes Braille or ASCII frames. Its documented local MBTiles/offline source and remote tile-server modes are represented; source excerpts do not show every input or persistence detail, so uncertain wiring is omitted.
Main entry points: TileSource.js Tile source · Mapscii.js Map interaction · Renderer.js Map renderer · main.js CLI startup
Components 16
Application control
- CLI startup
main.js - Map interaction
src/Mapscii.js - Runtime settings
src/config.js
Tile data
- Tile source
src/TileSource.js - Vector tile server
- Local MBTiles
- Tile decoding
src/Tile.js
Rendering
- Style rules
src/Styler.js - Map renderer
src/Renderer.js - Label placement
src/LabelBuffer.js - Drawing canvas
src/Canvas.js - Map utilities
src/utils.js - Style files
styles
Terminal output
- Braille buffer
src/BrailleBuffer.js - Terminal
Other components
- Map viewer
Connections 21
- Map viewer → CLI startup: starts
README.md - CLI startup → Runtime settings: reads defaults
main.js - CLI startup → Map interaction: initializes
main.js - Map interaction → Runtime settings: uses settings
src/Mapscii.js - Map interaction → Tile source: initializes
src/Mapscii.js - Map interaction → Map renderer: draws map
src/Mapscii.js - Map interaction → Style files: loads style
src/Mapscii.js - Tile source → Vector tile server: fetches tiles
src/TileSource.js - Tile source → Local MBTiles: reads tiles
src/TileSource.js - Tile source → Tile decoding: creates and loads
src/TileSource.js - Tile source → Style rules: sets styler
src/TileSource.js - Tile decoding → Style rules: selects styles
src/Tile.js - Map renderer → Tile source: requests tiles
src/Renderer.js - Map renderer → Style rules: configures source
src/Renderer.js - Map renderer → Label placement: places labels
src/Renderer.js - Map renderer → Drawing canvas: draws features
src/Renderer.js - Map renderer → Map utilities: projects coordinates
src/Renderer.js - Drawing canvas → Braille buffer: writes pixels
src/Canvas.js - Braille buffer → Runtime settings: reads display mode
src/BrailleBuffer.js - Map interaction → Terminal: writes frames
src/Mapscii.js - Tile source → Vector tile server: persists downloaded tiles