<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
    <div align="center">
  <img src="https://codewithmuhilan.com/Extra-Assets/lightwind-logo.png" alt="Lightswind UI Logo" width="180" />
  
  <h1 align="center">Lightswind UI 3.0.6</h1>
  
  <p align="center">
    <b>Create stunning web applications effortlessly with Lightwind UI. Access 100+ customizable cli components, blocks, and templates for various applications—from dashboards to resource pages and catalog displays. Available in React, these pre-built animated elements are fully customizable, helping you craft user-friendly, visually appealing apps without starting from scratch.</b>
  </p>
  
<p align="center">
  <a href="https://github.com/codewithMUHILAN/Lightswind-UI-Library/stargazers">
    <img src="https://img.shields.io/github/stars/codewithMUHILAN/Lightswind-UI-Library?style=flat-square&labelColor=000000&color=4d4d4d" alt="GitHub Stars" />
  </a>
  <a href="https://www.npmjs.com/package/lightswind">
    <img src="https://img.shields.io/npm/v/lightswind?style=flat-square&labelColor=000000&color=4d4d4d" alt="NPM Version" />
  </a>
  <a href="https://github.com/codewithMUHILAN/Lightswind-UI-Library/blob/main/README.md">
    <img src="https://img.shields.io/github/license/codewithMUHILAN/Lightswind-UI-Library?style=flat-square&labelColor=000000&color=4d4d4d" alt="License" />
  </a>
</p>

  
  <br />
  <!-- <p align="center">
    <img src="https://i.ibb.co/CtFSK18/lightswind-components-display.png" alt="Lightswind UI Components" width="90%" />
  </p> -->
</div>

<hr />

## 📦 Installation

<h3>Install Lightswind in your Project</h3>

```bash
# Using npm
npm install lightswind@lastest

# Using yarn
yarn add lightswind

# Using pnpm
pnpm add lightswind
```
<h3>Run the create command to add Lightswind components to your local project</h3>

```bash
# Create lightswind folder in your project
npx create-lightswind

# Note**
What this command does:
Creates src/components/lightswind folder
All UI components are organized in this directory

Sets up src/lib folder
Contains utilities and helpers for component functionality

Configures theme settings
Sets up custom theme variables and Tailwind configuration

Adds TypeScript types
Includes comprehensive type definitions for all components
```

<h3>Setup Black-UI Plugin</h3>

```bash
# Basic Plugin Setup

 module.exports = {
  content: ["./src/**/*.{js,jsx,ts,tsx}"],
  theme: {
    extend: {},
  },
  plugins: [require("lightswind/plugin")],
};
```

<h3>Start building your interface with Lightswind UI components</h3>

## 🔧 Requirements

- React 18+
- Tailwind CSS 3.3+
- TypeScript 4.9+ (for TypeScript users)

## 🚀 Quick Start

```jsx
import React from 'react';
import { Button } from '@components/lightswind/button';
import { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from '@components/lightswind/card';
import { Input } from '@components/lightswind/input';

export default function LoginPage() {
  return (
    <div className="min-h-screen flex items-center justify-center bg-slate-50 dark:bg-slate-900 p-4">
      <Card className="w-full max-w-md shadow-lg">
        <CardHeader className="space-y-1">
          <CardTitle className="text-2xl font-bold">Sign in</CardTitle>
          <CardDescription>Enter your credentials to access your account</CardDescription>
        </CardHeader>
        <CardContent>
          <div className="space-y-4">
            <div className="space-y-2">
              <label htmlFor="email" className="text-sm font-medium">Email</label>
              <Input id="email" type="email" placeholder="your@email.com" />
            </div>
            <div className="space-y-2">
              <label htmlFor="password" className="text-sm font-medium">Password</label>
              <Input id="password" type="password" placeholder="••••••••" />
            </div>
          </div>
        </CardContent>
        <CardFooter>
          <Button className="w-full">Sign in</Button>
        </CardFooter>
      </Card>
    </div>
  );
}
```

## ✨ Features

- **🎨 Beautiful Design System** — Sleek, professional aesthetics with carefully crafted components
- **♿ Accessible Components** — WCAG 2.1 compliant with full keyboard navigation and screen reader support
- **🌙 Dark Mode Built-in** — Seamless light and dark mode transitions with consistent theming
- **📱 Fully Responsive** — Components designed to work flawlessly across all device sizes
- **⚡ Performance Optimized** — Efficient rendering with minimal bundle size impact
- **🧩 Highly Customizable** — Flexible theming system that adapts to your brand
- **🔄 Interactive Effects** — Smooth animations and transitions enhance user experience
- **📊 Advanced UI Patterns** — Sophisticated components for complex data visualization and user interactions

## 🧩 Component Library

Lightswind UI includes a comprehensive set of components:

### Our Components List

<ul className="space-y-4">
  <li>
    <h3 className="text-xl font-bold mb-2">Get Started</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Introduction</li>
      <li>Installation</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Background</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Animated Wave</li>
      <li>Animated Bubble Particles</li>
      <li>Animated Ocean Waves</li>
      <li>Grid & Dot Backgrounds</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Text</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Aurora Text</li>
      <li>Scroll Reveal</li>
      <li>Shiny Text</li>
      <li>Typewriter Input</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Button</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Border Beam</li>
      <li>Confetti Button</li>
      <li>Gradient Button</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">3D Elements</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>3d Image Ring</li>
      <li>3D Carousel</li>
      <li>3D Marquee</li>
      <li>3D Hover Gallery</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Cursor</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Canvas Confetti Cursor</li>
      <li>Magic Cursor</li>
      <li>Particle Orbit Effect</li>
      <li>Smokey Cursor</li>
      <li>Smooth Cursor</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Components</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Animated Notification</li>
      <li>Code Hover Cards</li>
      <li>Count Up</li>
      <li>Dynamic Navigation</li>
      <li>Glowing Cards</li>
      <li>Hamburger Menu Overlay</li>
      <li>Interactive Gradient Card</li>
      <li>Lens</li>
      <li>Magic Loader</li>
      <li>Morphing Navigation</li>
      <li>Password Strength Indicator</li>
      <li>Scroll Stack</li>
      <li>Scroll Timeline</li>
      <li>Seasonal Hover Cards</li>
      <li>Sliding Logo Marquee</li>
      <li>Team Carousel</li>
      <li>Woofy Hover Image</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Layout</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Accordion</li>
      <li>Aspect Ratio</li>
      <li>Resizable</li>
      <li>Scroll Area</li>
      <li>Separator</li>
      <li>Tabs</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">UI Elements</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Alert</li>
      <li>Alert Dialog</li>
      <li>Avatar</li>
      <li>Badge</li>
      <li>Button</li>
      <li>Card</li>
      <li>Carousel</li>
      <li>Chart</li>
      <li>Collapsible</li>
      <li>Context Menu</li>
      <li>Dialog</li>
      <li>Drawer</li>
      <li>Dropdown Menu</li>
      <li>Hover Card</li>
      <li>Popover</li>
      <li>Progress</li>
      <li>Sheet</li>
      <li>Skeleton</li>
      <li>Table</li>
      <li>Toast</li>
      <li>Tooltip</li>
      <li>Top Loader</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Form Controls</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Calendar</li>
      <li>Checkbox</li>
      <li>Command</li>
      <li>Form</li>
      <li>Input</li>
      <li>Input OTP</li>
      <li>Label</li>
      <li>Radio Group</li>
      <li>Select</li>
      <li>Slider</li>
      <li>Switch</li>
      <li>Textarea</li>
      <li>Toggle</li>
      <li>Toggle Group</li>
    </ul>
  </li>

  <li>
    <h3 className="text-xl font-bold mb-2">Navigation</h3>
    <ul className="ml-4 list-disc text-sm text-muted-foreground">
      <li>Breadcrumb</li>
      <li>Command</li>
      <li>Dock</li>
      <li>Menubar</li>
      <li>Navigation Menu</li>
      <li>Pagination</li>
      <li>Sidebar</li>
    </ul>
  </li>
</ul>




## 🌈 Theming System

Lightswind UI uses CSS variables for theming, making it easy to customize:

```css
:root {
  --primary: 240 5% 10%;
  --primary-foreground: 0 0% 98%;
  
  /* Add your custom theme colors */
  --brand-purple: 267 100% 58%;
  --brand-blue: 214 100% 60%;
}

.dark {
  --primary: 0 0% 98%;
  --primary-foreground: 240 5% 10%;
}
```


## 📖 Documentation

For comprehensive documentation including all components, props, and examples:

[**View Documentation**](https://pro.lightswind.com/components?component=Introduction)


## 🤝 Contributing

We welcome contributions to Lightswind UI! Here's how you can help:

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 📋 Changelog

### Version 3.0.0 (July 2025)
- 🎉 Initial stable release with 40+ production-ready components
-  Basic to Advanced props for each components.
-  Dark mode support finalized
-  WCAG 2.1 AA compliance across all components
-  Responsive design for all screen sizes
-  Theme customization system
-  Performance optimizations
-  Well-documented for each component

### Version 3.0.3 (July 2025)
- 🎉 Added 10+ Animated Components
-  Rectified the old components bugs

### Version 3.0.6 (July 2025)
- 🎉 Added 5+ Animated Components
-  Rectified the old components bugs

## 📄 License

Lightswind UI is licensed under the [MIT License](https://github.com/codewithMUHILAN/Lightswind-UI-Library/blob/main/README.md).

---

<div align="center">
  <p>
    <sub>Designed and built with ❤️ by the MuhilanOrg</sub>
  </p>
  <p>
<a href="https://instagram.com/codewith_muhilan/" target="_blank">
  <img src="https://img.shields.io/badge/Follow-@codewith_muhilan-blue?style=social&logo=instagram" alt="Instagram Follow" />
</a>
  </p>
</div>
</body>
</html>