diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 17:32:43 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 17:32:43 +0000 |
commit | 6bf0a5cb5034a7e684dcc3500e841785237ce2dd (patch) | |
tree | a68f146d7fa01f0134297619fbe7e33db084e0aa /comm/mail/components/storybook/README.md | |
parent | Initial commit. (diff) | |
download | thunderbird-upstream.tar.xz thunderbird-upstream.zip |
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'comm/mail/components/storybook/README.md')
-rw-r--r-- | comm/mail/components/storybook/README.md | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/comm/mail/components/storybook/README.md b/comm/mail/components/storybook/README.md new file mode 100644 index 0000000000..4fe739c07a --- /dev/null +++ b/comm/mail/components/storybook/README.md @@ -0,0 +1,39 @@ += Storybook for Thunderbird + +Storybook is a component library to document our design system, reusable +components and any specific components you might want to test with dummy data. + +== Background + +The storybook will list components that can be reused, and will help document +what common elements we have. It can also list implementation specific +components, but they should not be added to the "Design System" section. + +Changes to files directly referenced from the storybook (so basically +non-chrome:// paths) should automatically reflect changes in the opened tab. +If you make a change to a chrome:// referenced file then you'll need to do a +hard refresh (Cmd+Shift+R/Ctrl+Shift+R) to notice the changes. + +=== Running storybook + +First time around, you will have to install the npm dependencies for storybook. +There is a mach command to do so using the mach-provided `npm`: + +``` +# Working directory is your comm-central checkout root directory. +../mach tb-storybook install +``` + +Once the npm dependencies are installed, you can run storybook by executing + +``` +# Working directory is your comm-central checkout root directory. +../mach tb-storybook +``` + +Now storybook should be running at `http://localhost:5703`. To use storybook, run +the following command in your Thunderbird developer console: + +```js +tabmail.openTab("contentTab", { url: "http://localhost:5703" }) +``` |