design-system-guidelines

This is a living reference for how we build UI at the component, foundation, and pattern level. It documents how things should work, surfaces what needs to change, and will track design debt as we find it.

When making architectural changes, remember that the goal is to keep the general solution and architecture in parity with the wonder-blocks repo Storybook such that they can be unified when it makes sense!

Running locally

After pulling the repo, install dependencies

pnpm install

Then start the Storybook server

pnpm start

It should launch the following URL, locked to port :56789 so that it can coexist nicely with a locally running wonder-blocks Storybook

http://localhost:56789/

MCP endpoint

While the Storybook is running, it serves an MCP endpoint for agents:

http://localhost:56789/mcp

For Claude Code:

claude mcp add --transport http design-guidelines http://localhost:56789/mcp