Interactive web application for creating custom cartographic visualizations using composite map projections
Atlas Composer consists of an interactive editor application and a set of libraries to render complex composite projections (e.g., showing France with its overseas territories in a compact view).
The Atlas Composer Editor is a visual tool to:
- Visualize multi-atlas presets (France, USA, Europe, etc).
- Customize projections with real-time feedback.
- Edit territory placement and view modes (Composite, Split, Unified).
- Export production-ready code or JSON data.
To run the editor locally:
# Install dependencies
pnpm install
# Prepare map data (Natural Earth)
pnpm run geodata:prepare
# Start the dev server
pnpm run devVisit http://localhost:5173 to start editing.
Atlas Composer is organized as a monorepo. While the application is the visual interface, the core logic is available as standalone packages for your own projects.
| Package | Description |
|---|---|
| @atlas-composer/projection-loader | Runtime. The official library to load and render exported maps in your applications. Lightweight and zero-dependency. |
| @atlas-composer/preset-library | Data. A curated collection of standard map presets (e.g. france-standard, usa-albers). |
| @atlas-composer/specification | Contract. JSON Schemas and TypeScript definitions defining the map configuration format. |
| @atlas-composer/projection-core | Engine. Low-level D3 stream utilities and projection composition logic. |
For detailed technical documentation, please refer to the ./docs directory:
- Architecture Overview - System design and core concepts.
- Atlases - How atlases are structured.
- Projections - Details on the projection system.
- Vue Architecture - Frontend application structure.
This project builds upon the pioneering work of:
- D3.js / d3-geo by Mike Bostock — The stream multiplexing approach and composite projection architecture are derived from the
geoAlbersUsaimplementation. - d3-composite-projections by Roger Veciana — Inspiration for extending the composite projection pattern to multiple countries.
See THIRD-PARTY-LICENSES.md for full license details.
MIT © ShallowRed