# topo-regions

[![NPM](https://badge.fury.io/js/topo-regions.svg)](https://www.npmjs.com/package/topo-regions)

This repository provides a convenient mechanism for generating [TopoJSON][] files from [GADM][] database of Global Administrative Areas.

## Installing

To create the maps:
```bash
yarn install
```

## Maps

Maps are available at the ``world`` directory of the installed package or directly from [unpkg](https://unpkg.com/topo-regions/).

## Useful Resources

* [GADM][] database of Global Administrative Areas
* [Natural Earth](http://www.naturalearthdata.com/downloads)’s vector data
* Use [mapshaper.org](http://mapshaper.org/) to explore shape/geojson/topojson files
* For additional maps check the [world-atlas][] project
* [Let’s Make a Map](http://bost.ocks.org/mike/map/)
* [command-line cartography](https://medium.com/@mbostock/command-line-cartography-part-1-897aa8f8ca2c) guides


[TopoJSON]: https://github.com/topojson/topojson
[GADM]: http://www.gadm.org
[world-atlas]: https://github.com/topojson/world-atlas