CLI Overview

StackKit provides four commands that cover the full lifecycle of project creation and maintenance.

StackKit is a command-line tool. You don't need to install it globally — npx always fetches the latest version when you need it.

npx stackkit@latest <command>

Using npx stackkit@latest ensures you always run the most current version. If you prefer faster startup, you can install it globally with npm install -g stackkit.

Commands at a glance

Command	What it does
`create`	Scaffold a brand-new project from a template
`add`	Add a module (database, auth, etc.) to an existing project
`list`	Show all available frameworks and modules
`doctor`	Diagnose your project and catch configuration issues

`create`

Start a new project from scratch. StackKit walks you through choosing a framework, modules, language, and package manager.

npx stackkit@latest create my-app

You can also skip the prompts and use flags:

npx stackkit@latest create my-app \
  --framework nextjs \
  --database prisma-postgresql \
  --auth better-auth

→ Full create reference

`add`

Add a module to an existing StackKit project (or any compatible project). StackKit detects your framework automatically and shows you what's available.

npx stackkit@latest add

You can also specify what to add directly:

npx stackkit@latest add database --provider prisma-postgresql

→ Full add reference

`list`

See everything StackKit supports — frameworks, modules, and their compatibility.

npx stackkit@latest list

Filter to just what you need:

npx stackkit@latest list --frameworks
npx stackkit@latest list --modules

→ Full list reference

`doctor`

Check that your project is set up correctly. Doctor verifies your Node.js version, environment variables, configuration files, and installed modules.

npx stackkit doctor

→ Full doctor reference

Global options

Flag	Description
`--help`	Print help text for a command
`--version`	Print the installed StackKit version

Common workflows

Start a new project interactively

npx stackkit@latest create my-app
# Answer the prompts, then:
cd my-app
cp .env.example .env
npm run dev

Start with defaults (Next.js + Better Auth)

npx stackkit@latest create my-app --yes

Add a database to an existing project

cd existing-project
npx stackkit@latest add
# Select Database → Prisma → PostgreSQL

Check what went wrong

npx stackkit doctor

On this page