NextUI

Beautiful, fast and modern React UI library.

README


NextUI


codecov badge CI/CD nextui npm downloads

NOTE:This is a community project, not associated with Vercel , but does get some inspiration from there.


Getting Started


Visit https://nextui.org/guide to get started with NextUI.

Documentation


Visit https://nextui.org/docs to view the full documentation.

Quick Start


Installation: Inside your React project directory, install NextUI by running either of the following:

  1. ``` shell
  2. yarn add @nextui-org/react
  3. # or
  4. npm i @nextui-org/react
  5. ```

Setup: For NextUI to work correctly, you need to set up the NextUIProviderat the root of your application.

Go to the root of your application and do this:

  1. ``` js
  2. import {NextUIProvider} from '@nextui-org/react';

  3. const Application = () => (
  4.   <NextUIProvider>
  5.     <AppComponent /> // ---> Your App Component
  6.   </NextUIProvider>
  7. );
  8. ```

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

  1. ``` js
  2. import {Button} from '@nextui-org/react';

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

NextUI allows to manually import components if you need. E.g.

  1. ``` js
  2. import Button from '@nextui-org/react/button';

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

Community


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


Contributing


Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's CODE_OF_CONDUCT .

License