Welcome to Solo Kit Documentation

Solo Kit is a modern React SaaS starter kit designed for production-ready full-stack applications with web and mobile platforms sharing code.

Quick Start

Get started with Solo Kit in minutes:

# Clone the repository
git clone <repository-url>

# Install dependencies
pnpm install

# Set up PostgreSQL database and add DATABASE_URL to .env.local
# Initialize database
pnpm db:push

# Start development server
pnpm dev

Architecture Overview

Solo Kit uses a monorepo structure with the following key components:

• Web App (/apps/web) - Next.js 15 with App Router
• Mobile App (/apps/mobile) - Expo React Native
• Shared UI (/packages/ui) - shadcn/ui components
• Utilities (/packages/utils) - Platform-agnostic functions
• Database (/packages/database) - Drizzle ORM layer

Feature Flags

The project uses build-time feature flags for production-ready development:

• Database: PostgreSQL-first with providers like Neon, Supabase, Railway
• Auth: BetterAuth with secure defaults
• Email: Console logging → Production providers
• Payments: Mock → Stripe integration

Next Steps

• Getting Started
• Architecture Guide
• Development Guide
• Deployment