# visgl/react-map-gl

React friendly API wrapper around MapboxGL JS

Repository: https://github.com/visgl/react-map-gl
Canonical: https://ross.abutalabs.com/products/react-map-gl
Homepage: http://visgl.github.io/react-map-gl/
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: react, map, mapbox-gl-js, mapbox-gl, webgl, uber, data-visualization
Last push: 2026-08-06T01:25:28+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 83, longevity 100
- inputs: {"age_days": 3982, "days_push": 28, "days_rel": 35, "gap_med": 47.0, "n_releases_24m": 9}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8494, forks 1351 (observed 2026-08-28T04:10:23.120238+00:00)

## What it is
react-map-gl is a suite of React components providing a React-friendly API wrapper around Mapbox GL JS and MapLibre GL JS. It lets developers embed interactive WebGL maps as fully controlled reactive components, with hooks and context for building custom map UIs.

## Use cases
- add an interactive map to a React app
- render Mapbox GL maps as React components
- use MapLibre GL JS in a React project
- build custom map controls with React hooks
- overlay deck.gl WebGL visualizations on a map
- create a controlled reactive map with zoom and center state

## When to choose
- you are building a React application that needs Mapbox or MapLibre maps
- you want maps as declarative, controlled React components
- you plan to combine maps with deck.gl visualizations
- you need hooks and context to build custom map components

## When to avoid
- your project does not use React
- you need maps in a non-web platform like native mobile without a web view
- you want a framework-agnostic vanilla JS map integration
- you need a lightweight static map image rather than an interactive WebGL map

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, data-visualization, geospatial
- domain: web-development, frontend, data-visualization
- platform: cross-platform
- tags: react, mapbox-gl, maplibre-gl, webgl, maps, geospatial-visualization, web-server, nodejs

## Member repositories
- visgl/react-map-gl (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:23.120238+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:26:49.455109+00:00, confidence not recorded.
  - readme: https://github.com/visgl/react-map-gl (fetched 2026-08-28T04:10:23.120238+00:00, sha 5432d75b1624)
  - homepage: http://visgl.github.io/react-map-gl/ (fetched 2026-08-29T08:27:09.850356+00:00, sha 016a6bd7af08)
- Data as of 2026-08-30T08:39:29.467469+00:00.