@wheelhouse/ui

React components (Base UI + shadcn-style patterns) with Tailwind CSS v4, bundled as ESM with TypeScript declarations.

Install

npm install @wheelhouse/ui

Peer dependencies (install if your app does not already satisfy them):

npm install react react-dom @base-ui/react tailwindcss

@wheelhouse/tokens is a normal dependency of this package—you do not need to install it unless you import tokens directly.

Styles

In your CSS entry:

@import '@wheelhouse/ui/globals.css';

If your app uses Tailwind CSS v4, add a @source so Tailwind scans the published bundle for class names (skip this if you are not using Tailwind—@source is Tailwind-only):

@source '../node_modules/@wheelhouse/ui/dist';

Point @source at node_modules/@wheelhouse/ui/dist using a path that resolves from your CSS file.

Components

Prefer subpath imports so your app only loads the modules (and dependencies) you use:

import { Button } from '@wheelhouse/ui/components/button';
import { Filters } from '@wheelhouse/ui/components/filters';
import { DateSelector } from '@wheelhouse/ui/blocks/date-selector';
import { useMediaQuery } from '@wheelhouse/ui/hooks';
import { cn } from '@wheelhouse/ui/lib/utils';

The root barrel remains supported for compatibility:

import { Button } from '@wheelhouse/ui';

New code should use subpaths. See package.json → exports for available entry points (components, blocks, hooks, lib/utils, and CSS files).

Monorepo

Storybook, the shadcn CLI, workspace commands, and publishing are documented in the repository's root README.