@moduix/react-tailwind

React components built on Ark UI, styled with Tailwind CSS v4. Compose components from flat named parts using native React props and events.

Quick start · Components · Styling

Install

Start from an existing application using React 18 or 19. Tailwind CSS v4 must already be configured in the application.

Install moduix and its matching Ark UI peer dependency:

pnpm add @moduix/react-tailwind @ark-ui/react

Import components from subpaths such as @moduix/react-tailwind/accordion; there is no package-root export. Only the optional Chart integration requires an additional peer: pnpm add @tanstack/charts.

Add styles

In your global stylesheet, load the foundation before Tailwind and register the package's utilities:

@import '@moduix/react-tailwind/style.css';
@import 'tailwindcss';

@source '../node_modules/@moduix/react-tailwind/dist/components';

Import this stylesheet once in your application entry point. Resolve @source relative to the stylesheet; the example assumes src/styles.css. Tailwind ignores node_modules by default. Keep Tailwind Preflight enabled and do not add the moduix reset.

Use a component

import {
  Accordion,
  AccordionItem,
  AccordionItemBody,
  AccordionItemContent,
  AccordionItemIndicator,
  AccordionItemTrigger,
} from '@moduix/react-tailwind/accordion';

export function Example() {
  return (
    <Accordion defaultValue={['first']}>
      <AccordionItem value="first">
        <AccordionItemTrigger>
          First item
          <AccordionItemIndicator />
        </AccordionItemTrigger>
        <AccordionItemContent>
          <AccordionItemBody>First content</AccordionItemBody>
        </AccordionItemContent>
      </AccordionItem>
    </Accordion>
  );
}

The family name is the root component. Each additional part is a separate family-prefixed export. The setup is working when the trigger is styled and the panel opens with keyboard and pointer input.

Customize

Pass utility classes through className on the root or a named part. Classes are merged with tailwind-merge, so p-0 can replace the default padding. Override shared CSS tokens to change colors, spacing, typography, or motion.

The optional presets are dense, soft, and contrast. See Themes for imports and activation, and Tokens for available CSS properties.

Own the source

Configure components.json and aliases with the registry setup, then add a component:

pnpm dlx shadcn@latest add @moduix-react-tailwind/accordion

The CLI copies native React source, styles, and dependencies into your project. Follow Quick Start to connect the generated foundation stylesheet. The same namespace also installs blocks, for example @moduix-react-tailwind/login-simple.

Compatibility

The package is ESM-only and ships JavaScript targeting ES2023. Use an application bundler that supports package CSS imports. See the framework guides for entry files, aliases, and SSR integration.

Links

• Documentation
• npm package
• Source repository
• Issues

License

MIT