{/* tangram-layers SPDX-License-Identifier: MIT Copyright (c) vis.gl contributors */}
With gratitude to Brett Camper, the Mapzen team, the original Tangram contributors and the open mapping community. This project preserves and extends their work.
Original rendering by Tangram/Mapzen; vector tiles by OpenFreeMap; elevation tiles in the terrain POC by Mapterhorn. These acknowledgements do not replace source-specific map attribution or imply endorsement.
tangram.gl combines a standalone luma.gl-backed Tangram renderer with a deck.gl basemap adapter. It is an experimental custodian fork, not the official Tangram website. Both module packages remain private and unpublished.
Start with Getting started, try the examples, or read What's new and the upgrade guide.
- Working with AI agents — version-aware documentation and browser verification.
- Architecture — package boundaries and ownership.
- View integration — current capabilities and remaining work.
- Projection conventions — domains, axes and units.
- Projected basemaps — optional earth projections and navigation.
- Tile providers — data schemas and required attribution.
- Tile loading — source/tileset boundaries and resource policy.
- Bundling — reproducible artifact measurements.
- Tangram concepts — sources, layers and styling.
- vis.gl conformance — replacement criteria and parser gaps.
Package entries · Classic API · Scene · Renderer · HostFrame · Styling
Package entries · TangramLayer · Experimental WebXR
Development and validation · Monorepo · Licensing · Release workflow
Tangram grew out of Mapzen's open-source mapping work. The original repository, legacy documentation, and Mapzen product page preserve that context.
The demos guide catalogs historical projects. Useful scene references include simple-demo, filters-demo, shaders-demo, lights-cameras-demo, and terrain-demos.
The Sandbox contains the original Crosshatch and Albers experiments. The local classic playground ports these ideas, including a bundled US fixture for the animated Albers morph. Historical services may no longer work; use current provider and attribution guidance rather than copying old credentials or service URLs.