create-kola-monorepo

Create a new Kolaborate monorepo with modern full-stack architecture including Next.js 15, React Native (Expo), Convex real-time database, and Clerk authentication.

Quick Start

npx create-kola-monorepo my-project
cd my-project
yarn install
yarn dev

Features

• 🚀 Latest Tech Stack: Next.js 15, React 19, Expo SDK 52, TypeScript 5.7
• ⚡ Real-time Database: Convex for instant data synchronization
• 🔐 Authentication: Clerk with social logins (Google, Apple)
• 🎨 UI Components: shadcn/ui component library
• 📱 Multi-platform: Web and mobile applications
• 🤖 AI Ready: Optional OpenAI integration
• 🔧 Modern Tooling: Turborepo, ESLint 9, Prettier
• 🏗️ Scaffolding: Interactive CLI for generating new apps

Templates

Full Template (Default)

Complete monorepo with all packages and features:

• Next.js web application templates
• React Native mobile application templates
• Convex backend with database schema
• Shared UI component library
• Advanced scaffolding system

Minimal Template

Basic monorepo structure for custom development:

• Turborepo configuration
• Workspace setup
• Basic tooling configuration

Usage

Interactive Mode

npx create-kola-monorepo

Non-interactive Mode

npx create-kola-monorepo my-project --template full --package-manager yarn

Options

• --template <template>: Template to use (full or minimal)
• --package-manager <pm>: Package manager (yarn, npm, or pnpm)
• --skip-install: Skip installing dependencies
• --skip-git: Skip initializing git repository
• --latest: Use latest versions of all dependencies

What Gets Created

Full Template Structure

my-project/
├── apps/                    # Generated apps will appear here
├── packages/
│   ├── backend/            # Convex real-time database
│   ├── ui/                 # Shared shadcn/ui components
│   └── scaffold/           # App generation CLI
├── package.json            # Workspace configuration
├── turbo.json             # Turborepo setup
├── CLAUDE.md              # AI assistant guidance
└── README.md              # Project documentation

After Creation

1. Install dependencies:

   cd my-project
   yarn install

2. Generate your first app:

   yarn scaffold create-app

3. Start development:

   yarn dev

Generated App Capabilities

Next.js Web Apps

• React 19 with App Router and Turbopack
• Authentication pages and middleware
• Real-time dashboard components
• AI-powered features (optional)
• Responsive design with dark mode

React Native Mobile Apps

• Expo SDK 52 with New Architecture
• File-based routing with Expo Router
• OAuth authentication
• Real-time data synchronization
• Platform-specific styling

Shared Backend

• Type-safe Convex database
• Real-time subscriptions
• Authentication integration
• OpenAI API integration (optional)
• Serverless functions

Requirements

• Node.js 18.8.0 or later
• Package manager (yarn recommended)

Examples

# Create with full template and yarn
npx create-kola-monorepo my-startup --template full --package-manager yarn

# Create minimal setup with npm
npx create-kola-monorepo my-lib --template minimal --package-manager npm

# Skip git and dependency installation
npx create-kola-monorepo my-project --skip-git --skip-install

Learn More

• Turborepo Documentation
• Next.js Documentation
• Expo Documentation
• Convex Documentation
• Clerk Documentation

License

MIT