GlintKit UI Library

A customizable, accessible, and performant UI component library built with React, Radix UI, Tailwind CSS, and Framer Motion.

⚡ Built with modern tooling — Next.js, TypeScript, Tailwind, and more.

---

🚀 Features

• ⚛️ Built on React 19 and Next.js 15
• 🎨 Utility-first styling with Tailwind CSS v4
• 🧩 Accessible components with Radix UI
• 🌀 Smooth animations via Framer Motion
• 💡 Headless, composable, and customizable
• 📚 MDX-powered docs with Fumadocs
• 🌗 Dark mode support with next-themes
• ✨ Optimized and tree-shakable

---

📦 Installation

# Clone the repository
git clone https://github.com/techySPHINX/glintkit-ui.git
cd react-ui

# Install dependencies
npm install
# or
yarn install
# or
pnpm install

---

🛠️ Usage (Development)

npm run dev
# or
yarn dev
# or
pnpm dev

Visit http://localhost:3000 in your browser.

---

📁 Project Structure

.
├── app/                      # Next.js app directory
├── components/               # Reusable UI components
├── docs/                     # Documentation content (MDX)
├── lib/                      # Utilities and helpers
├── pages/                    # Fallback for older routing (if used)
├── public/                   # Static assets
├── styles/                   # Tailwind and global CSS
├── tailwind.config.ts        # Tailwind configuration
├── tsconfig.json             # TypeScript configuration
└── package.json              # Project metadata and dependencies

---

🧩 Tech Stack

• React 19
• Next.js 15
• Tailwind CSS 4
• Radix UI
• Framer Motion
• React Hook Form + Zod (for forms and validation)
• Fumadocs (documentation)
• Lucide Icons, Sonner, CMDK, Embla Carousel, and more

---

🤝 Contributing

We welcome contributions! Follow the steps below to get started:

1. Fork the Repository

Click the Fork button at the top right of this page.

2. Clone Your Fork

git clone https://github.com/techySPHINX/glintkit-ui.git
cd glintkit-ui

3. Create a New Branch

git checkout -b feat/your-feature-name

4. Make Your Changes

• Add or update components inside the components/ folder.
• Use consistent naming and coding conventions.
• Add relevant stories, docs, or tests if necessary.

5. Commit and Push

git add .
git commit -m "feat: added new component"
git push origin feat/your-feature-name

6. Open a Pull Request

Submit your PR and follow the pull request template.

---

🧪 Linting & Formatting

npm run lint

---

📝 License

This project is licensed under the JAGAN_LICENSE.

---

🌍 Community & Support

• Issues: Submit here
• Discussions: Join here
• Linkedin: Connect

---

📌 TODO

• Add Storybook integration
• Add CI/CD pipeline
• Publish to NPM
• Improve accessibility auditing
• Add more components
• Improve documentation
• Add more examples
• Improve performance
• Add more features
• Improve security auditing
• Add more integrations
• Add registries

---

Built with ❤️ by Jagan Kumar Hotta