<p align="center">
  <a href="https://tridentui.org">
      <img width="20%" src="https://raw.githubusercontent.com/tridentui-org/tridentui/main/apps/docs/public/isotipo.png" alt="tridentui" />
      <h1 align="center">TridentUI</h1>
  </a>
</p>
</br>
<p align="center">
  <a href="https://github.com/jrgarciadev/tridentui/blob/main/LICENSE">
    <img src="https://img.shields.io/apm/l/atomic-design-ui.svg?style=flat" alt="License">
  </a>
  <a href="https://codecov.io/gh/jrgarciadev/tridentui">
    <img src="https://codecov.io/gh/jrgarciadev/tridentui/branch/main/graph/badge.svg?token=QJF2QKR5N4" alt="codecov badge">
  </a>
  <a href="https://github.com/tridentui-org/tridentui/actions/workflows/main.yaml">
    <img src="https://github.com/tridentui-org/tridentui/actions/workflows/main.yaml/badge.svg" alt="CI/CD tridentui">
  </a>
  <a href="https://www.npmjs.com/package/@tridentui/react">
    <img src="https://img.shields.io/npm/dm/@tridentui/react.svg?style=flat-round" alt="npm downloads">
  </a>
</p>

<p align="center">
  <a rel="noopener noreferrer" target="_blank" href="https://www.vercel.com?utm_source=tridentui&utm_marketing=oss">
    <img height="34px" src="https://raw.githubusercontent.com/tridentui-org/tridentui/main/apps/docs/public/deployed-on-vercel.svg" alt="Deployed on vercel">
  </a>
</p>

> **NOTE:** This is a community project, not associated with [Vercel](https://vercel.com), but does get some inspiration from there.

## Getting Started

Visit <a aria-label="tridentui learn" href="https://tridentui.org/learn">https://tridentui.org/guide</a> to get started with TridentUI.

## Documentation

Visit [https://tridentui.org/docs](https://tridentui.org/docs) to view the full documentation.

## Quick Start

1. Installation: Inside your React project directory, install TridentUI by running either of the following:

```bash
yarn add @tridentui/react
# or
npm i @tridentui/react
```

2. Setup: For TridentUI to work correctly, you need to set up the CssBaseline at the root of your application.

Go to the root of your application and do this:

```jsx
import { NextUIProvider } from '@tridentui/react';

const Application = () => (
  <NextUIProvider>
    <AppComponent /> // ---> Your App Component
  </NextUIProvider>
);
```

3. Using TridentUI components: Once TridentUI is installed you can use any of the components as follows.
   TridentUI uses tree-shaking so the unused modules will not be included in the bundle during the build process and
   each component is exported separately.

```jsx
import { Button } from '@tridentui/react';

const Component = () => <Button>Click me</Button>;
```

4. TridentUI allows to manually import components if you need. E.g.

```jsx
import Button from '@tridentui/react/button';

const Component = () => <Button>Click me</Button>;
```

### Community

We're excited to see the community adopt TridentUI, 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)
- [Twitter](https://twitter.com/getnextui)
- [GitHub Discussions](https://github.com/tridentui-org/tridentui/discussions)

## Contributing

Contributions are always welcome!

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

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

## License

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