Open-Source UI Component Library
Elevate your projects with ZenUI, a free, lightweight, customizable UI component library built with React and Tailwind CSS. ZenUI provides various components, icons, website templates, and color palette options to accelerate development.
![cover](https://i.ibb.co.com/CWtdR19/post.png)
## Features
- Customizable 500+ Icons
- 600+ Components
- color Opacity Palette
- 100+ Programming Resources
- Extract Color From Uploaded Image (Color Picker)
- Website Templates
- Website Blocks
- Copy the Code And Use It On Your Project
## Be A Sponsor
## Installation
Clone the repository:
```bash
git clone https://github.com/Asfak00/zenui-library.git
```
Go to the project directory:
```bash
cd zenui-library
```
Install the all dependencies:
```bash
npm install
```
Run the project:
```bash
npm run dev
```
## Documentation
ZenUI is a plug-and-play component library using by **Tailwind CSS** styling. Just **copy** the code and **paste** it into your project, no installation or configuration needed!
### Getting Started
ZenUI components are designed for quick and easy use. To get started, simply:
1. Find the component you want in the [ZenUI library](https://zenui.net).
2. Copy the code snippet.
3. Paste it into your project, anywhere HTML is supported.
### Using ZenUI Components
#### Copy and Paste Usage
Each component in ZenUI is built with Tailwind CSS classes. For example:
```html
```
This button is ready to go. No props or extra configuration required.
### Customizing Components
Since ZenUI components use Tailwind CSS, you can easily customize them by modifying or adding classes. Here’s how:
### Changing Colors and Sizes
To adjust colors, sizes, or other styling attributes, modify the Tailwind classes:
```html
```
#### Changes:
- `bg-green-500` changes the background color.
- `px-6 py-3` adjusts padding for larger button size.
- `rounded-lg` increases the border radius for a more rounded button.
### Adding or Modifying Classes
Feel free to add any Tailwind CSS class to further style components, for example, adding shadow effects or animations.
```html
ZenUI Card
This is a customizable card component.
```
#### Changes:
- `shadow-lg` adds a shadow for depth.
- `hover:shadow-xl` increases the shadow on hover.
- `transition-shadow` adds smooth transitions for better UX.
### Best Practices
1. **Start with Defaults**: Use ZenUI components as provided before customizing, so you know how they behave.
2. **Use Tailwind’s Utility-First Approach**: Tailwind CSS is optimized for utility classes, so apply additional classes as needed instead of rewriting CSS.
3. **Document Customizations**: Keep notes on any modifications to standard ZenUI components for easy maintenance.
## Sell Your Template Through ZenUI Library
We're excited to offer the opportunity for creators to sell their templates on the ZenUI Library! Contribute and earn by sharing your React, Next.js, or Tailwind CSS templates with our community.
For more details on how to submit and sell your templates, including guidelines, submission steps, and earnings information, please read the [TEMPLATE_SUBMISSION_GUIDE.md](https://github.com/Asfak00/zenui-library/blob/production/TEMPLATE_SUBMISSION_GUIDE.md) file.
Earn 80% commission on each sale, and help empower other developers with your creative solutions! 🚀
## Contribution
We welcome contributions from the community! Please refer to the [CONTRIBUTING.md](https://github.com/Asfak00/zenui-library/blob/production/CONTRIBUTING.md) file for more details on how to contribute.
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/Asfak00/zenui-library/blob/production/LICENSE.md) file for details.
## Connect With ZenUI