National Park Service map symbols optimized for the web. Read more about this project on the NPMap website.

Add requests for new symbols as an issue. Newly developed symbols will be bundled into periodic releases.

The Symbol Library uses a semantic versioning scheme:

• 0.0.z: Bugfixes and modifications
• 0.y.0: Icons added
• x.0.0: Icons removed, sprite scheme changed, or major features added

This repository was originally forked from Mapbox's Maki project, so the file structure is similar.

Source SVG files are in the src subdirectory. To create pixel-perfect icons at different sizes, each icon is designed 6 times to support two different use cases:

1. At 12, 18, and 24 pixels wide/tall for use in NPMap Builder
2. At 16, 24, and 32 pixels wide/tall, with a drop shadow, for use in Park Tiles

PNG renders of all of the SVGs are in the renders directory. High-resolution (aka Retina) versions of each icon are present as well, named using the common @2x convention.

You can use the SVGs and PNGs in this repository as they are without building anything, however a render script is included to assist designers/developers who want to modify or create new icons. It will render SVGs to PNGs at 100% and 200% resolution, create sprites used by NPMap.js, NPMap Builder, and the Places Editor, and generate corresponding CSS styles for the sprites.

The script requires Node, Bash, Inkscape, and ImageMagick. In addition, each icon must have an appropriate entry in www/npmaki.json to be rendered correctly.

After installing the required prerequisites, you can run the script like this:

cd npmap-symbol-library
npm install
bash render.sh