Skip to content
VenusUI
Get started
Docs

Installation

Set up a project for VenusUI components and install your first one.

Requirements

  • Node.js 20.9 or later (required by Next.js 16).
  • React 19 and Tailwind CSS v4.
  • A project set up with shadcn (a components.json file and the cn helper).

Steps

  1. Step 1: Create a Next.js app

    Skip this if you already have one. Full guide.

    npx create-next-app@latest my-app --ts --tailwind --eslint --app --src-dir --import-alias "@/*"
  2. Step 2: Make sure Tailwind CSS v4 is set up

    create-next-app with --tailwind already does this. Add it to an existing project.

  3. Step 3: Set up shadcn

    This creates components.json, the theme variables and the cn helper. Choose Radix or Base UI; VenusUI works with both. Details.

    npx shadcn@latest init
  4. Step 4: Install a component

    Install any item by name. No other setup needed:

    npx shadcn@latest add @venusui/animated-card

    Or use its full address, which also works with older versions of the shadcn CLI:

    npx shadcn@latest add https://venusui.com/r/animated-card.json
  5. Step 5: Use it

    Import it from your components folder, e.g. import { AnimatedCard } from "@/components/ui/animated-card". Every component page shows the exact import, files and usage.