create-recurring-rabbit-app

A production-ready CLI tool that scaffolds an opinionated micro‑SaaS starter with TanStack Start, tRPC, Drizzle, Better-auth, and Tailwind CSS.

Current Version: v0.2.45 | Status: ✅ Production Ready - Ready for Public Launch

Quick Start

# Create a new project
npx @amirulabu/create-recurring-rabbit-app my-saas-app

# Navigate to project
cd my-saas-app

# Start development server
pnpm dev

What's Included

The generated starter includes everything you need to build a micro-SaaS:

• 🔐 Authentication - Email/password with email verification via Better-auth
• 🗄️ Database - SQLite (development) / PostgreSQL (production) with Drizzle ORM
• 🌐 Full-stack - TanStack Start with tRPC for end-to-end type safety
• 🎨 Styling - Tailwind CSS with shadcn/ui components
• ⚡ TypeScript - Strict mode with path aliases and comprehensive type safety
• 🔧 Developer Tools - Hot reload, ESLint, Prettier, bundle analyzer, performance monitoring
• 📦 CI/CD - GitHub Actions workflows for automated testing and validation
• 📝 Documentation - Comprehensive guides, ADRs, and JSDoc comments
• 🧪 Testing - Vitest integration with 30 passing tests

CLI Usage

npx @amirulabu/create-recurring-rabbit-app <project-name> [options]

Options:
  -h, --help     Display help
  -V, --version  Display version

Generated App Tech Stack

| Category | Technology | Purpose | | ------------------- | ----------------------- | -------------------------------------------------- | | Framework | TanStack Start | Full-stack React framework with file-based routing | | API | tRPC v11 | End-to-end type-safe APIs | | Database | Drizzle ORM | Type-safe database queries | | Auth | Better-auth | Authentication with email/password support | | Styling | Tailwind CSS v4 | Utility-first CSS framework | | UI Components | shadcn/ui | Accessible, customizable components | | Database (Dev) | SQLite + better-sqlite3 | Zero-config local database | | Database (Prod) | PostgreSQL | Production-ready database |

Project Structure

create-recurring-rabbit-app/
├── packages/
│   └── create-recurring-rabbit-stack/    # CLI tool
│       ├── bin/                           # CLI entry point
│       ├── src/                           # CLI source code
│       │   ├── commands/                  # CLI commands
│       │   └── utils/                     # CLI utilities
│       └── templates/                     # App templates
│           └── default/                   # Default template
│               ├── src/
│               │   ├── routes/           # TanStack Start routes
│               │   ├── server/           # tRPC + DB + Auth
│               │   ├── components/       # UI components
│               │   └── lib/              # Shared utilities
│               ├── docs/                 # Documentation
│               └── drizzle/              # Database migrations
├── specs/                                 # Feature specifications
├── IMPLEMENTATION_PLAN.md                 # Implementation status
└── README.md

Monorepo Commands

# Install dependencies
pnpm install

# Build CLI package
cd packages/create-recurring-rabbit-stack && pnpm build

# Run CLI in dev mode
pnpm dev [app-name]

# Typecheck all packages
pnpm typecheck

# Lint all packages
pnpm lint

# Format all files
pnpm format

Development

Building the CLI

cd packages/create-recurring-rabbit-stack
pnpm build

Running the CLI in Development Mode

pnpm dev my-test-app

Testing the Generated Template

After running the CLI:

cd my-test-app
npm install
npm run dev

Documentation

The generated app includes comprehensive documentation:

• Quick Start Guide - Get started with your new app
• Architecture Overview - System design and decisions
• Architecture Decision Records - Key technical decisions and rationale
• Adding Features - Common patterns and examples
• Deployment Guide - Platform-specific deployment instructions
• Database Schema - Complete schema documentation
• Troubleshooting - Common issues and solutions
• UI Components Reference - Available components and usage examples

Implementation Status

See IMPLEMENTATION_PLAN.md for detailed implementation progress.

Current Status: Phase 9 Complete - Ready for Public Launch ✅

Completed Phases:

• ✅ All specifications completed
• ✅ All JTBD requirements addressed
• ✅ Core features implemented (CLI, template, database, auth, tRPC, UI)
• ✅ TypeScript errors resolved
• ✅ Critical runtime issues fixed
• ✅ Integration testing complete
• ✅ Build & deployment testing complete
• ✅ CI/CD workflows configured
• ✅ Package publishing ready with provenance

Contributing

See CONTRIBUTING.md for contribution guidelines.

Jobs to Be Done

This tool is designed to help solo developers:

1. Bootstrap a micro‑SaaS quickly - Get a working full-stack baseline in days, not weeks
2. Avoid decision fatigue - One opinionated stack with one "right way" to start
3. Start with production-shaped architecture - Sensible defaults for structure, data access, auth boundaries
4. Eliminate "glue code" - End-to-end types between UI → API → DB
5. Get database + migrations right - Ready-to-run local dev DB with clear migration workflow
6. Have auth implemented correctly - Better-auth integrated without reinventing it

See JTBD.md for the complete Jobs to Be Done analysis.

License

MIT - See LICENSE file for details.

Related Projects

• TanStack Start - Full-stack React framework
• tRPC - End-to-end typesafe APIs
• Drizzle ORM - Type-safe SQL toolkit
• Better-auth - Authentication library
• shadcn/ui - Re-usable components built with Radix UI