Here lies a few packages for UI components used on Archive.org.
This repo is no longer open to receive new packages. Please refer to https://github.com/internetarchive/iaux-typescript-wc-template when creating new components.
EACH PACKAGE in /packages MUST INSTALL ITS OWN DEPS.
Note: we no longer use lerna to manage dependencies nor releases
Run our local UI component development environment.
cd packages/ia-components && yarn run storybook
There are several node packages in this one repo. They are located under the packages directory.
EACH PACKAGE in /packages directory manages its own release.
To clarify in the commit/merge, please note package & its new version. ex. ia-components@1.2.3
This is structured so that there is compatibility with the upstream Archive.org codebase.
Currently, we are using Airbnb's styleguide and will extend accordingly. We have added ESLint to help with staying in convention.
Some packages use StorybookJS to show usage examples of our components. For details on how to run StorybookJS, visit the ia-components readme: IA Components Readme
Run Storybook in ia-components:
cd packages/ia-components && yarn run storybook
JestJS is pliable enough for us to test in JavaScript and TypeScript. Try running our tests:
cd packages/ia-components && yarn run test
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>
in v2mocks there is code that is pulled from IA "View Source" and converted to JSX using this tool:
https://magic.reactjs.net/htmltojsx.htm
Archive.org v2 uses Bootstrap 3.0. Docs can be found here: http://bootstrapdocs.com/v3.0.0/docs/css/#overview