Get Started


Using react-map-gl requires node >= v4 and react >= 16.3.

npm install --save react-map-gl


import * as React from 'react';
import { useState } from 'react';
import ReactMapGL from 'react-map-gl';

function Map() {
  const [viewport, setViewport] = useState({
    width: 400,
    height: 400,
    latitude: 37.7577,
    longitude: -122.4376,
    zoom: 8

  return (
      onViewportChange={nextViewport => setViewport(nextViewport)}

See full project setup in get-started examples


The current mapbox-gl release requires its stylesheet be included at all times. The marker, popup and navigation components in react-map-gl also need the stylesheet to work properly.

You may add the stylesheet to the head of your page:

<!-- index.html -->
<link href='<YOUR_MAPBOX_VERSION>/mapbox-gl.css' rel='stylesheet' />

Find out your mapbox version by running yarn list mapbox-gl or npm ls mapbox-gl.

Or embed it in your app by using - browserify-css with Browserify or - css-loader with Webpack:

// app.js
import 'mapbox-gl/dist/mapbox-gl.css';

Enable Right-to-Left Language Support

Since v5.2.2

import {setRTLTextPlugin} from 'react-map-gl';

  // find out the latest version at
  // lazy: only load when the map first encounters Hebrew or Arabic text

This is the same as import {setRTLTextPlugin} from 'mapbox-gl' in the browser, but will not crash in node. The export mainly offers a convenience when using server-side rendering.

To use this API, consult Mapbox's setRTLTextPlugin documentation.

Using with Browserify, Webpack, and other JavaScript Bundlers

  • browserify - react-map-gl is extensively tested with browserify and works without configuration.

  • webpack 2 - Most of the provided react-map-gl examples use webpack 2. Look at the get started examples folder for minimalist templates.

  • create-react-app - react-map-gl is compatible with create-react-app.

  • create-react-app-typescript - react-map-gl is compatible with create-react-app-typescript. You can see an example here.

There's many other ready-to-run examples you can take a look at if you need more inspiration.