Installation

Add GenUI systems to your project using the registry.

GenUI is registry-based. You do not install a package. Instead, you pull the system code into your app with the shadcn CLI. The files are copied into your project so you can customize them directly.

1. Prerequisites

  • A Next.js project with Tailwind CSS.
  • The shadcn/ui base initialized in your project.
npx shadcn@latest init

2. Add A System

Pull a system from the registry. Example: Generic Form.

npx shadcn@latest add https://gen-ui-eta-two.vercel.app/r/generic-form

This will add files under components/systems and wire up the required shadcn/ui primitives.

3. If You Hit Peer Dependency Conflicts

Some ecosystems have strict peer deps. If you see install errors, enable legacy peer deps and retry:

npm config set legacy-peer-deps true

Registry Systems

SystemRegistry URL
Generic Form/r/generic-form
Generic Table/r/generic-table
Generic Renderer/r/generic-renderer
Generic Grid/r/generic-grid
Generic List/r/generic-list
Action System/r/action-system
App Layout/r/app-layout
State Boundary/r/state-boundary
Motion System/r/motion

Importing

After adding a system, import it from the generated path:

import { GenericForm } from "@/components/systems/generic-form/generic-form"

Quickstart

  1. Pick a system from the list above.
  2. Run the registry add command.
  3. Follow the system docs for configuration and examples.

Suggested next stop: Generic Form.

← Previous: IntroductionNext: Generic Form →