Installation
All OmniStack components are installed using the shadcn CLI. This page covers the installation process, requirements, and available components.
Requirements
| Dependency | Version |
|---|---|
| Node.js | 18+ |
| Next.js | 14+ |
| React | 18+ |
| TypeScript | 5+ |
| shadcn/ui | initialized |
Initialize shadcn/ui
If you haven't already, initialize shadcn/ui in your project. This sets up the component configuration and base styles:
Database Setup
Most components require a PostgreSQL database with Prisma ORM. Set up your database connection in your .env file:
DATABASE_URL="postgresql://user:password@localhost:5432/mydb"After installing a component, run npx prisma migrate dev to create the required database tables.
Available Components
Install any component using the shadcn CLI. Click on a component to view its full documentation and usage guide.
Complete authentication system with sign-in, sign-up, email verification, password reset, social auth (Google & GitHub), and session management. Built with Better Auth, Prisma, and Resend.
pnpm dlx shadcn@latest add https://better-auth-ui.desishub.com/r/auth-components.jsonFull-featured Stripe payment integration with checkout flow, order management, product grid, and cart powered by Zustand. Includes server-side API routes and auth-protected checkout.
pnpm dlx shadcn@latest add https://stripe-ui-component.desishub.com/r/stripe-ui-component.jsonMulti-provider file storage with drag-and-drop upload (5 variants), progress tracking, presigned URLs, file dashboard, and category management. Supports AWS S3 and Cloudflare R2.
pnpm dlx shadcn@latest add https://file-storage-registry.vercel.app/r/file-storage.jsonMulti-step form wizard with Zustand state management, step navigation, form validation with Zod, and progress tracking. Perfect for onboarding flows and complex forms.
pnpm dlx shadcn@latest add https://jb.desishub.com/r/multi-step-form.jsonReusable shopping cart powered by Zustand with localStorage persistence, product grid, quantity management, price calculations, and wishlist functionality.
pnpm dlx shadcn@latest add https://jb.desishub.com/r/zustand-cart.jsonProfessional work experience timeline component with support for multiple companies, positions, employment periods, skills tags, and expandable/collapsible sections.
pnpm dlx shadcn@latest add https://jb.desishub.com/r/work-experience.jsonTroubleshooting
shadcn CLI not found
Make sure you're using pnpm dlx, npx, or bunx to run the shadcn CLI. Example: pnpm dlx shadcn@latest add <url>
Prisma migration errors
Ensure your DATABASE_URL is correct and the PostgreSQL server is running. Run npx prisma generate after migrations.
Component conflicts
If a component installs files that conflict with existing ones, the CLI will prompt you. You can choose to overwrite or skip.