Web app for visualizing pathogen evolution
JavaScript CSS HTML Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
build try a simpler process Jul 18, 2017
scripts Add shebang line to scripts/get-data.sh Jul 26, 2018
src Merge pull request #629 from nextstrain/grid-layer-order Aug 17, 2018
test remove manifest, s3bucket etc from client Jul 24, 2018
.babelrc server.js no longer needs to be transpiled Jul 20, 2018
.editorconfig lint & editor config May 18, 2016
.eslintignore proxy requests through dev server to avoid cors for now May 19, 2016
.eslintrc add path resolution using manifest for staging bucket. Closes #618 Aug 9, 2018
.gitignore server.js no longer needs to be transpiled Jul 20, 2018
.npmignore ignores May 18, 2016
.travis.yml only rebuild docker image for release branch Jul 28, 2018
CHANGELOG.md version bump to 1.25.1 for release Aug 10, 2018
LICENSE.txt Initial commit with license and readme. Apr 22, 2016
Procfile Fix heroku Feb 21, 2017
README.md Update README and tweak npm script names Jul 19, 2018
favicon.png Serve favicon Feb 23, 2017
index.html Adjust styling of branch labels Mar 21, 2018
package-lock.json Upgrade remaining two dependencies that have known security vulnerabi… Aug 6, 2018
package.json version bump to 1.25.1 for release Aug 10, 2018
releaseNewVersion.sh Further cleanup of release script May 15, 2018
server.js server.js: Small wording tweak in startup message to read more naturally Jul 26, 2018
webpack.config.dev.js Merge branch 'tree-too' (bugs exist) Mar 26, 2018
webpack.config.prod.js babel-polyfill Mar 15, 2018


Master: Build Status Release: Build Status


Nextstrain is an open-source project to harness the scientific and public health potential of pathogen genome data. We provide a continually-updated view of publicly available data with powerful analytics and visualizations showing pathogen evolution and epidemic spread. Our goal is to aid epidemiological understanding and improve outbreak response. See nextstrain.org/docs for more details.

Auspice is the code which powers all the nextstrain data viz -- e.g. nextstrain.org/zika. It is a javascript-based web app that gives an interactive visualization of genomic data (which is normally, but not necessarily, produced by augur).

Local Installs

Step 1: clone the git repository

cd nextstrain # or whichever folder you'd like to contain nextstrain repos in
git clone https://github.com/nextstrain/auspice.git
cd auspice

Step 2: Install Node.js

If you are comfortable using conda, installing nodejs is as simple as conda install -c conda-forge nodejs=9.11.1. If you'd prefer not to use conda, I recommend using nvm in order to manage nodejs & npm versions -- here's a great guide to help you do this.

Step 3: Install required dependencies

npm install

Step 4: Create / obtain data files (if you'd like to view local datasets)

Auspice can either source data from your computer or from a server. If you'd like to view data files locally, the JSON(s) need to be present in the data directory (see the docs for the format of these). If you have local data files (e.g. produced via augur) then copy them into this directory. If you'd like to download the latest JSONs which we are using for nextstrain.org then run npm run get-data which will download JSONs into data

Step 5: Build auspice & server the server

  • Simplest: npm run build && npm run server:local. This builds the relevant bundles & starts the server accessing the datasets in ./data.

  • To access datasets online (e.g. to mimic the live nextstrain site), instead run npm run build && npm run server.

  • In order to run the development server, which allows you to edit the source code on-the-fly, run npm run dev or npm run dev:local (the latter sources data from ./data)

Step 6: Open a browser

Auspice can now be used via localhost:4000. If you have JSONS in data named flu_europe_tree.json & flu_europe_meta.json, then these can be viewed at localhost:4000/flu/europe.

License and copyright

Copyright 2014-2018 Trevor Bedford and Richard Neher.

Source code to Nextstrain is made available under the terms of the GNU Affero General Public License (AGPL). Nextstrain is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.