Installation
How to install and configure Liminal UI in your project
Installation
Get started with Liminal UI in your React project.
Prerequisites
Before you begin, make sure you have:
- Node.js 18+ installed
- A React 18+ project (Next.js, Vite, Create React App, etc.)
- Tailwind CSS configured
Install the CLI
First, install the Liminal UI CLI globally:
npm install -g @liminal-ui/cli
Or use it directly with npx:
npx @liminal-ui/cli init
Initialize Your Project
Navigate to your project directory and run:
liminal init
This will:
- Create a
components.jsonconfiguration file - Set up your component and utility directories
- Configure path aliases
You'll be asked a few questions:
- TypeScript: Are you using TypeScript? (Yes/No)
- RSC: Are you using React Server Components? (Yes/No)
- Components Path: Where to install components (default:
src/components/ui) - Utils Path: Where to install utilities (default:
src/lib)
Add Components
Once initialized, you can start adding components:
liminal add button
This will:
- Copy the component source code to your project
- Install required dependencies automatically
- Set up any utility functions needed
Manual Installation
If you prefer not to use the CLI, you can manually copy components from our GitHub repository.
Next Steps
- Browse available components
- Learn about theming and customization
- Check out examples