https://github.com/uber/react-map-gl
React friendly API wrapper around MapboxGL JS
https://github.com/uber/react-map-gl
data-visualization map mapbox-gl mapbox-gl-js react uber webgl
Last synced: 19 days ago
JSON representation
React friendly API wrapper around MapboxGL JS
- Host: GitHub
- URL: https://github.com/uber/react-map-gl
- Owner: visgl
- License: other
- Created: 2015-10-08T16:56:26.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-03-20T16:41:29.000Z (25 days ago)
- Last Synced: 2025-03-25T02:13:07.590Z (21 days ago)
- Topics: data-visualization, map, mapbox-gl, mapbox-gl-js, react, uber, webgl
- Language: TypeScript
- Homepage: http://visgl.github.io/react-map-gl/
- Size: 32 MB
- Stars: 8,033
- Watchers: 1,934
- Forks: 1,359
- Open Issues: 65
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-react-components-all - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (Uncategorized / Uncategorized)
- awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
- awesome-react - react-map-gl - A React wrapper for MapboxGL-js and overlay API.  (UI Components / Data Visualization)
- awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
- awesome-list - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (Demos / Map)
- awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
- awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
- awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
- fucking-awesome-react-components - react-map-gl - A React wrapper for MapboxGL-js and overlay API. (UI Components / Map)
README
react-map-gl | Docs
`react-map-gl` is a suite of [React](https://react.dev/) components designed to provide a React API for [mapbox-gl](https://github.com/mapbox/mapbox-gl-js) or [maplibre-gl](https://maplibre.org/maplibre-gl-js/docs/). More information in the online documentation.
See our [Design Philosophy](docs/README.md#design-philosophy).
### Installation
Using `react-map-gl` requires `react >= 16.3`.
```sh
# Using Maplibre
npm install react-map-gl maplibre-gl
```
_or_
```sh
# Using Mapbox
npm install react-map-gl mapbox-gl
```
### Example
```js
// Using Maplibre
import * as React from 'react';
import Map from 'react-map-gl/maplibre';
import 'maplibre-gl/dist/maplibre-gl.css';
function App() {
return (
);
}
```
_or_
```js
// Using Mapbox
import * as React from 'react';
import Map from 'react-map-gl/mapbox';
import 'mapbox-gl/dist/mapbox-gl.css';
function App() {
return (
);
}
```
Learn more with in our [Getting Started](https://visgl.github.io/react-map-gl/docs/get-started) guide.
### Contribute
See [contribution guide](/CONTRIBUTING.md).
### Attributions
react-map-gl is part of vis.gl, an [OpenJS Foundation](https://openjsf.org) project.
Development is also supported by
