2026-09-02 –, Phoenix Hall
Every serious MapLibre project hits this wall: a monolithic style.json nobody fully owns. Designers want a GUI, developers edit JSON by hand, version history is one huge diff. Mapstrata is a visual editor that makes collaboration possible: spec validation, support for related stylesheets with different themes, and a project format built for git.
If you maintain a MapLibre stylesheet with more than a few dozen layers, you already know the problem. A color change that should take five minutes takes fifty because you need to search and replace, plus visually review, across dozens of layers. Designers iterate in Maputnik, but complain about it, meanwhile developers find limits to its utility—it applies edits in ways that make source control of the style JSON impossible. So instead we edit JSON by hand with a live reload and consider iterative visual design and management impossible. Nobody has a full picture of the style, version history is indecipherable.
Right now this workflow gap influences how the MapLibre ecosystem can develop. Writing layers requires an encyclopedic and up-to-date knowledge of the style spec, superhuman grasp of how expressions work, and instantaneous visual feedback on what incremental changes produce. The WYSIWYG approach has real limits of its own: it typically generates verbose JSON, obscures optimization opportunities, and doesn't integrate with the code, reload, commit workflow that experienced style authors actually prefer. It also prevents designers from truly understanding the renderer and what it is really good at; instead they advocate for features that would make it more similar to familiar experiences in print map rendering.
Mapstrata takes a different approach. Instead of replacing the JSON workflow with a visual one, it makes the JSON workflow maintainable. Import a stylesheet and Mapstrata decomposes it: layers become reviewable, diffable, attributable in git. Build different themes and maintain them. Iterate on changes live with a MapLibre preview pane. Export, commit, and collaborate on the Mapstrata files or the composed style JSON. No cloud dependency, no lock-in, no proprietary format.
The design philosophy is that the editor should make the underlying structure legible, not hide it. Variables use embedded references directly in layer JSON, so you can read any layer file and immediately see which properties are variable-driven versus hardcoded. The build engine validates against the MapLibre style spec on every edit, catching errors before they produce a blank map.
This talk will demo the editor, share what I learned about building—and then cutting—an AI-assisted version, and outline where the project is headed (GitHub-backed persistence, Figma integration). Come to the talk and reach out if you want to know more: I'm looking for projects that will put Mapstrata through its paces on real stylesheets.
MapLibre