CLI Reference

Commands

Command	Description
`questpie generate`	Scan file conventions, generate types and factories
`questpie dev`	Watch mode -- auto-regenerate on file changes

Command	Description
`questpie push`	Push schema to database (no migrations)
`questpie migrate:generate`	Generate migration from schema diff
`questpie migrate:up`	Run pending migrations
`questpie migrate:down`	Rollback last migration
`questpie migrate:fresh`	Drop all tables and re-run migrations
`questpie migrate:reset`	Reset migration tracking
`questpie migrate:status`	Show migration status

Command	Description
`questpie add [type] [name]`	Scaffold a new entity or module

# With bunx (recommended)
bunx questpie <command>

# Or via package.json scripts
bun run questpie <command>

Scans your project for file conventions (collections, globals, routes, jobs, services, emails, fields, views, pages, widgets, etc.) and generates:

#questpie imports -- typed factory functions with all registered field types
#questpie/factories -- admin-specific factories (sidebar, dashboard, branding, locale)
Type registry -- merged types for collections, globals, routes, and services

Run this after adding or removing any convention file.

bunx questpie generate

Watch mode that re-runs codegen whenever a convention file changes. Use during development.

bunx questpie dev

Push the current Drizzle schema directly to the database without creating migration files. Useful during early development.

bunx questpie push

This may cause data loss. Use only in development.

Compare the current schema against the database and generate a SQL migration file.

bunx questpie migrate:generate

Run all pending migrations.

bunx questpie migrate:up

Rollback the last applied migration.

bunx questpie migrate:down

Drop all tables and re-run all migrations from scratch.

bunx questpie migrate:fresh

Destroys all data. Development only.

Show which migrations have been applied and which are pending.

bunx questpie migrate:status

Reset the migration tracking table without touching data tables.

bunx questpie migrate:reset

Run all pending seed files in order.

bunx questpie seed

Generate a new timestamped seed file.

bunx questpie seed:generate

Scaffold a new entity. Interactively prompts for type and name if not provided.

# Interactive
bunx questpie add

# With arguments
bunx questpie add collection posts
bunx questpie add global siteSettings

The CLI reads questpie.config.ts from the project root:

questpie.config.ts

export { default } from "./src/questpie/server/questpie.config";

runtimeConfig({
  cli: {
    migrations: {
      directory: "./src/migrations",
    },
    seeds: {
      directory: "./src/seeds",
    },
  },
});