Documentation
Learn X-GIS.
X-GIS is a declarative language for cartographic rendering on WebGPU. Declare data sources and styled layers; the compiler emits the WGSL, buffer layouts, and projection math.
Browse
Get started
Quickstart
Five-minute tutorial — install, declare a source + layer, mount on a canvas.
Open
Guides
Cookbook
Copy-paste recipes — 3D buildings, categorical fill, zoom-fade roads, road casing, animation.
Open
Guides
Mapbox migration
Conceptual differences from Mapbox GL JS, the converter walkthrough, and expression mapping examples.
Open
Guides
Mapbox coverage
Auto-validated matrix of every Mapbox Style Spec property — supported / partial / unsupported, with impact tier and source pointer.
Open
Language
Language reference
Every block, statement, and modifier with a real working code sample.
Open
Language
Source types
GeoJSON, PMTiles, TileJSON, raster XYZ — fields and caveats per kind.
Open
Language
Function reference
Every builtin: clamp, interpolate, sin / cos / atan2, circle / arc / polygon, the zoom accessor, and constants.
Open
Language
Expressions & operators
Operator precedence and the four idioms (bracket binding, match, filter, field modifier) that bake expressions into utilities.
Open
Language
Utility catalog
The full Tailwind-style class set — colors, fills, strokes, opacity, modifiers.
Open
Concepts
RTC + DSFUN precision
Why X-GIS keeps f32 vertices accurate at every camera zoom — split-precision math in WGSL.
Open
Concepts
Projection switching
Seven projections, one source. How the runtime switches via uniform without re-tessellation.
Open
Concepts
Compile pipeline
Lexer → AST → IR → optimizer → WGSL codegen. The path from .xgis source to a frame.
Open
API
JavaScript API
XGISMap, Camera, projections, loaders — every public symbol from @xgis/runtime.
Open
Beyond the site
- Roadmap — what's planned and what's shipped
- GitHub repository — source code and issues