create-kuckit-app

Create a new Kuckit application with a single command.

Quick Start

npx create-kuckit-app my-app
cd my-app
bun run dev

Prerequisites

• Node.js 18+
• Bun package manager

Usage

npx create-kuckit-app <project-name> [options]

Options

• --skip-install - Skip running package manager install
• --template <template> - Template to use (default: base)

What's Included

The generated project includes:

• Monorepo structure with apps and packages
• Server - Express + oRPC API with Better-Auth
• Web - React + TanStack Router frontend
• Database - Drizzle ORM with PostgreSQL
• Kuckit SDK - Module system ready to go
• Example module - Items module with full Clean Architecture

Project Structure

my-app/
├── apps/
│   ├── server/     # Backend API
│   └── web/        # Frontend app
├── packages/
│   └── items-module/  # Example module
└── kuckit.config.ts

Next Steps

After creating your app:

1. Set up your database (see docker-compose.yml or use a cloud provider)
2. Configure environment: cp apps/server/.env.example apps/server/.env
3. Push schema: bun run db:push
4. Start development: bun run dev
5. Add modules: bunx kuckit add <module>

Deployment

Deploy to GCP with one command:

bun add -D @kuckit/infra-gcp
bunx kuckit infra up

See the Deployment Guide for details.

Documentation

• kuckit.dev - Full documentation
• Architecture

License

MIT