The homepage and documentation for ProvenanceWidgets. Version 2.x integrates SuperProvenanceWidgets, an extension that introduces a SuperWidget for tracking and visualizing analytic provenance across multiple UI controls. This repository also contains the live ProvenanceWidgets playground.
Operating Systems: Windows 10 or newer, MacOSX 11 or newer, Ubuntu 20.04.1 LTS or newer
- Open the command line/terminal on your machine and navigate to this project's top-level directory (i.e. where this file is).
- Download and install node, npm from https://nodejs.org/en/download/. Optionally, use the nvm (Node Version Manager) to quickly install and use different versions of node via the command line. Note the compatible node/npm version in package.json > "engines" (Node 18+; the docs recommend Node 20.19+ / 22.12+ and npm 10.0+).
npm install- installs required libraries from package.json.npm install --prefix playgrounds/sw-live- installs the dependencies of the live ProvenanceWidgets playground (the site'sstart/buildscripts build it first).
npm run start- Open the browser at http://localhost:3000.
npm run typechecknpm run build
- GitHub Actions is setup via the
.github/workflows/build.yamlfile. On push tomain, the site is built and deployed to GitHub Pages at https://provenancewidgets.github.io.