<a href="https://swaveui.com" target="_blank"><img src="https://swaveui.com/assets/images/swaveui-logo-web.png" class="sw-img sw-wd-40" /></a>

SwaveUI is a versatile CSS framework designed to simplify the process of creating beautiful and responsive user interfaces and websites. With a rich set of utilities, helpers, and components, SwaveUI empowers developers to build engaging and functional web experiences efficiently.

<a href="https://swaveui.com/docs" target="_blank"><strong>Documentation</strong></a>
<!-- ![Build Status](https://github.com/toubielawbar/swaveui/actions/workflows/WORKFLOW-FILE/badge.svg)
[![Build Status](https://img.shields.io/github/actions/workflow/status/toubielawbar/swaveui/js.yml?branch=main&label=JS%20Tests&logo=github)](https://github.com/toubielawbar/swaveui/actions/workflows/js.yml?query=workflow%3AJS+branch%3Amain) -->
[![npm version](https://img.shields.io/npm/v/swaveui?logo=npm&logoColor=fff)](https://www.npmjs.com/package/swaveui)
![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)
![npm](https://img.shields.io/npm/dm/swaveui.svg)
[![](https://data.jsdelivr.com/v1/package/npm/swaveui/badge)](https://www.jsdelivr.com/package/npm/swaveui)

## Features
- Pre-built UI Elements – Includes buttons, forms, modals, and navigation bars for quick integration.
- Responsive Design – Optimized for mobile-first development with flexible grid and layout utilities.
- Customizable Themes – Allows easy modification of colors, typography, and spacing via configuration files.
- Dark Mode Support – Built-in styles for seamless dark mode adaptation.
- Utility Classes – Provides atomic CSS utilities for spacing, alignment, and visibility control.
- Lightweight & Fast – Minimal CSS footprint for improved performance.
- Accessibility Features – Ensures compatibility with screen readers and keyboard navigation.
- Animations & Transitions – Smooth effects for interactive elements.
- Browser Compatibility – Works across major browsers with vendor prefixing.
- Comprehensive Documentation – Guides developers with examples and best practices.


## Installation

### NPM
```sh
npm install swaveui
```

```sh
npm install swaveui-utilities
```

### Yarn
```sh
yarn install swaveui
```

```sh
yarn install swaveui-utiltiies
```

**OR**

### IMPORT
After installation, you can import the CSS file into your project using this snippet:

```sh
import 'swaveui/dist/swaveui.min.css'
```

```sh
import 'swaveui/dist/swaveui-utilities.min.css'
```

### CDN
[https://www.jsdelivr.com/package/npm/swaveui](https://www.jsdelivr.com/package/npm/swaveui)
[https://www.jsdelivr.com/package/npm/swaveui](https://www.jsdelivr.com/package/npm/swaveui-utilities)

## CONTRIBUTING
Please refer to the [CONTRIBUTING.md](https://github.com/swaveui/swaveui/blob/main/.github/CONTRIBUTING.md) for more details on contributing.

## COMMUNITY
Swave UI thrives on collaboration, feedback, and community-driven innovation. Whether you're a designer, developer, or just passionate about clean, efficient UI frameworks, you're welcome here!

Here’s how you can get involved:

- Join the Discussion
Engage with other users, ask questions, share ideas, and get help:
- <a href="https://x.com/swaveui">Twitter / X </a> — Stay updated on news and releases.

- Contribute
Swave UI is open-source and welcomes contributions of all kinds—bug reports, feature requests, design tweaks, or new components. See our Contributing Guide for more.

- Report Issues
Found a bug or inconsistency? Open an issue on <a href="https://github.com/swaveui/swaveui/issues">GitHub Issues</a> and help us improve.

- Spread the Word
Love Swave UI? Star the repo, share it on social media, or use the #SwaveUI hashtag to connect with others.


## LICENSE
swaveui is licensed under the MIT License. See the [LICENSE](https://github.com/swaveui/swaveui/blob/main/.github/LICENSE) file for more details.

## CONTACT
You can reach us by email at if you want to discuss more about Swave UI. [info@swaveui.com](mailto:info@swaveui.com)