Skip to content

docs(storybook): reorganize story hierarchy by component category#1064

Open
frankieyan wants to merge 1 commit into
mainfrom
frankie/storybook-hierarchy
Open

docs(storybook): reorganize story hierarchy by component category#1064
frankieyan wants to merge 1 commit into
mainfrom
frankie/storybook-hierarchy

Conversation

@frankieyan

@frankieyan frankieyan commented Jun 12, 2026

Copy link
Copy Markdown
Member

Short description

This PR reorganizes Storybook's sidebar groupings by reflecting their component types:

  • 🔘 Buttons & links
  • 📊 Data display
  • 💬 Feedback
  • 📝 Form
  • 📐 Layout
  • 📑 Menus & tabs
  • 🪟 Overlays
  • 🔤 Typography
  • ⚙️ Utility

🪝 Hooks, Design tokens, and Tips and tricks are kept as their own categories as well.

Note

Source files are not moved to avoid introducing a breaking change to their /lib import paths

Additionally, Storybook's CSF indexer doesn't allow computed titles to be used, so we can't store these category names as a centralized constant.

Demo

Before After
image image

PR Checklist

  • Updated docs (storybooks, readme)

Regroup every story title under the nine type-based categories from the
Reactist component inventory, replacing the inconsistent Design system /
Components split so the sidebar matches the inventory we're standardizing on.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@frankieyan frankieyan marked this pull request as ready for review June 12, 2026 20:50
@frankieyan frankieyan requested a review from doistbot June 12, 2026 21:09
@frankieyan

Copy link
Copy Markdown
Member Author

@Doist/frontend-product: any objections to this?

@frankieyan frankieyan requested review from a team and nats12 and removed request for a team June 12, 2026 23:55

@gnapse gnapse left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the man is wearing a suit and tie and clapping his hands .

@henningmu henningmu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lovely 🤩

@engfragui engfragui left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something I didn't realize I needed in my life!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants