Getting Started

Installation

All OmniStack components are installed using the shadcn CLI. This page covers the installation process, requirements, and available components.

Requirements

DependencyVersion
Node.js18+
Next.js14+
React18+
TypeScript5+
shadcn/uiinitialized

Initialize shadcn/ui

If you haven't already, initialize shadcn/ui in your project. This sets up the component configuration and base styles:

terminal
$ pnpm dlx shadcn@latest init

Database Setup

Most components require a PostgreSQL database with Prisma ORM. Set up your database connection in your .env file:

.env
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.

JB Better Auth UIAuthentication

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.json

Full-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.json

Multi-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.desishub.com/r/file-storage.json

Multi-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.json
Zustand CartE-Commerce

Reusable 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.json
Work ExperienceUI Components

Professional 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.json
GritFrameworks

Full-stack meta-framework that fuses a Go backend (Gin + GORM) with a Next.js + React frontend in a single monorepo. One CLI command scaffolds JWT auth, a Filament-like admin panel, GORM Studio, Docker Compose (PostgreSQL, Redis, MinIO, Mailhog), file storage, email, background jobs, cron, caching, and AI integration. Includes a code generator that creates Go models, API handlers, React Query hooks, Zod schemas, and admin pages all at once.

go install github.com/MUKE-coder/grit/cmd/grit@latest
GORM StudioDatabase

A Prisma Studio-like visual database browser and editor for Go applications using GORM. Browse schemas, manage data with full CRUD, run SQL queries, export ERD diagrams (PNG/PDF), import/export data in multiple formats (JSON, CSV, SQL, Excel, DBML, YAML), and generate Go model code — all from a single studio.Mount() call embedded in your Gin application.

go get github.com/MUKE-coder/gorm-studio/studio
SentinelSecurity

Production-grade security intelligence SDK for Go applications. Drop-in Gin middleware that provides WAF protection, rate limiting, threat detection, audit logging, anomaly detection, AI-powered analysis (Claude/OpenAI/Gemini), compliance reports (GDPR, PCI-DSS, SOC 2), and an embedded React dashboard with 13 pages — all mountable with a single sentinel.Mount() call.

go get github.com/MUKE-coder/sentinel
Gin DocsDocumentation

Zero-annotation API documentation generator for Go applications using Gin and GORM. Automatically introspects your router tree, reads struct tags via reflection, generates a full OpenAPI 3.1 spec, and serves interactive Swagger UI or Scalar documentation — all with a single gindocs.Mount() call. Supports GORM model variants (Create/Update schemas), fluent route overrides, Postman/Insomnia export, and JWT/API key auth in the Try It panel.

go get github.com/MUKE-coder/gin-docs
PulseMonitoring

Self-hosted observability and performance monitoring SDK for Go applications built with Gin and GORM. Provides request tracing, database query monitoring, runtime metrics, error tracking with stack traces, health checks, threshold-based alerting (Slack, Discord, email, webhook), Prometheus export, and an embedded React dashboard — all from a single pulse.Mount() call with zero external dependencies.

go get github.com/MUKE-coder/pulse
Offline SyncUI Components

Offline-first data sync architecture with IndexedDB (Dexie) for instant local writes, Prisma for server sync, conflict detection with version tracking, smart retry with exponential backoff, soft deletes, and PWA support. One command adds 12 files for a complete offline-first data layer.

pnpm dlx shadcn@latest add https://offline-sync.desishub.com/r/offline-sync.json

Troubleshooting

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.