Back to Home

Quick Start

Install PropelKit with npx create-propelkit, choose your tier, and start building.

PropelKit is a production-ready SaaS boilerplate with an AI project manager built in. Instead of wiring together auth, payments, emails, and databases yourself, you describe what you want to build and PropelKit's AI PM creates a tailored roadmap, generates code, and builds your product phase by phase.

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript (strict mode)
  • Database: Supabase (PostgreSQL + Auth + RLS)
  • Payments: Stripe (international) + Razorpay (India)
  • Email: Resend (transactional)
  • Background Jobs: Inngest (async tasks, event-driven)
  • UI: shadcn/ui + Tailwind CSS
  • AI PM: Claude Code (Pro tier)

What's Included Out of the Box

  • Authentication (email/password, magic link, OAuth)
  • Subscription billing (Stripe and/or Razorpay)
  • Admin dashboard with user management
  • Row-level security on all database tables
  • Transactional email templates
  • Background job queue
  • SEO meta tags and JSON-LD
  • 50+ shadcn/ui components pre-installed

Optional Features (Toggle On/Off)

  • Multi-tenancy (organizations, teams, roles)
  • Credits system (usage-based billing)
  • GST invoicing (India tax compliance)
  • Lovable UI integration (AI-generated frontend)
  • Demo mode (try without external services)

Installation

Terminal
npx create-propelkit

This launches an interactive CLI wizard that:

  • Validates your license key — Determines if you're on the Starter or Pro tier
  • Detects installed tools — Checks for Claude Code, Supabase CLI, GitHub CLI, Stripe CLI
  • Configures payments — Choose between Stripe, Razorpay, or both with auto-routing
  • Asks about UI — Use Lovable for AI-generated designs, bring existing designs, or skip
  • Clones the repo — Sets up the project in a new directory
  • Launches your tier-specific flow — Setup wizard (Starter) or AI PM (Pro)

Prerequisites

  • Node.js 18+ — Required (runtime)
  • Claude Code — Pro only (AI PM runs inside Claude Code)
  • Supabase CLI — Optional (auto-runs migrations; without it, you paste SQL manually)
  • GitHub CLI — Optional (auto-creates repo and pushes code)
  • Stripe CLI — Optional (local webhook testing for Stripe payments)

Two Tiers: Starter & Pro

Starter Tier

For developers who want a solid boilerplate and will build on their own.

What happens during setup:

  • CLI validates your Starter license
  • Setup wizard asks 5 questions: brand name, tagline, support email, primary color (hex, default: #0ea5e9), dark mode default (yes/no)
  • Updates src/config/brand.ts with your answers
  • Generates .env.local with placeholder values
  • Done — run npm install && npm run dev

What you get: a fully configured boilerplate with all features pre-wired. You build from here using your own workflow.

Pro Tier

For developers who want an AI project manager to plan and build their product.

What happens during setup:

  • CLI validates your Pro license
  • Payment processor selection (Stripe / Razorpay / Both)
  • Optional: provide API keys now or let AI PM generate .env template later
  • Lovable UI choice (generate new / have existing / skip)
  • Claude Code launches automatically with /propelkit:new-project
  • AI PM takes over — asks about your project, creates a roadmap, and starts building

What you get: everything in Starter, plus an AI PM that deeply understands your project, a phased roadmap derived from your requirements, automated code generation with atomic commits, Lovable UI integration with intelligent prompt generation, and progress tracking with session continuity.