🌟 MastUI — Build Beautiful Interfaces, Effortlessly

A modern, motion-first UI component library built with ShadCN UI, Magic UI (Framer Motion), and Tailwind CSS. MastUI empowers developers to craft elegant, fast, and accessible React applications — one component at a time.

📦 Monorepo Structure (If using monorepo)

root/
├── apps/
│   ├── docs/                 # Fumadocs-powered documentation site
│   ├── landing/              # MastUI landing page
│   └── playground/           # Tests components in environment
├── packages/
│   ├── eslint-config/        # Shared ESLint config
│   ├── mastui/               # Component library (ShadCN + Magic UI)
│   ├── tailwind-config/      # Shared Tailwind config
│   └── typescript-config/    # Shared TypeScript config

✨ MastUI Highlights

• 🎨 Variants & Sizes powered by cva
• 🎬 Fluid Animations with Magic UI (Framer Motion)
• ⚡ Tree-shakable: Import only what you need
• 💅 Dark Mode & Theming built on Tailwind CSS
• ✅ Accessibility ensured via Radix UI Primitives
• 🔧 Composable & Extendable components
• 🔥 Modern DX with TypeScript, Tailwind, and React

📦 Installation

Install MastUI components via npm:

npm install mastui

Also install peer dependencies:

npm install tailwindcss framer-motion class-variance-authority tailwind-merge

🛠 Quick Usage

import { Button } from "mastui";

export default function App() {
  return (
    <div className="p-4">
      <Button variant="default" size="md" animate>
        Click Me
      </Button>
    </div>
  );
}

🧪 Local Development (For monorepo)

pnpm install
pnpm dev

Build all packages:

pnpm build

🌐 Docs & Playground

• Documentation powered by Nextra — typically under /apps/docs
• Landing page in Next.js — typically /apps/landing

🔧 Remote Caching with Turborepo + Vercel

Speed up builds with remote caching:

npx turbo login
npx turbo link

Learn more: Turborepo Remote Caching

📜 License

MIT License © Made with ❤️ by Aditya Narayan

🔗 Useful Links

• Turborepo Documentation
• ShadCN UI
• Magic UI
• Framer Motion
• Tailwind CSS
• Radix UI Primitives