create-goon-app
The scaffolding CLI that creates a new indiegoon project. It activates your license, prompts for configuration, and gives you a complete working SaaS.
Usage
npx create-goon-app my-project-name
What It Does
- •Activates your license — validates your key online (or offline as fallback)
- •Prompts for configuration — database provider, optional features
- •Copies the template — with smart filtering based on your selections
- •Applies substitutions — replaces placeholders with your project name
- •Configures the manifest — writes
.goon/manifest.jsonwith your choices - •Creates
.env— from.env.exampleready for your secrets
Options
| Flag | Description | Example |
|---|---|---|
--key | License key | --key GOON-PR-ABCDEFGH-1234 |
--db | Database provider | --db neon |
--features | Comma-separated features | --features blog,admin,ai |
--yes / --defaults | Skip prompts (use defaults) | --yes |
Database Providers
| Provider | Value | Best For |
|---|---|---|
| Neon | neon | Serverless PostgreSQL (recommended) |
| Supabase | supabase | PostgreSQL + extras |
| PlanetScale | planetscale | MySQL-compatible |
| SQLite | sqlite | Local development, prototyping |
Feature Selection
During scaffolding, you choose which optional features to include:
| Feature | Tier Required | What You Get |
|---|---|---|
| Blog | Free | MDX engine, blog pages, components |
| Admin | Pro | Admin dashboard, user management |
| AI | Pro | AI API routes, OpenAI integration |
| Waitlist | Free | Landing page with email capture |
Features you don't select are excluded from the final project (directories removed, imports cleaned up).
License System
Key Format
GOON-XX-XXXXXXXX-XXXX
Where XX is the tier code:
- •
ST= Starter - •
PR= Pro - •
BN= Bundle
Activation Flow
- •CLI checks for cached license at
~/.indiegoon/license - •If no cache, prompts for key
- •Validates online via
POST https://indiegoon.dev/api/activate - •Falls back to offline validation if server is unreachable
- •Caches valid license locally
Machine Fingerprint
Licenses are tied to a machine fingerprint (SHA-256 hash of hostname + platform + username). This prevents key sharing while allowing reasonable use on your own machines.
Non-Interactive Mode
For CI/CD pipelines and AI agents:
npx create-goon-app my-saas \
--key GOON-PR-ABCDEFGH-1234 \
--db neon \
--features blog,admin \
--yes
Auto-detected when stdin is not a TTY (piped environments).
After Scaffolding
Once your project is created:
cd my-saas
npm install # Install dependencies
goon init # Configure all services
npm run db:push # Create database tables
npm run dev # Start development server
Next Steps
- •Quick Start — Configure services and start building
- •CLI Reference — The goon project CLI