Skip to content

🗺 A React component for interactive vector maps of the world and 100+ countries

License

Notifications You must be signed in to change notification settings

South-Paw/react-vector-maps

Repository files navigation

react-vector-maps

🗺️ A React component for interactive vector maps of the world and 100+ countries

npm

Features

  • Simple and easy to implement React component for rendering interactive vector maps
  • 100+ vector maps included out of the box, free from MapSVG
  • Convert your own vector map for the component to use with the online converter
  • Quick and straight forward to style your map however you want to

Basic Usage

import React from 'react';
import { VectorMap } from '@south-paw/react-vector-maps';

// You'll need to download the json file from the docs site or you can create your own.
import world from './world.json';

export const Map = () => <VectorMap {...world} />;

See the documentation for more examples and advanced usage of the component.

Issues and Bugs

If you manage to find any, please report them here so they can be squashed.

Development and Contributing

Grab the repo and then install dependencies with npm i.

# Run TypeScript check and ESLint
npm run lint

# Run unit tests
npm run test

# Build package for publishing (/dist)
npm run build

# Remove build artifacts (/dist and /coverage)
npm run clean

# npm install for the docs
npm run docs:install

# Start docs for development
npm run docs:start

# Build docs for deployment
npm run docs:build

# Serve docs from /public after build
npm run docs:serve

# Clean up docs folders
npm run docs:clean

License

MIT, see the LICENSE file.