# 🎨 Component Usage Guide
## 📦 Available Components
### 1. Input Component
**Location**: `components/ui/input.tsx`
#### Basic Usage
```tsx
import { Input } from '@/components/ui/input'
```
#### With Icon
```tsx
}
/>
```
#### With Error
```tsx
```
#### Features
- ✅ Floating label animation
- ✅ Icon support (left side)
- ✅ Error state with message
- ✅ Focus ring animation
- ✅ Accessible (ARIA labels)
---
### 2. Button Component
**Location**: `components/ui/button.tsx`
#### Variants
**Primary (Green Gradient)**
```tsx
```
**Secondary (Outlined)**
```tsx
```
**Ghost (Transparent)**
```tsx
```
**GitHub (Black)**
```tsx
```
#### Sizes
```tsx
```
#### With Loading
```tsx
```
#### With Icon
```tsx
```
#### Features
- ✅ 4 variants (primary, secondary, ghost, github)
- ✅ 3 sizes (sm, md, lg)
- ✅ Loading state with spinner
- ✅ Icon support
- ✅ Hover/tap animations
- ✅ Disabled state
---
### 3. Password Strength Meter
**Location**: `components/ui/password-strength.tsx`
#### Usage
```tsx
import { PasswordStrength } from '@/components/ui/password-strength'
const [password, setPassword] = useState('')
setPassword(e.target.value)}
/>
```
#### Strength Levels
- **Weak** (Red): 0-2 points
- **Fair** (Yellow): 3 points
- **Good** (Blue): 4 points
- **Strong** (Green): 5 points
#### Scoring
- Length ≥ 8: +1
- Length ≥ 12: +1
- Mixed case: +1
- Numbers: +1
- Special chars: +1
#### Features
- ✅ Real-time calculation
- ✅ Animated progress bars
- ✅ Color-coded feedback
- ✅ Visual strength label
---
### 4. Animated Stats
**Location**: `app/(auth)/components/AnimatedStats.tsx`
#### Usage
```tsx
import { AnimatedStats } from './components/AnimatedStats'
```
#### Display
```
10K+ Developers
50K+ Projects
1M+ Stars
```
#### Features
- ✅ Counting animation (0 to target)
- ✅ Number formatting (K, M)
- ✅ Staggered entrance
- ✅ 2-second duration
---
### 5. Project Showcase
**Location**: `app/(auth)/components/ProjectShowcase.tsx`
#### Usage
```tsx
import { ProjectShowcase } from './components/ProjectShowcase'
```
#### Projects
1. awesome-app (TypeScript, 1337⭐)
2. cool-project (JavaScript, 892⭐)
3. next-gen-ui (React, 2456⭐)
4. api-gateway (Go, 567⭐)
#### Features
- ✅ Auto-rotation (3s interval)
- ✅ Language color indicators
- ✅ Star counts
- ✅ Progress dots
- ✅ Smooth transitions
---
## 🎨 Styling Patterns
### Glassmorphism Card
```tsx
{/* Content */}
```
### Gradient Button
```tsx
```
### Gradient Text
```tsx
Gradient Text
```
### Focus Ring
```tsx
```
---
## 🎭 Animation Patterns
### Page Entrance
```tsx
{/* Content */}
```
### Button Hover
```tsx
Click me
```
### Floating Animation
```tsx
{/* Content */}
```
### Staggered List
```tsx
{items.map((item, i) => (
{item}
))}
```
---
## 🎯 Common Patterns
### Form Field
```tsx
```
### Error Message
```tsx
Error message
```
### Loading Spinner
```tsx
```
---
## 📱 Responsive Utilities
### Hide on Mobile
```tsx
Desktop only
```
### Show on Mobile
```tsx
Mobile only
```
### Responsive Grid
```tsx
{/* Items */}
```
---
## 🎨 Color Utilities
```tsx
// Backgrounds
bg-background // #0A0C10
bg-surface // #161b22
bg-primary // #58a6ff
bg-accent // #238636
// Text
text-foreground // #c9d1d9
text-foreground-secondary // #8b949e
text-primary // #58a6ff
text-accent // #238636
// Borders
border-border // #30363d
border-primary // #58a6ff
```
---
## 🔧 Utility Functions
### cn() - Class Name Merger
```tsx
import { cn } from '@/lib/utils'
```
---
**Happy Coding! 🚀**