mirror of https://github.com/rancher/dashboard.git
|
|
||
|---|---|---|
| .. | ||
| components | ||
| BadgeState.stories.js | ||
| Banner.stories.js | ||
| Buttons.stories.mdx | ||
| FormExample.stories.mdx | ||
| Icons.stories.mdx | ||
| ProviderImages.stories.mdx | ||
| README.md | ||
| Welcome.stories.mdx | ||
| global.scss | ||
| provider-icons.json | ||
README.md
Storybook
By default the Storybook dependencies are not included in the main package file (it adds a lot of weight to the install process).
If you run any of the targets:
- yarn storybook
- yarn build-storybook
the dependencies will be added to the package.json file and updated automactically.
You can manually install them with the target:
- yarn install-storybook
Important: Do not commit an updated
package.jsonfile withe the Storybook dependencies
You can remove the Storybook dependencies with:
- yarn remove-storybook
Running Storybook
Just run the command:
yarn storybook
You can access Storybook at the URL: http://127.0.0.1:6006
Next Steps
- Port design-system pages to Storybook
- Add Typography page (for headers etc and padding and margin classes)
- Write short developer reference for how to document components and write stories
- Build out stories for components
- Auto-build via CI and publish to Github pages ?
- Add some content to the Welcome page
- Get i18n working
- Get store working (where required by a component)
Useful links
Useful documentation links:
- https://vue-styleguidist.github.io/docs/Documenting.html#code-comments
- https://storybook.js.org/docs/react/writing-docs/doc-blocks#description
- https://github.com/storybookjs/storybook/blob/next/addons/docs/docs/docspage.md
- https://github.com/storybookjs/storybook/tree/master/addons/docs
- https://storybook.js.org/docs/react/essentials/controls
- https://storybook.js.org/docs/react/writing-docs/build-documentation
- https://storybook.js.org/docs/react/writing-docs/doc-blocks
- https://storybook.js.org/docs/react/addons/addons-api