This is the
master branch, which contains the Polymaps source code. If you're looking for the Polymaps website, you should checkout the
gh-pages branch instead.
You'll find lots of Polymaps examples in the suitably-named
examples directory. Open any of the HTML files there in your browser to view the examples, or open them in your text editor of choice to view the source. Most of the examples are replicated on the Polymaps website, though a few of them are only visible locally.
Some of the examples depend on third-party libraries, such as jQuery. These third-party libraries are not required to use Polymaps but can certainly make it easier! All third-party libraries should be stored in the
lib directory, with an associated
LICENSE file and optional
We use GitHub to track issues with Polymaps. You can search for existing issues, and file new issues, here:
You are welcome to file issues either for bugs in the source code, feature requests, or issues with the Polymaps website.
If you have questions or problems regarding Polymaps, you can get help by joining the
#polymaps IRC channel on irc.freenode.net. You are also welcome to send GitHub messages or tweets to
You do not need to build Polymaps in order to view the examples; a compiled copy of Polymaps (
polymaps.min.js) is included in the repository.
To edit and build a new version of Polymaps, you must first install Java and GNU Make. If you are on Mac OS X, you can install Make as part of the UNIX tools included with XCode. Once you've setup your development environment, you can rebuild Polymaps by running the following command from the repo's root directory:
cat); the order of files is important to preserve dependencies. This produces the file