@pietrop/digital-paper-edit-storybook v1.3.3
Digital Paper Edit - React Components Catalogue
---> Work in progress <--
! What is published in the Storybook may be different to what is being actively used in Digital-Paper-Edit-Client, as the components are currently being migrated. !
This repository uses storybook to gather the components of the React front end. You can read about the "why" in this ADR.
See here for the overall project architecture.
Setup
git clone git@github.com:pietrop/digital-paper-edit-storybook.gitcd digital-paper-edit-storybookOptional step to setup nvm to use node version 10, otherwise just use node version 10
nvm use || nvm installin root of project
npm installUsage - development
Start the storybook
npm startStorybook is at http://localhost:6006/
Usage - production
npm install @pietrop/digital-paper-edit-storybookSystem Architecture
- uses
storybookwith the setup as explained in their docs to develop this React. - .storybook/webpack.config.js changes the storybook webpack config to add support for css modules.
Development env
- npm >
6.1.0 - Node 10 - dubnium
Node version is set in node version manager .nvmrc
Build
To transpile ./src and create a build in the ./dist folder, run:
npm run buildDemo & storybook
- Storybook can bew viewed at https://bbc.github.io/digital-paper-edit-storybook/
- Demo can be viewed at https://bbc.github.io/digital-paper-edit-client
Build - storybook
To build the storybook as a static site
npm run build-storybookPublish storybook & demo to github pages
This github repository uses github pages to host the storybook and the demo of the component. Make sure to commit and push any changes to MASTER before deploying to github pages.
npm run publish-ghpagesAlternatively, if you simply want to build the demo locally in the build folder then just
npm run build-storybookTests
Test coverage using jest, to run tests
npm run testTravis CI
On commit this repo uses the .travis.yml config tu run the automated test on travis CI.
Deployment
To push to npm - @bbc/digital-paper-edit-storybook
login into npm
npm run publish-publicThis runs npm run build and npm publish --access public under the hood
Note that only
README.mdand thedistfolders are published to npm.
Contributing
See CONTRIBUTING.md guidelines and CODE_OF_CONDUCT.md guidelines.
Licence
See LICENCE
Legal Disclaimer
Despite using React, the BBC is not promoting any Facebook products or other commercial interest.