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.jsonfile and thecnhelper).
Steps
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 "@/*"Step 2: Make sure Tailwind CSS v4 is set up
create-next-appwith--tailwindalready does this. Add it to an existing project.Step 3: Set up shadcn
This creates
components.json, the theme variables and thecnhelper. Choose Radix or Base UI; VenusUI works with both. Details.npx shadcn@latest initStep 4: Install a component
Install any item by name. No other setup needed:
npx shadcn@latest add @venusui/animated-cardOr use its full address, which also works with older versions of the shadcn CLI:
npx shadcn@latest add https://venusui.com/r/animated-card.jsonStep 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.