This README is for developers and people interested in learning more about q2view. If you just need the functionality, q2view is already compiled and hosted at https://view.qiime2.org. The live version of the app officially supports the latest versions of Google Chrome and Firefox.
This HTML 5 interface provides a way to view .qza
/.qzv
files produced by
QIIME 2. It provides:
- Inspection of basic metadata
- Viewing of complex web-based visualizations
- Inspection of provenance
This interface uses the Service Worker API
to "hoist" the contents of a .qzv
's /data
directory into the interface
allowing relative links within a visualization to work via standard HTTP
requests.
To host the app locally, first install the dependencies (while in root of the repo):
npm install
Then run:
npm run dev
This will host the app on localhost:5173 by default
Important: HTTPS is required (by service worker API) when not hosting
from localhost
.
NOTE: The locally hosted version of the app will most likely not work on Firefox due to the way Firefox interacts with the afformentioned Service Worker API.