finds.dev

mapillary/mapillary-js

Interactive, extendable street imagery map experiences in the browser, powered by WebGL

View on GitHubHomepage ↗

★ 507TypeScriptMITupdated Apr 2026

// the take

MapillaryJS is a WebGL-based street-level imagery viewer built on top of the Mapillary platform. It renders 360° panoramas and perspective images with spatial awareness, supports custom data providers so you can feed it your own imagery instead of Mapillary's, and exposes an extension system for overlaying Three.js or raw WebGL content on top of street-level photos. Primarily useful for geospatial applications, mapping tools, or anyone building Street View-style experiences.

The data provider abstraction is well-designed — you can swap out Mapillary's API for your own imagery pipeline by implementing IDataProvider, which means you're not locked into their platform. The extension system (custom renderers, camera controls, geometry providers) is properly separated rather than bolted on. TypeScript types are thorough and the API surface is typed end-to-end. Documentation includes working theory pages on navigation graphs and polygon triangulation — rare for a project like this.

Hard dependency on Mapillary's graph API for any non-trivial use case means you're doing significant integration work to use your own data; the procedural data provider example helps but the contracts are complex. 507 stars for a Facebook-backed project after years of development suggests niche adoption, and the maintenance pattern (sporadic commits, last real activity in early 2026) raises questions about long-term support. The bundle size will be substantial given Three.js and WebGL shader code — no tree-shaking story is mentioned. If you're not building something geospatially oriented, this is the wrong tool; the component model and coordinate system assumptions are deeply tied to street-level imagery semantics.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
507
Forks
85
Language
TypeScript
License
MIT
Last commit
10 Apr 2026

// nearby

If mapillary-js isn't quite it.

All repos →