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.