test: 💍 local visual regressions testing support

[punkbit]

Why?

The team provides Chromatic as a cloud-native visual regression and UI testing solution. Unfortunately, there aren't any instructions about it.

As a cloud service, it requires a setup which includes a strict access token, etc. It doesn't report in the context of the terminal, as it requires the person who's contributing to open an external link to assess visual regressions, etc.

It runs in the cloud, which may make it too slow for quick iteration work. Although, perfectly suitable for cross-team and CI/CD environments.

This PR provides an initial introduction to the subject, including documented instructions and a local visual regression testing solution which is compatible/supported by Chromatic (if required), for a rapid feedback loop; including documentation and an example test suite, e.g. Buttons.

How?

• Document Chromatic
• Document Local visual regression testing via playwright
• Setup playwright
• Document and provide instructions to run local visual regression tests
• Provides commands to run visual tests locally

Preview?

[changeset-bot]

⚠️ No Changeset found

Latest commit: 0b9970d

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 22, 2026 3:05pm