<p align="center">
  <a href="https://v3.heroui.com">
      <img 
        alt="HeroUI v3 logo" 
        width="100%" 
        src="https://heroui-assets.nyc3.cdn.digitaloceanspaces.com/docs/heroui-og_2x.jpg"
      />
  </a>
</p>
<p align="center">
  <a href="https://github.com/heroui-inc/heroui/blob/main/LICENSE">
    <img src="https://img.shields.io/npm/l/@heroui/react?style=flat" alt="License">
  </a>
  <a href="https://www.npmjs.com/package/@heroui/react">
    <img src="https://img.shields.io/npm/dm/@heroui/react.svg?style=flat-round" alt="npm downloads">
  </a>
</p>

> **⚠️ Note:** You're currently viewing **HeroUI v3** (beta), which is in active development and close to stable. If you need v2, check out the [`v2` branch](https://github.com/heroui-inc/heroui/tree/v2).

HeroUI is the modern UI library built to help you move fast, stay consistent, and deliver delightful user experiences.

## Version Status

**HeroUI v3** is currently in **beta** and approaching stable release. We're actively working on finalizing v3 and expect to reach stable status soon.

If you need v2, you can find it on the [`v2` branch](https://github.com/heroui-inc/heroui/tree/v2). Your feedback and contributions to v3 are welcome!

## Getting Started

Visit <a aria-label="heroui learn" href="https://v3.heroui.com/docs/quick-start">https://v3.heroui.com/docs/quick-start</a> to get started with HeroUI v3.

## Documentation

Visit [https://v3.heroui.com/docs](https://v3.heroui.com/docs) to view the full documentation.

## Storybook

Visit [https://storybook-v3.heroui.com](https://storybook-v3.heroui.com/) to view the storybook for all components.

## Roadmap

Visit [https://herouiv3.featurebase.app/roadmap](https://herouiv3.featurebase.app/roadmap) to view the roadmap for HeroUI v3.

## Figma

Visit [https://www.figma.com/community/file/1546526812159103429/heroui-figma-kit-v3](https://www.figma.com/community/file/1546526812159103429/heroui-figma-kit-v3) to view the Figma UI Kit for HeroUI v3.

## Community

We're excited to see the community adopt HeroUI, raise issues, and provide feedback.
Whether it's a feature request, bug report, or a project to showcase, please get involved!

- [Discord](https://discord.gg/9b6yyZKmH4)
- [X](https://x.com/hero_ui)
- [GitHub Discussions](https://github.com/heroui-inc/heroui/discussions)

## Contributing

Contributions are always welcome!

See [CONTRIBUTING.md](https://github.com/heroui-inc/heroui/blob/main/CONTRIBUTING.md) for ways to get started.

Please adhere to this project's [CODE_OF_CONDUCT](https://github.com/heroui-inc/heroui/blob/main/CODE_OF_CONDUCT.md).

## License

[MIT](https://choosealicense.com/licenses/mit/)
