The workshop

Every component of @pepperui/css rendered from its specimen — 65 pages, each carrying its contract, its rules and its measured accessibility rows. This is the built Storybook, served by this site.

Open the workshop in its own tab · the component board links straight to a component’s page.

Running it locally

npm run storybook        # the workshop with hot reload, 127.0.0.1:6006
scripts/storybook.sh     # the built workshop, 127.0.0.1:6007
scripts/docs.sh          # this site with the workshop embedded, 127.0.0.1:4321

If the frame above is empty, the workshop has not been built into this site yet: npm run docs:build does both (it copies storybook/storybook-static into the site’s public/storybook), and scripts/docs.sh does it for you.

What the workshop gates

A red visual diff or an axe violation fails the build: a Playwright screenshot per story against a committed golden, axe per story with an allowlist that carries a reason for every entry, and the token count. It is the same discipline as the pixel gates on the consumer pilots — a rule with a test behind it is a rule; a rule in a document is a hope.