What problem does it solve? Rendering roughly 1,000 live moving shipments on a shared operational map breaks naive approaches: DOM markers become unresponsive at scale, default basemap styles look generic, and ad-hoc colors fragment the UI across Command, Driver PWA, and Client Portal surfaces. ## Core Features & Use Cases - GL-layer architecture at scale: Renders every entity as GeoJSON features in combined circle/symbol layers with setFeatureState, clustering, and a throttled setData animation loop to hold 60fps desktop / 30fps mid-phone. - Three-tier state grammar: Encodes healthy, at-risk, and exception states through geometry, opacity, motion, and mono chips rather than new colors, including the exception world-dim that drops everything else to 35% opacity. - Custom greige basemap and design law: Ships a ready greige-style.json plus the five-token color, typography, and motion rules enforced by a squint-test CI audit. - Use Case: Build the Command surface map that shows the whole fleet as clustered red density, pulses an OS&D exception while dimming the rest of the world, and reuses the same entity contract scoped per lens for the Driver PWA and Client Portal. ## Quick Start Use the terminal-gallery-map-ui skill to build the operational fleet map rendering all live shipments with the greige basemap and the healthy, at-risk, and exception state grammar.
