# Zard

Modern Angular component library inspired by shadcn/ui, built with TailwindCSS and designed for developers who value <b>beautiful</b>, <b>accessible</b>, and <b>completely free</b> open source components.

<a alt="Zard Ui logo" href="https://www.zardui.com/" target="_blank" rel="noreferrer">
  <img align="center" width=100% src="https://www.zardui.com/images/github_banner.png"/>
</a>

<p align="center">Made with ❤️ from 🇧🇷</p>
<p align="center">
<img src="https://img.shields.io/github/stars/zard-ui/zardui" alt="zard ui repository stars"/>
</p>

## Stack

![Angular](https://img.shields.io/badge/angular-%23DD0031.svg?style=for-the-badge&logo=angular&logoColor=white)
![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=for-the-badge&logo=tailwind-css&logoColor=white)
![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white)

## Documentation

Visit https://www.zardui.com/docs to view the documentation

## Contributing

We follow a **simple GitHub Flow** with automated releases. Please read our [contributing guide](/CONTRIBUTING.md) to get started.

### Quick Start for Contributors

1. Fork the repository
2. Create your feature branch: `git checkout -b feat/#123-your-feature`
3. Develop with as many commits as you want
4. Open a PR to `master`
5. After review + merge = automatic release!

### Development Commands

```bash
npm start          # Start dev server (port 4222)
npm test           # Run all tests
npm run build      # Build production
npm run release    # Automated release
```

## License

Licensed under the [MIT license](/LICENSE.md).

## Get In Touch

<p>Click on one of the icons and Help us on this journey and be part of our community.</p>

<a href="https://chat.whatsapp.com/Dctdh6Huhvm24OX6js5XKT" target="_blank">
  <img src="https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white" alt="whatsapp" />
</a>
<img src="https://dcbadge.limes.pink/api/server/https://discord.com/invite/yP8Uj9rAX9" alt="discord" />

<span>Follow us in</span> <a href="https://x.com/zard_ui" target="_blank">
  <img src="https://img.shields.io/badge/X-%23000000.svg?logo=X&logoColor=white" alt="X" />
</a>