Customising the Auspice Client

Auspice allows you to customise the appearance and functionality of Auspice when the client is built. This is how Auspice running locally and look different, despite both using “Auspice”.


Notice the difference? Default Auspice (left) and’s customised version (right)

This is achieved by providing a JSON at build time to Auspice which defines the desired customisations via:

auspice build --extend <JSON>

Here’s the file used by to change the appearance of Auspice in the above image.

See the client customisation API for the available options.

AGPL Source Code Requirement

Auspice is distributed under AGPL 3.0. Any modifications made to the auspice source code, including build-time customisations as described here, must be made publicly available. We ask that the “Powered by Nextstrain” text and link, rendered below the data visualisations, be maintained in all customised versions of auspice, in keeping with the spirit of scientific citations.