Built in the open, MIT licensed.
Shavin is an open-source design system and AI component engine. Every package, every token, every build script is public. Fork it, audit it, contribute to it, ship it commercially — no strings attached.
Every commit is public, every decision is documented, and every primitive is battle-tested in production.
What open source means to this project.
Not just a license file. Open source is the architectural principle that makes AI-assisted UI development trustworthy.
Radical transparency
Every token, every primitive, every build script is public. You can audit the exact CSS variables that drive your components, trace the CVA variant logic, and verify the WCAG compliance claims yourself.
No proprietary lock-in
MIT licensed. Fork it, modify it, ship it commercially. The design system is yours. The MCP server is yours. The block registry is yours. No paid tiers gating core functionality.
Community-driven evolution
Feature requests, bug reports, and pull requests shape the roadmap. Every contribution goes through the same token purity gate as the core library — community blocks meet the same standard as official ones.
Same license, everywhere
One license covers all six packages: @shavin/ui, @shavin/mcp, @shavin/cli, @shavin/block-schema, @shavin/builder-engine, and @shavin/skills. No per-package licensing, no commercial vs. community tiers.
Six packages. One design contract.
Each package solves a specific layer of the design-to-AI pipeline. Use them together or adopt the pieces you need.
From fork to merged pull request.
The contribution workflow mirrors the 5-layer component pipeline. Every change lands in all layers or it doesn't land at all.
Fork & clone
Fork the repository, clone locally, run npm install at the root. The workspace setup handles all inter-package linking automatically.
Build & verify
Run npm run verify to confirm the full quality gate passes — token check, TypeScript compilation, manifest generation, and build integrity.
Make your change
Follow the 5-layer component pipeline: primitive, docs, studio parser, registry, verification. Every layer is documented in AGENTS.md.
Submit a PR
Open a pull request. The CI pipeline runs the same verify gate locally. Token purity violations block merge automatically.
MIT License — do anything you want
Commercial use, modification, distribution, private use — all permitted. The only requirement is preserving the copyright notice. No warranties. No liability. Standard MIT terms.
Read the full licenseStar the repo, file an issue, send a PR.
Every contribution makes the design system better for humans and machines alike.