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 (format: GOON-XX-XXXXXXXX-XXXX)
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 GOON-PR-ABCDEFGH-1234 \
  --db neon \
  --features blog,admin \
  --yes

Install the Project CLI

After scaffolding, install the goon CLI globally (optional but recommended):

npm install -g goon

Or use it via npx:

npx goon setup payments

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