This is a repo for Archive.org components.
This repo is installed into the archive.org codebase, and components are selectively used (not all are inculded).
Using StorybookJS
We use Storybook to show usage examples of our components.
To run storybook, do the following inside of this directory:
-
install dependencies using one of the following:
yarn install
ORlerna bootstrap
(if you are devving on monorepo) -
yarn storybook
Testing with JestJS
JestJS gives us flexibility to test not only our React components, but our JavaScript & Typescript as well. In this repo, it will be mainly for unit testing our UI components.
To run tests in the terminal:
yarn run test
To run tests in the Storybook UI:
yarn run storybook
Debugging
We are using the common debug module.
To add to a module, add a line like
const debug = require('debug')('ia-components:COMPONENTNAME')
To enable, for example, debugging in all ia-components, and debugging in the dweb-archive:Nav module.
In Node add a line to your top level application BEFORE requiring or importing the other modules.
process.env.DEBUG="ia-components:* dweb-archive:Nav"
In Browser, add a line to your index.html or equivalent BEFORE including the bundle.
<script type="text/javascript">localStorage.debug = "dweb-archive dweb-archive:* dweb-transports dweb-transports:* dweb-objects dweb-objects:*";</script>