Getting Started

radish-ui provides Tailwind CSS components for react-admin. Like shadcn/ui, you copy the components into your project and own them — no fighting library styles or peer-dependency conflicts.

Prerequisites

• Node.js 20+
• A react-admin project (or a new one you're starting)
• Tailwind CSS configured in your project

1. Initialize radish-ui

If you're adding radish-ui to an existing project, run:

npx @radish-ui/cli init

This creates a radish.json configuration file and sets up the default components directory. Continue to step 2 once that's done.

For a new project, scaffold everything at once with:

npx @radish-ui/cli new my-admin

2. Install the core package

pnpm add @radish-ui/core ra-core react react-dom

Or with npm / yarn:

npm install @radish-ui/core ra-core react react-dom
yarn add @radish-ui/core ra-core react react-dom

3. Add components with the CLI

Use npx to run the CLI without installing it globally:

# Add a single component
npx @radish-ui/cli add datagrid

# Add multiple components at once
npx @radish-ui/cli add layout datagrid list text-field

Components are copied into ./src/components/radish/ by default (configurable via --target or a radish.json file).

A radish.lock.json file is created to track which registry version each file came from.

4. Wire up your Admin

import { Admin } from "@radish-ui/core";
import { dataProvider } from "./dataProvider";

export default function App() {
  return <Admin dataProvider={dataProvider}>{/* your resources */}</Admin>;
}

5. Keep components up to date

# Update unmodified components to the latest registry versions
# (files you've customized are left untouched)
npx @radish-ui/cli sync

# Force-overwrite all components regardless of local changes
npx @radish-ui/cli sync --force

6. See upstream changes before syncing

npx @radish-ui/cli diff datagrid

Next steps

• Browse Available Components to see what's in the registry
• Read the CLI Reference for all available commands and options
• Set up a Configuration file to avoid repeating flags
• Customize display strings or add a new language with the Localization guide