DEV Community


Posted on • Updated on

How to: Mapbox with React.js

Getting started

  • Generate a MapBox access token in your account page
  • Download the npm library using yarn add mapbox-gl
  • Include the css in the <head> of your index.html file:
<link href='' rel='stylesheet' />
Enter fullscreen mode Exit fullscreen mode

Creating a map

Create a BaseMap component:

import React, { useEffect } from "react";
import mapboxgl from "mapbox-gl";
import "./BaseMap.scss";

const BaseMap = () => {
  mapboxgl.accessToken = MAPBOX_ACCESS_TOKEN;

  useEffect(() => {
    new mapboxgl.Map({
      container: "mapContainer",
      style: "mapbox://styles/mapbox/streets-v11",
      center: [-74.5, 40],
      zoom: 9,
  }, []);

  return <div id="mapContainer" className="map"></div>;

export default BaseMap;
Enter fullscreen mode Exit fullscreen mode
  • container: The HTML element in which Mapbox GL JS will render the map, or the element's string id. The specified element must have no children.
  • style: choose from a pre-defined Mapbox style or create your own using Mapbox studio
  • center: refers to the starting position in [long,lat]
  • zoom: refers to the initial zoom level

Other option parameters for Map can be found here.

Next, add basic styles in BaseMap.scss:

.map {
  width: 100%;
  height: 100%;
Enter fullscreen mode Exit fullscreen mode

Finally, add BaseMap into your view e.g. HomePage.js

import React from "react";
import BaseMap from "~Components/BaseMap/BaseMap";

const HomePage = () => {
  return (
      <h1>My map</h1>
      <BaseMap />

export default HomePage;
Enter fullscreen mode Exit fullscreen mode

Displaying markers and controls


This adds a zoom buttons and a compass.

const nav = new mapboxgl.NavigationControl();
map.addControl(nav, "top-right");
Enter fullscreen mode Exit fullscreen mode


This adds a marker component.

const marker = new mapboxgl.Marker()
  .setLngLat([103.811279, 1.345399])
Enter fullscreen mode Exit fullscreen mode


This locates the user on the map based on the browser's geolocation API.

const geolocate = new mapboxgl.GeolocateControl({
  positionOptions: {
    enableHighAccuracy: true
  trackUserLocation: true

map.addControl(geolocate, "top-right")
Enter fullscreen mode Exit fullscreen mode

And there you have it! 🎉

screenshot of page

  • If you are interested in using Mapbox with Vue.js, I have written a similar tutorial here
  • Mapbox official documentation here

Top comments (1)

gautham495 profile image
Gautham Vijayan • Edited

Neatly explained! Can I get the source code in GitHub please.