Experiences & Guidance Using Web Awesome in Storybook

[RichLewis007]

Hi team,

I’ve been exploring how to integrate Web Awesome components with Storybook. Here’s what I’ve found so far:

Since Web Awesome is built on web components, in theory it should work fine with Storybook’s Web Components framework support.

I’ve seen users experiment with this, but some mention hitting issues with Storybook’s docs mode and controls not wiring up cleanly.

I also found at least one public repo (HOTOSM’s ui) that installs @awesome.me/webawesome and runs Storybook successfully.

There are also many Shoelace+Storybook examples floating around, which should be relevant since Web Awesome is the continuation of Shoelace.

Questions for the maintainers/community:

1. Is there an “official” or recommended setup guide for running Web Awesome with Storybook today?

2. Are there known limitations (e.g. controls/args not binding, docs rendering, theming integration) we should be aware of?

3. Would you consider publishing an example Storybook repo or template in this org to help others get started?

Thanks in advance—any guidance or shared experiences would be hugely helpful!

• Rich

[claviska]

We don't use Storybook here on the team, but I know external teams who have had success with it using web component libraries. Maybe one of them can chime in to talk about their experience. 😄

[RichLewis007]

Sounds good, thanks for the reply.