feat: add storybook

[sacrosanctic]

In this PR

• setup storybook
• outline how storybook will integrate with the project

todo

• setup chromatic @JReinhold
• mocks for nuxt modules

considerations

• story scope and converage
• storybook and vitest has redundant tests
• define component boundaries

notes

• features added by @yannbf

notes to self

• LicenseDisplay - should handle the nullish case internally
• DownloadAnalytics - should be multiple components
• Button - full width block is not full width
• Button - ariakeyshortcut is unused

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ready	Preview, Comment	Feb 26, 2026 5:46pm
npmx.dev	Ready	Preview, Comment	Feb 26, 2026 5:46pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
npmx-lunaria	Ignored		Feb 26, 2026 5:46pm

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[JReinhold]

my suggestions here could potentially be a longer-term solution to the unsupported parts of nuxt.

[JReinhold]

great job! I didn't look too much into the stories themselves, but it looked good.

[sacrosanctic]

great job! I didn't look too much into the stories themselves, but it looked good.

No worries, the stories will be iterative. I will be removing them so they can be discussed in their own PR.

[cylewaitforit]

Looks like the provenance check doesn't like introducing these lower version @vitest/ dependencies. Do these need an override to a higher version that's already in the repo or is there some other way to better satisfy the check?

[cylewaitforit]

suggestion:

This looks like it would solve the provenance issue.

Suggested change

	storybook: ^10.2.7
	storybook: ^10.2.7
	'@storybook/csf-plugin': ^10.2.7
	storybook@^10.2.7>@vitest/expect: ^4.0.18
	storybook@^10.2.7>@vitest/spy: ^4.0.18
	'@storybook/vue3-vite@9.1.2>vue-component-meta': ^3.2.4

I tested it in #1651

The storybook dev server still seems to start up and render the stories just fine.

[danielroe]

📚 ❤️

[tobiasdiez]

I’m one of the maintainers of the Nuxt/Storybook module and addon. I’ve been looking through the setup and noticed a few hacks and workarounds that seem to be covering some of the rough edges between Storybook and Nuxt.
I was curious whether those issues have already been reported over at https://github.com/nuxt-modules/storybook, and if not, whether there’s anything we could do together to make the integration a bit smoother.

Also wanted to ask if you’d be open to adding stories in the Vue format using https://github.com/tobiasdiez/storybook-vue-addon. It still has a few known issues, but seeing an open and active project like npmx use it would be a big motivation for me to spend time fixing those and would provide real-world uses cases to guide some of the design decisions.

[yannbf]

I’m one of the maintainers of the Nuxt/Storybook module and addon. I’ve been looking through the setup and noticed a few hacks and workarounds that seem to be covering some of the rough edges between Storybook and Nuxt. I was curious whether those issues have already been reported over at nuxt-modules/storybook, and if not, whether there’s anything we could do together to make the integration a bit smoother.

Also wanted to ask if you’d be open to adding stories in the Vue format using tobiasdiez/storybook-vue-addon. It still has a few known issues, but seeing an open and active project like npmx use it would be a big motivation for me to spend time fixing those and would provide real-world uses cases to guide some of the design decisions.

Hey Tobias! I noticed a few rough edges and was planning on reaching out. Let's chat on discord, I think there's a great opportunity here to make the nuxt integration as amazing as it can be!