chore: 🤖 consolidate development environment (technical debt)

[punkbit]

Why?

The following PR consolidates the development workflow by removing the legacy index.html dev vite/server in favour of Storybook stories. It also cleans up redundant documentation and unused assets to reduce technical debt.

Originally, the project had two development environments that were concurrent: a static index.html page that loads a component that attempts to load all components, versus Storybook stories.

We get rid of the static index.html, controlled by the command dev, in favour of Storybook stories as the source-of-truth. It's easier to maintain the docs and tool that provides most value. Also, the original dev is not documented and it's a soup of components. It's much easier to communicate via a story, e.g. you want to showcase use-cases of any kind effectively.

Included improvements in the documentation, e.g. remove concurrent/conflicting instructions found in separate markdown documentation to favour README.md, reducing maintenance, or conflicting instructions. Other changes include the removal of unused or legacy files!?, e.g. Icons.mdx, stylesheets.

How?

• Removes serving the static and manual component dev environment
• Deleted index.html related files, e.g. stylesheets, etc
• Improved the documentation to use the README.md for the latest instructions, instead of providing concurrent instructions
• Reduced Storybook imported stories to be typescript only, e.g. do not incentivise js

Preview?

Before

After

[changeset-bot]

⚠️ No Changeset found

Latest commit: 7409d21

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

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

Project	Deployment	Review	Updated (UTC)
click-ui	Ready	Preview, Comment	Jan 28, 2026 1:33pm

[DreaminDani]

Looks good. Thanks for adding the bit about Figma too! Gonna miss that component soup in index.html 🥲