8000 GitHub - mirazahmeed/ui · GitHub
[go: up one dir, main page]

Skip to content
mirazahmeedPublic

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

mirazahmed/ui.

A collection of beautiful, animated, and responsive design components built with React, Tailwind CSS, and Framer Motion.

Explore Live Showcase →

Next.js React Tailwind CSS Framer Motion TypeScript License


✦ Overview

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.


✨ Features

  • 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.

🧩 Component Library

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

🛠️ Tech Stack


🚀 How to Use Components

1. Install dependencies

Most components use framer-motion, lucide-react, and utility helpers. Install them in your project:

npm install framer-motion lucide-react clsx tailwind-merge

2. Add the cn helper

In 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));
}

3. Copy & paste any component

  1. Browse the component gallery on ui.mirazahmed.com (or under src/components/library/).
  2. Click Copy on the component code.
  3. Paste directly into your project (e.g. components/ui/stacking-navbar.tsx).

📁 Project Structure

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

🤝 Contributing

Contributions, component additions, and suggestions are welcome!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feat/new-component)
  3. Add your component to src/components/library/ and document it in src/data/components.ts
  4. Commit your changes (git commit -m 'feat: add new-component')
  5. Push to the branch (git push origin feat/new-component)
  6. Open a Pull Request

📄 License

This project is open source and available under the MIT License.


Crafted by Miraz Ahmed

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0