enBloc-org / kindly

Open source repository for the development of Kindly
GNU General Public License v3.0
18 stars 21 forks source link

Publish Storybook 📖 #351

Closed camelPhonso closed 1 month ago

camelPhonso commented 1 month ago

Expected Behavior

Contributors, including non-coding contributors, should be able to easily see the most up-to-date version of our component library.

By publishing storybook to github pages with Continuous Deployment via github actions we can give everyone 'one-click' access to the library for the dev branch

Current Behavior

Contributing to and updating the component library is already a part of the expectations for PR's but we are not using this to communicate with non-coding contributors in the community.

Any other notes

This Issue will help us streamline a lot of the work planned for 'v2'

Assignment

This issue is free for anyone to take

mnixo commented 1 month ago

!request

github-actions[bot] commented 1 month ago

🤖 meep morp!

Thank you for your contribution @mnixo - this Issue is assigned to you as requested ✨

🔎 Please keep in mind that in order to give everyone a chance to contribute Issues may be unassigned if they go stale. You will be warned if the Issue is marked as stale at any point.

🔎 Please review our documentation for guidance on:

💡 The core team is available for any help and will try to respond to any comments in this Issue or questions on discord as quickly as possible.

Happy coding ! 🦆

RGHANILOO commented 1 month ago

I agree that contributors need easy access to the latest version of the component library. Publishing Storybook to GHP would be a great first step for the dev branch.

To further enhance component management and documentation, consider building a lightweight component library. This library could use:

Storybook: Isolate and visually document each component. Tailwind CSS: Style components efficiently with utility classes. Importantly, ensure the library complies with web accessibility requirements WCAG for inclusive design .

This approach offers a handful of benefits:

We could publish the library as @kyndly/ui on npm, allowing for easy integration into the main project using imports like import { nav } from @kyndly/ui.

mnixo commented 1 month ago

I just opened a PR for this one.

@RGHANILOO, I'm going to stick with the original scope of the issue on this one. There are definitely several improvements we could work on in this context, but I think each of them would deserve its own issue and they should be reviewed by the team. Plus, with the creation and publishing a component library comes the responsibility of maintaining it. This is a pretty serious responsibility and given the current use case for these components I don't really think it's necessary.