A collection of beautiful, animated, and responsive design components built with React, Tailwind CSS, and Framer Motion.
mirazahmed/ui is an interactive component registry and preview gallery. Instead of installing heavy, opinionated UI packages with hidden internals, browse live animated components, test responsive viewports in real time, and copy clean, accessible, type-safe code straight into your project.
- 🌐 Live Demo: mirazahmed/ui.
- 🧑💻 Author: Miraz Ahmed
- 🌐 Author Portfolio: mirazahmed.com
- Fluid Animations: Micro-interactions and fluid layout transitions powered by Framer Motion spring physics.
- Interactive Component Playground:
- Responsive Viewport Toggles: Switch instantly between Desktop, Tablet (640px), and Mobile (380px) frames.
- Fullscreen Preview: Expand components to full screen to inspect details and behavior.
- Reset State: One-click preview reload to test initial animations and mount transitions.
- Copy-Paste Workflow: One-click copy for component source code, installation command, and usage snippets.
- Complete Documentation: Each component includes a full props interface table, TypeScript type definitions, and realistic usage examples.
- Command Palette (
⌘K): Global fuzzy search across all components and categories. - Dark & Light Modes: Built-in theme switcher with system preference detection and smooth transitions.
- Modern Stack: Built on Next.js 16, React 19, Tailwind CSS v4, and TypeScript.
The library includes 14+ handcrafted components organized into 5 categories:
| Category | Component | Description | Dependencies |
|---|---|---|---|
| Navigation | Stacking Navbar | Pill navigation bar that fans out horizontally on hover with spring physics | framer-motion, lucide-react |
| Navigation | Dropdown Menu | Animated dropdown menu with nested groups, icons, and keyboard shortcuts | framer-motion, lucide-react |
| Navigation | Animated Tabs | Sliding pill active tab indicator with Framer Motion layout springs | framer-motion |
| Navigation | Floating Action Menu | Expandable speed-dial FAB button fanning out into secondary actions | framer-motion, lucide-react |
| Inputs | Input With Tags | Tag chip input with badge removal, keyboard shortcuts, and limit validation | framer-motion, lucide-react |
| Inputs | Cycle Status Button | Button that cycles through workflow statuses with icon transitions | framer-motion, lucide-react |
| Inputs | Switch | Accessible toggle switch with spring thumb movement and icon indicators | framer-motion, lucide-react |
| Surfaces | Stacked Cards | Overlapping card deck with interactive hover peel and spring physics | framer-motion, lucide-react |
| Surfaces | Avatar Group | Overlapping avatar stack with hover expand and overflow indicator | framer-motion |
| Media | Video Player | Custom video player with custom scrubber, play/pause, volume, and fullscreen | lucide-react |
| Media | Audio Player | Compact audio player with progress track, duration timers, and volume slider | lucide-react |
| Feedback | Notification Popover | Animated notification bell with unread badge and rich notification list | framer-motion, lucide-react |
| Feedback | Alert | Dismissible contextual alerts (info, success, warning, destructive) | framer-motion, lucide-react |
| Feedback | Word Loader | Rotating status text loader with vertical slide and blur-in transitions | framer-motion |
- Framework: Next.js 16 (App Router, Server Components)
- Library: React 19
- Styling: Tailwind CSS v4 (
@tailwindcss/postcss) - Animation: Framer Motion
- Icons: Lucide React
- Code Highlighting: PrismJS
- Typography: Geist & Geist Mono (
next/font) - Language: TypeScript
Most components use framer-motion, lucide-react, and utility helpers. Install them in your project:
npm install framer-motion lucide-react clsx tailwind-mergeIn your project, add lib/utils.ts (if you don't already have it):
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs));
}- Browse the component gallery on ui.mirazahmed.com (or under
src/components/library/). - Click Copy on the component code.
- Paste directly into your project (e.g.
components/ui/stacking-navbar.tsx).
ui/
├── public/ # Static assets (favicons, logos, media previews)
├── src/
│ ├── app/
│ │ ├── layout.tsx # Root layout (header, sidebar, font variables, theme init)
│ │ ├── page.tsx # Landing / default component view
│ │ ├── globals.css # Tailwind v4 theme variables and base styles
│ │ └── components/ # Dynamic route for [slug] component pages
│ ├── components/
│ │ ├── code-block.tsx # Syntax highlighted code viewer with copy
│ │ ├── component-sidebar.tsx # Sidebar categorizing all components
│ │ ├── component-view.tsx # Component documentation and preview layout
│ │ ├── copy-button.tsx # Clipboard copy button with toast feedback
│ │ ├── mobile-nav.tsx # Mobile navigation sheet drawer
│ │ ├── preview-container.tsx # Responsive viewport container with reset
│ │ ├── site-header.tsx # Header with ⌘K search & theme toggle
│ │ └── library/ # Component implementations
│ │ ├── alert.tsx
│ │ ├── animated-tabs.tsx
│ │ ├── audio-player.tsx
│ │ ├── avatar-group.tsx
│ │ ├── cycle-status-button.tsx
│ │ ├── dropdown-menu.tsx
│ │ ├── floating-action-menu.tsx
│ │ ├── input-with-tags.tsx
│ │ ├── notification-popover.tsx
│ │ ├── stacked-cards.tsx
│ │ ├── stacking-navbar.tsx
│ │ ├── switch.tsx
│ │ ├── video-player.tsx
│ │ └── word-loader.tsx
│ ├── data/
│ │ └── components.ts # Component catalog metadata, props, source & usage
│ └── lib/
│ └── utils.ts # cn helper function
├── package.json
└── tsconfig.json
Contributions, component additions, and suggestions are welcome!
- Fork the repository
- Create your feature branch (
git checkout -b feat/new-component) - Add your component to
src/components/library/and document it insrc/data/components.ts - Commit your changes (
git commit -m 'feat: add new-component') - Push to the branch (
git push origin feat/new-component) - Open a Pull Request
This project is open source and available under the MIT License.