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 appsBrief → preview → diff → export. All local. packagesReusable shadcn-aligned components, themed for proof workflows. mcp servicesHand a brief to any agent through an MCP server. contractsSchemas for brief, render, and proof — versioned, diffable. toolingSnapshot 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
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: scaffoldLicense, 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 OpenVibeCoding BeamMe BrewMe proofyard
License
MIT — small print, big freedom.
