Summary
A local stdio MCP that turns UI briefs into React components styled with shadcn/ui. You describe what you want in a paragraph, and it generates the component, takes screenshots, runs accessibility checks, and hands you diffs before you commit. Built for keeping everything on your machine until you're ready to ship. The tooling includes snapshot tests, a11y validation, and design token guardrails. Useful when you want Claude to scaffold UI without round-tripping to a cloud service or when you need proof artifacts attached to every generated surface. The repo layers core rendering, reusable packages, and MCP adapters as separate commit stacks, so you can trace what changed when.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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.
┌──────────────────────────────────────┐
│ LOCAL-FIRST ████████ 100% │
│ SOURCE-TRACEABLE ████████ 100% │
│ TYPING REQUIRED ░░░░░░░░ 0% │
│ VIBES ████████ ZERO │
│ FILLER│
└──────────────────────────────────────┘
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
git clone https://github.com/xiaojiou176-open/shadcn-brief.git
cd ShadcnBrief
# follow the per-stack quickstart in INSTALL.md or docs/
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.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →