create-newt-app 0.23.0 → 0.23.2

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
-type Testing = 'jest' | 'vitest';
-type Database = 'sqlite' | 'postgres';
-type Linter = 'eslint' | 'oxc';
-type Deployment = 'none' | 'standalone' | 'custom-server' | 'spa';
+declare const TESTING_CHOICES: readonly ["jest", "vitest"];
+declare const DATABASE_CHOICES: readonly ["sqlite", "postgres"];
+declare const LINTER_CHOICES: readonly ["eslint", "oxc"];
+declare const DEPLOYMENT_CHOICES: readonly ["none", "standalone", "custom-server", "spa"];
+type Testing = (typeof TESTING_CHOICES)[number];
+type Database = (typeof DATABASE_CHOICES)[number];
+type Linter = (typeof LINTER_CHOICES)[number];
+type Deployment = (typeof DEPLOYMENT_CHOICES)[number];
 type Options = {
     name?: string;
     install: boolean;

package/dist/index.js

@@ -7,7 +7,7 @@ import chalk from "chalk";
 // package.json
 var package_default = {
   name: "create-newt-app",
-  version: "0.23.0",
+  version: "0.23.2",
   license: "MIT",
   private: false,
   type: "module",
@@ -10183,12 +10183,11 @@ var api_package_json_default = {
   "private": true,
   "license": "UNLICENSED",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./dist/index.js"
   },
   "scripts": {
     "build": "nest build",
     "start": "nest start",
-    "dev": "nest start --watch",
     "start:dev": "nest start --watch",
     "start:debug": "nest start --debug --watch",
     "start:prod": "node dist/main"
@@ -10251,6 +10250,8 @@ async function main() {
   await nextApp.prepare();
 
   const nestApp = await NestFactory.create(AppModule);
+  // apps/api/src/main.ts never runs here, so its prefix is set again
+  nestApp.setGlobalPrefix('api');
   await nestApp.init();
 
   const nestListener = nestApp
@@ -10283,14 +10284,15 @@ var web_package_json_default = {
   "private": true,
   "scripts": {
     "dev": "tsx watch --tsconfig tsconfig.server.json server.ts",
-    "build": "next build",
-    "start": "next start",
+    "build": "next build && tsc -p tsconfig.server.json",
+    "start": "node dist/server.js",
     "db:migrate": "better-auth migrate"
   },
   "dependencies": {
     "@<%= projectName %>/api": "workspace:*",
     "@<%= projectName %>/auth": "workspace:*",
     "@<%= projectName %>/ui": "workspace:*",
+    "@nestjs/core": "^11.0.1",
     "@tailwindcss/postcss": "^4.2.1",
     "dotenv": "^17.3.1",
     "@tanstack/react-form": "^1.28.5",
@@ -10299,6 +10301,7 @@ var web_package_json_default = {
     "next": "16.2.10",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
+    "reflect-metadata": "^0.2.2",
     "tailwindcss": "^4.2.1"
   },
   "devDependencies": {
@@ -10322,10 +10325,10 @@ import { resolve } from 'path';
 dotenv.config({ path: resolve(process.cwd(), '../../.env') });
 dotenv.config({ path: resolve(process.cwd(), '.env') });
 
+// No output setting: server.ts is the server, so Next runs in-process rather
+// than through its own standalone entrypoint.
 /** @type {import('next').NextConfig} */
-const nextConfig = {
-  output: "standalone",
-};
+const nextConfig = {};
 
 export default nextConfig;`
 };
@@ -10362,8 +10365,9 @@ var web_tsconfig_server_default = {
   filename: "apps/web/tsconfig.server.json",
   template: `{
   "compilerOptions": {
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
     "target": "ES2023",
     "esModuleInterop": true,
     "emitDecoratorMetadata": true,
@@ -10378,6 +10382,42 @@ var web_tsconfig_server_default = {
 }`
 };
 
+// src/templates/single-process-custom-server/templates/turbo-json.ts
+var turbo_json_default3 = {
+  filename: "turbo.json",
+  template: `{
+  "$schema": "https://turborepo.dev/schema.json",
+  "ui": "tui",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": ["$TURBO_DEFAULT$", ".env*"],
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
+    },
+    "lint": {
+      "dependsOn": ["^lint"],
+      "env": ["NODE_ENV"]
+    },
+    "test": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "dev": {
+      "dependsOn": ["^migrate", "^build"],
+      "cache": false,
+      "persistent": true
+    },
+    "migrate": {
+      "dependsOn": ["^migrate"],
+      "cache": false
+    },
+    "generate": {
+      "cache": false
+    }
+  }
+}`
+};
+
 // src/templates/single-process-custom-server/index.ts
 var singleProcessCustomServer = {
   templates: [
@@ -10387,38 +10427,12 @@ var singleProcessCustomServer = {
     web_package_json_default,
     web_next_config_default,
     web_tsconfig_default,
-    web_tsconfig_server_default
+    web_tsconfig_server_default,
+    turbo_json_default3
   ]
 };
 var single_process_custom_server_default = singleProcessCustomServer;
 
-// src/templates/single-process-static-export/templates/api-app-module.ts
-var api_app_module_default = {
-  filename: "apps/api/src/app.module.ts",
-  template: `import { join } from 'path';
-import { Module } from '@nestjs/common';
-import { APP_GUARD } from '@nestjs/core';
-import { ServeStaticModule } from '@nestjs/serve-static';
-import { AuthGuard, AuthModule } from '@thallesp/nestjs-better-auth';
-import { auth } from '@<%= projectName %>/auth';
-import { AppController } from './app.controller';
-import { TodosModule } from './todos/todos.module';
-
-@Module({
-  imports: [
-    ServeStaticModule.forRoot({
-      rootPath: join(process.cwd(), '../web/out'),
-      exclude: ['/api/(.*)'],
-    }),
-    AuthModule.forRoot({ auth }),
-    TodosModule,
-  ],
-  controllers: [AppController],
-  providers: [{ provide: APP_GUARD, useClass: AuthGuard }],
-})
-export class AppModule {}`
-};
-
 // src/templates/single-process-static-export/templates/api-package-json.ts
 var api_package_json_default2 = {
   filename: "apps/api/package.json",
@@ -10500,7 +10514,7 @@ export default nextConfig;`
 
 // src/templates/single-process-static-export/index.ts
 var singleProcessStaticExport = {
-  templates: [api_app_module_default, api_package_json_default2, web_next_config_default2]
+  templates: [api_package_json_default2, web_next_config_default2]
 };
 var single_process_static_export_default = singleProcessStaticExport;
 
@@ -10732,6 +10746,126 @@ var nestDiOnly = {
 };
 var nest_di_only_default = nestDiOnly;
 
+// src/templates/deployment-standalone-di/templates/dockerfile.ts
+var dockerfile_default2 = {
+  filename: "Dockerfile",
+  template: `FROM node:22-alpine AS base
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable
+
+FROM base AS build
+WORKDIR /app
+COPY . .
+RUN pnpm install --frozen-lockfile
+RUN pnpm build --filter=web --filter=api --filter=@<%= projectName %>/auth
+
+# --- web ---
+# DI-only has no api entrypoint: Nest is wired into this image through the
+# Next.js server, so there is no separate api stage.
+FROM base AS web
+WORKDIR /app
+ENV NODE_ENV=production
+COPY --from=build /app/apps/web/.next/standalone ./
+COPY --from=build /app/apps/web/.next/static ./apps/web/.next/static
+COPY --from=build /app/apps/web/public ./apps/web/public
+EXPOSE 3000
+CMD ["node", "apps/web/server.js"]
+
+# --- migrate ---
+FROM build AS migrate
+WORKDIR /app
+CMD ["pnpm", "db:migrate"]`
+};
+
+// src/templates/deployment-standalone-di/templates/docker-compose.ts
+var docker_compose_default2 = {
+  filename: "docker-compose.yml",
+  template: `x-app-env: &app-env
+  BETTER_AUTH_SECRET: \${BETTER_AUTH_SECRET}
+  DATABASE_URL: postgresql://postgres:\${POSTGRES_PASSWORD:-postgres}@db:5432/postgres
+
+services:
+  web:
+    build:
+      context: .
+      target: web
+    ports:
+      - "3000:3000"
+    environment:
+      <<: *app-env
+    depends_on:
+      db:
+        condition: service_healthy
+      migrate:
+        condition: service_completed_successfully
+
+  migrate:
+    build:
+      context: .
+      target: migrate
+    environment:
+      <<: *app-env
+    depends_on:
+      db:
+        condition: service_healthy
+    restart: "no"
+
+  db:
+    image: postgres:17-alpine
+    ports:
+      - "5432:5432"
+    environment:
+      - POSTGRES_PASSWORD=\${POSTGRES_PASSWORD:-postgres}
+    volumes:
+      - db_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  db_data:`
+};
+
+// src/templates/deployment-standalone-di/templates/next-config.ts
+var next_config_default3 = {
+  filename: "apps/web/next.config.js",
+  template: `import dotenv from 'dotenv';
+import { resolve } from 'path';
+
+// Load root .env first, then local .env (local takes precedence)
+dotenv.config({ path: resolve(process.cwd(), '../../.env') });
+dotenv.config({ path: resolve(process.cwd(), '.env') });
+
+// No /api rewrite: DI-only runs Nest inside this process, so Next serves
+// /api itself and there is no separate api container to proxy to.
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "standalone",
+  serverExternalPackages: [
+    '@<%= projectName %>/api',
+    '@<%= projectName %>/db',
+    '@nestjs/core',
+    '@nestjs/common',
+    '@nestjs/microservices',
+    '@nestjs/websockets',
+    '@thallesp/nestjs-better-auth',
+    'reflect-metadata',
+    'express',
+  ],
+};
+
+export default nextConfig;`
+};
+
+// src/templates/deployment-standalone-di/index.ts
+var deploymentStandaloneDi = {
+  templates: [dockerfile_default2, docker_compose_default2, next_config_default3]
+};
+var deployment_standalone_di_default = deploymentStandaloneDi;
+
 // src/templates/api-controllers/templates/app-controller.ts
 var app_controller_default = {
   filename: "apps/api/src/app.controller.ts",
@@ -10787,15 +10921,26 @@ describe('AppController', () => {
 // src/templates/api-controllers/templates/app-module.ts
 var app_module_default2 = {
   filename: "apps/api/src/app.module.ts",
-  template: `import { Module } from '@nestjs/common';
+  template: `<% if (deployment === 'spa') { %>import { join } from 'path';
+<% } %>import { Module } from '@nestjs/common';
 import { APP_GUARD } from '@nestjs/core';
-import { AuthGuard, AuthModule } from '@thallesp/nestjs-better-auth';
+<% if (deployment === 'spa') { %>import { ServeStaticModule } from '@nestjs/serve-static';
+<% } %>import { AuthGuard, AuthModule } from '@thallesp/nestjs-better-auth';
 import { auth } from '@<%= projectName %>/auth';
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
 
 @Module({
-  imports: [AuthModule.forRoot({ auth })],
+<% if (deployment === 'spa') { %>  imports: [
+    // serves apps/web's static export; the api runs from apps/api
+    ServeStaticModule.forRoot({
+      rootPath: join(process.cwd(), '../web/out'),
+      exclude: ['/api/{*splat}'],
+    }),
+    AuthModule.forRoot({ auth }),
+  ],
+<% } else { %>  imports: [AuthModule.forRoot({ auth })],
+<% } -%>
   controllers: [AppController],
   providers: [AppService, { provide: APP_GUARD, useClass: AuthGuard }],
 })
@@ -11099,16 +11244,28 @@ export class TodosModule {}`
 // src/templates/todo-example/templates/app-module-controllers.ts
 var app_module_controllers_default = {
   filename: "apps/api/src/app.module.ts",
-  template: `import { Module } from '@nestjs/common';
+  template: `<% if (deployment === 'spa') { %>import { join } from 'path';
+<% } %>import { Module } from '@nestjs/common';
 import { APP_GUARD } from '@nestjs/core';
-import { AuthGuard, AuthModule } from '@thallesp/nestjs-better-auth';
+<% if (deployment === 'spa') { %>import { ServeStaticModule } from '@nestjs/serve-static';
+<% } %>import { AuthGuard, AuthModule } from '@thallesp/nestjs-better-auth';
 import { auth } from '@<%= projectName %>/auth';
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
 import { TodosModule } from './todos/todos.module';
 
 @Module({
-  imports: [AuthModule.forRoot({ auth }), TodosModule],
+<% if (deployment === 'spa') { %>  imports: [
+    // serves apps/web's static export; the api runs from apps/api
+    ServeStaticModule.forRoot({
+      rootPath: join(process.cwd(), '../web/out'),
+      exclude: ['/api/{*splat}'],
+    }),
+    AuthModule.forRoot({ auth }),
+    TodosModule,
+  ],
+<% } else { %>  imports: [AuthModule.forRoot({ auth }), TodosModule],
+<% } -%>
   controllers: [AppController],
   providers: [AppService, { provide: APP_GUARD, useClass: AuthGuard }],
 })
@@ -11730,6 +11887,7 @@ var templates = {
   deploymentCustomServer: single_process_custom_server_default,
   deploymentSpa: single_process_static_export_default,
   nestDiOnly: nest_di_only_default,
+  deploymentStandaloneDi: deployment_standalone_di_default,
   apiControllers: api_controllers_default,
   todoExampleApi,
   todoExampleControllers,
@@ -11853,6 +12011,24 @@ async function sortPackageJsons(destDir) {
     })
   );
 }
+function validateFlagValue(flag, value, allowed) {
+  if (allowed.includes(value)) {
+    return { valid: true };
+  }
+  return {
+    valid: false,
+    error: `Invalid value "${value}" for ${flag}. Valid choices: ${allowed.join(", ")}.`
+  };
+}
+function validateDeploymentCombo(deployment, nestDiOnly2) {
+  if (deployment === "spa" && nestDiOnly2) {
+    return {
+      valid: false,
+      error: "--deployment spa cannot be combined with --nest-di-only.\nSPA mode statically exports Next.js (output: 'export'), which cannot include the\nAPI route handlers that DI-only mode depends on. Pick one: drop --nest-di-only to\nget SPA mode with NestJS controllers, or drop --deployment spa."
+    };
+  }
+  return { valid: true };
+}
 function validateProjectName(projectName) {
   if (!projectName) {
     return { valid: false, error: "Project name is required" };
@@ -11891,6 +12067,7 @@ async function scaffold(modules, options) {
     projectName: options.name,
     testing: options.testing,
     database: options.database,
+    deployment: options.deployment,
     authSecret: randomBytes(32).toString("base64url")
   };
   await renderTemplatesToDisk(modules, options.name, templateData);
@@ -11927,6 +12104,10 @@ async function initGit(cwd) {
 }
 
 // src/index.ts
+var TESTING_CHOICES = ["jest", "vitest"];
+var DATABASE_CHOICES = ["sqlite", "postgres"];
+var LINTER_CHOICES = ["eslint", "oxc"];
+var DEPLOYMENT_CHOICES = ["none", "standalone", "custom-server", "spa"];
 var TaskBuilder = class {
   tasks = [];
   add(task) {
@@ -11983,13 +12164,15 @@ async function doInit(options) {
         message: "Include the todo example?",
         initialValue: true
       }),
-      deployment: () => p.select({
+      deployment: ({ results }) => p.select({
         message: "Deployment extras?",
         options: [
           { value: "none", label: "None", hint: "skip" },
           { value: "standalone", label: "Standalone + Dockerfile", hint: "Dockerfiles + docker-compose.yml" },
           { value: "custom-server", label: "Custom Server", hint: "single process, single port" },
-          { value: "spa", label: "SPA Mode", hint: "static export served by NestJS" }
+          // SPA statically exports Next.js, which can't hold the route
+          // handlers DI-only mode runs on
+          ...results.nestDiOnly ? [] : [{ value: "spa", label: "SPA Mode", hint: "static export served by NestJS" }]
         ],
         initialValue: "none"
       })
@@ -12009,6 +12192,10 @@ async function doInit(options) {
     const deployment = options.nonInteractive ? options.deployment : group2.deployment ?? "none";
     const nestDiOnly2 = options.nonInteractive ? options.nestDiOnly : group2.nestDiOnly ?? false;
     const todoExample = options.nonInteractive ? !options.bare : group2.todoExample ?? true;
+    const deploymentCombo = validateDeploymentCombo(deployment, nestDiOnly2);
+    if (!deploymentCombo.valid) {
+      throw new Error(deploymentCombo.error);
+    }
     const deploymentModule = deployment === "standalone" ? templates.deploymentStandalone : deployment === "custom-server" ? templates.deploymentCustomServer : deployment === "spa" ? templates.deploymentSpa : null;
     const webModule = deployment === "spa" ? {
       ...templates.web,
@@ -12028,6 +12215,9 @@ async function doInit(options) {
       testing === "vitest" ? templates.testingVitest : templates.testingJest,
       ...deploymentModule ? [deploymentModule] : [],
       ...nestDiOnly2 ? [templates.nestDiOnly] : [templates.apiControllers],
+      // nest-di-only overwrites the standalone next.config.js and leaves the
+      // Dockerfile pointing at an api entrypoint DI-only never emits
+      ...nestDiOnly2 && deployment === "standalone" ? [templates.deploymentStandaloneDi] : [],
       ...todoExample ? [
         templates.todoExampleApi,
         ...nestDiOnly2 ? [templates.todoExampleDi] : [templates.todoExampleControllers],
@@ -12039,7 +12229,7 @@ async function doInit(options) {
     taskBuilder.add({
       title: "Scaffolding project",
       task: async () => {
-        await scaffold(allModules, { name, testing, database });
+        await scaffold(allModules, { name, testing, database, deployment });
         return "Scaffolded.";
       }
     });
@@ -12102,16 +12292,27 @@ program.name("create-newt-app").version(package_default.version).description("Cr
     const nonInteractive = configFlags.some(
       (flag) => command.getOptionValueSource(flag) === "cli"
     );
+    const choices = [
+      { flag: "--testing", value: options.testing, allowed: TESTING_CHOICES },
+      { flag: "--database", value: options.database, allowed: DATABASE_CHOICES },
+      { flag: "--linter", value: options.linter, allowed: LINTER_CHOICES },
+      { flag: "--deployment", value: options.deployment, allowed: DEPLOYMENT_CHOICES }
+    ];
+    const invalid = choices.map(({ flag, value, allowed }) => validateFlagValue(flag, value, allowed)).find((result) => !result.valid);
+    if (invalid) {
+      console.error(`Error: ${invalid.error}`);
+      process.exit(1);
+    }
     await doInit({
       name,
       install: options.install,
       git: options.git,
       nonInteractive,
       shadcn: options.shadcn,
-      testing: options.testing === "vitest" ? "vitest" : "jest",
-      database: options.database === "postgres" ? "postgres" : "sqlite",
-      linter: options.linter === "oxc" ? "oxc" : "eslint",
-      deployment: ["standalone", "custom-server", "spa"].includes(options.deployment) ? options.deployment : "none",
+      testing: options.testing,
+      database: options.database,
+      linter: options.linter,
+      deployment: options.deployment,
       nestDiOnly: options.nestDiOnly,
       bare: options.bare
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-newt-app",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "license": "MIT",
   "private": false,
   "type": "module",