Getting Started

NUI is a zero-dependency React UI library with powerful theming, CSS variable injection, and a component-per-folder architecture. 27+ components ready to use.

Zero Dependencies

Only react and react-dom as peer deps. No CSS-in-JS runtime.

Powerful Theming

10-shade color scales, dark mode, full CSS variable generation.

createUI() Factory

Isolated instances with their own context, theme, and CSS scope.

27+ Components

Buttons, inputs, cards, modals, tabs, toasts, and more.

Polymorphic Components

Render as any element with type-safe `as` prop.

Tree Shakeable

ESM + CJS dual output with sideEffects: false.

TypeScript First

Full type definitions for every component and hook.

Dark Mode Built-in

One toggle switches the entire theme via CSS variables.

Quick Start

tsx

import { createUI, Button } from "nui-react";

const { UIProvider } = createUI({
  theme: { primaryColor: "blue" }
});

function App() {
  return (
    <UIProvider>
      <Button>Click me</Button>
    </UIProvider>
  );
}