React Simple Maps

Beautiful React SVG maps with d3-geo and topojson using a declarative api.
Alternatives To React Simple Maps
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
React Simple Maps2,790148606 days ago47July 25, 2022150mitJavaScript
Beautiful React SVG maps with d3-geo and topojson using a declarative api.
D3 Geomap117312 years ago12December 11, 20196mitJavaScript
A library for creating geographical maps based on D3.js
Topojson Maps11
8 years ago1
A library of TopoJSON maps for Geo-Mapping (Data Visualization)
Raster Playground10
2 years ago28gpl-3.0JavaScript
Raster Manipulation - Clip, colorize & overlay!
Workshop D3 Maps5
8 years agomitCSS
Workshop Creating Interactive Maps with D3.js — The Graphical Web 2015
Congressional District Interactive1
2 years ago7JavaScript
Interactive map showing Congressional district level average tax cuts for the TCJA.
7 years agomitJupyter Notebook
Looking at data from DNAInfo Chicago's neighborhood mapping survey
10 years ago
This is just a simple test on the 'new' mapping functionality of GitHub
Alternatives To React Simple Maps
Select To Compare

Alternative Project Comparisons


Create beautiful SVG maps in react with d3-geo and topojson using a declarative api.

Read the docs, or check out the examples.


React-simple-maps aims to make working with svg maps in react easier. It handles tasks such as panning, zooming and simple rendering optimization, and takes advantage of parts of d3-geo and topojson-client instead of relying on the entire d3 library.

Since react-simple-maps leaves DOM work to react, it can also easily be used with other libraries, such as react-spring and react-annotation.


To install react-simple-maps

$ npm install --save react-simple-maps

...or if you use yarn:

$ yarn add react-simple-maps


React-simple-maps exposes a set of components that can be combined to create svg maps with markers and annotations. In order to render a map you have to provide a reference to a valid topojson file. You can find example topojson files on here or here. To learn how to make your own topojson maps from shapefiles, please read "How to convert and prepare TopoJSON files for interactive mapping with d3" on medium.

import React from "react";
import ReactDOM from "react-dom";
import { ComposableMap, Geographies, Geography } from "react-simple-maps";

// url to a valid topojson file
const geoUrl =

const App = () => {
  return (
        <Geographies geography={geoUrl}>
          {({ geographies }) =>
   => (
              <Geography key={geo.rsmKey} geography={geo} />

document.addEventListener("DOMContentLoaded", () => {
  ReactDOM.render(<App />, document.getElementById("app"));

Check out the live example

The above will render a world map using the equal earth projection. You can read more about this projection on Shaded Relief and on Wikipedia.

For other examples and components, check out the documentation.

Map files

React-simple-maps does not restrict you to one specific map and relies on custom map files that you can modify in any way necessary for the project. This means that you can visualise countries, regions, and continents in various resolutions, as long as they can be represented using geojson/topojson.

In order for this to work properly, you will however need to provide these valid map files to react-simple-maps yourself. Luckily, there are decent sources for map files on github and elsewhere. Here are some you can check out:


MIT licensed. Copyright (c) Richard Zimerman 2017. See for more details.

Popular Topojson Projects
Popular Mapping Projects
Popular Mapping Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.