create-opc-app

CLI scaffolding tool for creating full-stack monorepo projects with Next.js 16 + NestJS 11 + PostgreSQL.

Usage

npx create-opc-app my-project

With options

npx create-opc-app my-project --orm drizzle --storage s3 --i18n en,zh-cn,ja

Skip interactive prompts

npx create-opc-app my-project --defaults

CLI Options

| Option | Default | Description | |--------|---------|-------------| | <name> | (required) | Project name (kebab-case) | | --orm | prisma | ORM: prisma or drizzle | | --storage | local | Storage provider: local, gcs, s3, oss, cos | | --i18n | en,zh-cn | Comma-separated locale list | | --defaults | — | Skip interactive prompts, use all defaults |

What You Get

A production-ready monorepo with:

• Frontend: Next.js 16 (App Router) + React 19 + Tailwind CSS 4 + shadcn/ui (Base UI)
• Backend: NestJS 11 + PostgreSQL + Prisma/Drizzle + better-auth
• Modules: Auth, User, UserProfile, Posts (sample CRUD)
• Infrastructure: Email (SMTP+SES), File Storage (multi-provider), Redis, Sentry — all with graceful degradation
• DevOps: Docker, GitHub Actions CI, Biome + Lefthook
• Testing: Vitest + example tests for both frontend and backend
• i18n: next-intl with configurable locales
• AI-Ready: Comprehensive AGENTS.md for AI agent development

Built-in Services (Graceful Degradation)

All optional services work without configuration — they gracefully degrade when credentials are not provided:

| Service | Without Config | |---------|---------------| | Redis | Queues disabled, email sent synchronously | | Email (SMTP/SES) | Send operations logged and skipped | | File Storage | Upload endpoints return 501 | | Sentry | Errors logged to console only | | Social Auth | Social login buttons hidden |

Development

# Install dependencies
pnpm install

# Build CLI
pnpm build

# Test locally
node dist/index.js my-test-project --defaults

License

MIT