OpenUI MCP Studio README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the OpenUI MCP Studio listing page.
ShadcnBrief
brief in, React + shadcn out, proof attached
What You Get • Install • How It Work • Ecosystem
ShadcnBrief takes a one-paragraph brief and produces a styled React + shadcn surface — with screenshots, accessibility checks, and proof attached. Open-source MCP studio, batteries included.
MCP-driven UI generator. Brief, render, diff, ship.
What You Get
| Surface | What |
|---|---|
studio apps | Brief → preview → diff → export. All local. |
packages | Reusable shadcn-aligned components, themed for proof workflows. |
mcp services | Hand a brief to any agent through an MCP server. |
contracts | Schemas for brief, render, and proof — versioned, diffable. |
tooling | Snapshot tests, a11y checks, design-token guardrails. |
[!IMPORTANT] Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.
Install
Three commands. No curl | sh. No login. Read what you run.
Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap ShadcnBrief for me." Agent fix own brain. Long version: docs/.
How It Work
The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.
| Layer | What |
|---|---|
chore: scaffold | License, governance, hygiene gates, CI scaffolding. |
feat(core) | The primary engine. The reason ShadcnBrief exists. |
feat(modules) | Packages, adapters, services, plugins. The second floor. |
feat(contracts) | Schemas, configs, public boundaries. Other code talks here. |
test: | Receipts. Everything in this layer must run. |
feat(ops) | Scripts, infra, CI helpers, build glue. |
docs: | Public docs surface. The pretty face. |
git log reads like a building floor plan. Look once, know the whole shape.
Ecosystem
ShadcnBrief lives in the open family: three open platforms. local-first, source-first, builder-first.
| Repo | What |
|---|---|
| OpenCampus | Canvas + Gradescope + EdStem on one calm desk |
| OpenVibeCoding | AI codes overnight, you ship in the morning |
| ShadcnBrief (you here) | brief in, React + shadcn out, proof attached |
Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.
Star This Repo
If ShadcnBrief saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
Also by Yifeng[Terry] Yu
- OpenCampus — Canvas + Gradescope + EdStem on one calm desk
- OpenVibeCoding — AI codes overnight, you ship in the morning
- BeamMe — beam your agent config to any planet
- BrewMe — wake up, news already brewed
- proofyard — every claim ships with its receipt
License
MIT — small print, big freedom.