Installation

Prerequisites

Before you begin, make sure you have:

• •Node.js 18.17+ - download here
• •PostgreSQL - locally or via Neon / Supabase (recommended)
• •A license key - get one at indiegoon.dev

Create Your Project

Run the scaffolding CLI:

npx create-goon-app my-saas

You'll be prompted to:

1. •Enter your license key (from your purchase confirmation email)
2. •Choose a database provider - Neon (recommended), Supabase, PlanetScale, or SQLite
3. •Select optional modules - Blog, AI routes, Admin dashboard, Waitlist

The CLI will create your project, install dependencies, and set up the initial configuration.

Non-Interactive Mode

For CI/CD or AI agents, skip the prompts:

npx create-goon-app my-saas \
  --key YOUR_LICENSE_KEY \
  --db neon \
  --features blog,admin \
  --yes

The goon CLI

The goon CLI is built into every scaffolded project. There is no separate package to install globally. After npm install, the CLI is available as a local binary:

npx goon setup payments

You can also run goon directly since it is registered in your project's package.json bin field.

Verify Installation

Navigate to your project and start the dev server:

cd my-saas
npm run dev

Open http://localhost:3000. You should see the marketing landing page.

What Just Happened?

The scaffolder created a complete Next.js project with:

my-saas/
├── src/
│   ├── app/           # Pages and API routes
│   ├── components/    # UI + marketing components
│   ├── config/        # App configuration
│   └── lib/           # Auth, DB, payments, email
├── content/           # Blog MDX files
├── drizzle/           # Database migrations
├── tests/             # E2E tests
├── .env               # Environment variables
├── .goon/             # CLI manifest and rules
└── package.json

Next Steps

• •Quick Start - Configure your services and get everything running
• •Project Structure - Understand the architecture in detail