# @maz-ui/nuxt
✨ **The Ultimate Nuxt Module for Beautiful Vue.js Components** ✨
Transform your Nuxt application with **Maz-UI** - a comprehensive Vue.js component library that makes building beautiful interfaces effortless!
[](https://badge.fury.io/js/%40maz-ui%2Fnuxt)
[](https://opensource.org/licenses/MIT)
## What is Maz-UI?
**Maz-UI** is a powerful Vue.js component library with **50+ beautiful components**, **20+ useful composables**, and **smart directives** that work perfectly with Nuxt. Think of it as your design system in a box!
### Why Choose Maz-UI for Your Nuxt App?
- **Zero Configuration** - Works instantly with sensible defaults
- **Beautiful by Default** - Professional design with dark mode included
- **Everything Auto-Imported** - No more import statements needed
- **Super Fast** - Optimized for performance with tree-shaking
- **Developer Friendly** - TypeScript support and great DevTools
- **Production Ready** - Perfect SSR/SSG support
## Quick Start (2 minutes!)
### Step 1: Install the module
```bash
# Choose your package manager
npm install @maz-ui/nuxt
# or
pnpm add @maz-ui/nuxt
# or
yarn add @maz-ui/nuxt
```
### Step 2: Add to your Nuxt config
```ts
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@maz-ui/nuxt'],
})
```
**That's it! 🎉** All components, composables, and features are now available in your app!
### Step 3: Start using components
```vue
Click me!
Welcome to Maz-UI!
Current theme: {{ isDark ? 'Dark' : 'Light' }}
Hover me for tooltip
```
## What You Get Out of the Box
### 50+ Beautiful Components
- **Buttons**: `MazBtn`,
- **Forms**: `MazInput`, `MazSelect`, `MazCheckbox`, `MazRadio`, `MazTextarea`, `MazInputPhoneNumber`
- **Overlay**: `MazDropdown`, `MazPopover`
- **Navigation**: `MazTabs`, `MazStepper`, `MazPagination`
- **Data Display**: `MazTable`, `MazCard`, `MazBadge`, `MazAvatar`
- **Media**: `MazCarousel`, `MazGallery`, `MazLazyImg`
- **Feedback**: `MazDialog`, `MazToast`, `MazSpinner`, `MazLoadingBar`
- **Charts**: `MazChart` (with Chart.js integration)
- **And 30+ more!**
### 20+ Powerful Composables
- **`useTheme()`** - Theme management and dark mode
- **`useToast()`** - Beautiful toast notifications
- **`useDialog()`** - Modal dialogs made easy
- **`useAos()`** - Smooth scroll animations
- **`useTimer()`** - Countdown and timer functionality
- **`useWindowSize()`** - Reactive window dimensions
- **`useBreakpoints()`** - Responsive design helpers
- **And many more!**
### Smart Directives
- **`v-tooltip`** - Beautiful tooltips anywhere
- **`v-lazy-img`** - Lazy load images automatically
- **`v-zoom-img`** - Click to zoom images
- **`v-click-outside`** - Detect outside clicks
- **`v-fullscreen-img`** - Fullscreen image viewer
## Theming Made Simple
Maz-UI comes with a powerful theming system that makes your app look professional instantly:
```vue