How maplibre/martin works
Project type and purpose
• Martin is an open-source tile server and toolkit written in Rust.
• It provides both a library (core tile‐generation engine) and multiple command-line binaries (martin, martin-cp, mbtiles, etc.), plus a demo full-stack application (PostgreSQL, Rust server, React frontend).
• Its purpose is to serve vector tiles on‐the‐fly from PostGIS, PMTiles, MBTiles, composite sources, sprites, and fonts.
File structure
• Top‐level crates (Cargo.toml describes a workspace):
• martin/ — core library & binaries (martin, martin-cp)
• mbtiles/ — MBTiles CLI tool & library
• martin-tile-utils/ — shared Rust helpers (decoders, fixtures)
• demo/ directory:
• docker-compose.yml defines Postgres, Rust server, React frontend
• demo/frontend holds a Vite/React UI for “Try it” demos
• docs/ directory: mdBook documentation
• tests/ and fixtures/ for integration/unit tests and sample data
• Workflow configs for CI, audit, benchmarks, release
README for additional insights
• Core features: on‐the‐fly vector tile generation, support for multiple tile formats, composite sources, bulk generation (martin-cp), MBTiles utilities (mbtiles tool).
• Provides HTTP server with configurable CORS, TLS, API endpoints (/tiles/{z}/{x}/{y}.{format}).
• Can run as CLI, Docker container, AWS Lambda.