@nest-arch/tui 0.1.48 → 0.2.0

package/dist/templates/base/.gitignore.hbs

@@ -6,6 +6,9 @@
 # Prisma generated
 **/prisma/generated
 
+# Trpc generated
+**/trpc/@generated
+
 # Logs
 logs
 *.log

package/dist/templates/base/README.md.hbs

@@ -36,22 +36,54 @@ npm run start{{/if}}
 {{#if isPnpm}}pnpm test:cov{{else if isYarn}}yarn test:cov{{else if isBun}}bun run test:cov{{else}}npm run test:cov{{/if}}
 ```
 
-{{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
-## Auth Setup
+{{#if usePrisma}}
+## Database Setup
 
-This project uses **Better Auth**. Generate the database schema by running:
+This project uses **Prisma** as the ORM. Available commands:
 
 ```bash
-{{#if isPnpm}}pnpm dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else if isYarn}}yarn dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else if isBun}}bun x auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else}}npx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{/if}}
+{{#if isPnpm}}pnpm prisma:generate{{else if isYarn}}yarn prisma:generate{{else if isBun}}bun run prisma:generate{{else}}npm run prisma:generate{{/if}}
+{{#if isPnpm}}pnpm prisma:push{{else if isYarn}}yarn prisma:push{{else if isBun}}bun run prisma:push{{else}}npm run prisma:push{{/if}}
+{{#if isPnpm}}pnpm prisma:studio{{else if isYarn}}yarn prisma:studio{{else if isBun}}bun run prisma:studio{{else}}npm run prisma:studio{{/if}}
+{{#if isPnpm}}pnpm prisma:migrate{{else if isYarn}}yarn prisma:migrate{{else if isBun}}bun run prisma:migrate{{else}}npm run prisma:migrate{{/if}}
+{{#if isPnpm}}pnpm prisma:migrate:deploy{{else if isYarn}}yarn prisma:migrate:deploy{{else if isBun}}bun run prisma:migrate:deploy{{else}}npm run prisma:migrate:deploy{{/if}}
 ```
+{{/if}}
+
+{{#if useDrizzle}}
+## Database Setup
 
-{{#if useDrizzle}}Then run Drizzle migrations:
+This project uses **Drizzle** as the ORM. Available commands:
 
 ```bash
-{{#if isPnpm}}pnpm drizzle-kit generate && pnpm drizzle-kit migrate{{else if isYarn}}yarn drizzle-kit generate && yarn drizzle-kit migrate{{else}}npx drizzle-kit generate && npx drizzle-kit migrate{{/if}}
+{{#if isPnpm}}pnpm db:generate{{else if isYarn}}yarn db:generate{{else if isBun}}bun run db:generate{{else}}npm run db:generate{{/if}}
+{{#if isPnpm}}pnpm db:migrate{{else if isYarn}}yarn db:migrate{{else if isBun}}bun run db:migrate{{else}}npm run db:migrate{{/if}}
+{{#if isPnpm}}pnpm db:studio{{else if isYarn}}yarn db:studio{{else if isBun}}bun run db:studio{{else}}npm run db:studio{{/if}}
+{{#if isPnpm}}pnpm db:push{{else if isYarn}}yarn db:push{{else if isBun}}bun run db:push{{else}}npm run db:push{{/if}}
 ```
+{{/if}}
+
+{{#if useTypeorm}}
+## Database Setup
 
+This project uses **TypeORM** as the ORM. Available commands:
+
+```bash
+{{#if isPnpm}}pnpm typeorm:run{{else if isYarn}}yarn typeorm:run{{else if isBun}}bun run typeorm:run{{else}}npm run typeorm:run{{/if}}
+{{#if isPnpm}}pnpm typeorm:revert{{else if isYarn}}yarn typeorm:revert{{else if isBun}}bun run typeorm:revert{{else}}npm run typeorm:revert{{/if}}
+{{#if isPnpm}}pnpm typeorm:generate{{else if isYarn}}yarn typeorm:generate{{else if isBun}}bun run typeorm:generate{{else}}npm run typeorm:generate{{/if}}
+{{#if isPnpm}}pnpm typeorm:create{{else if isYarn}}yarn typeorm:create{{else if isBun}}bun run typeorm:create{{else}}npm run typeorm:create{{/if}}
+```
 {{/if}}
+
+{{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
+## Auth Setup
+
+This project uses **Better Auth**. Generate the database schema by running:
+
+```bash
+{{#if isPnpm}}pnpm dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else if isYarn}}yarn dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else if isBun}}bun x auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{else}}npx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y{{/if}}
+```
 See https://better-auth.com/docs/adapters/prisma for more details.
 
 ### Usage
@@ -72,3 +104,84 @@ export class AppController {
 }
 ```
 {{/if}}
+{{#if hasTrpc}}
+## tRPC Setup
+
+This project uses **nestjs-trpc** with decorator-based routing.
+
+### Generating tRPC Types
+
+After creating or modifying routers, generate the tRPC types:
+
+```bash
+{{#if isPnpm}}pnpm trpc:generate{{else if isYarn}}yarn trpc:generate{{else if isBun}}bun run trpc:generate{{else}}npm run trpc:generate{{/if}}
+```
+
+For watch mode (auto-regenerates on changes):
+
+```bash
+{{#if isPnpm}}pnpm trpc:watch{{else if isYarn}}yarn trpc:watch{{else if isBun}}bun run trpc:watch{{else}}npm run trpc:watch{{/if}}
+```
+
+{{#if hasTrpcAndAuth}}
+### Router Example (with Auth)
+
+Routers are defined using the `@Router` decorator from `nestjs-trpc`. **Router names must start with a lowercase letter.**
+
+```typescript
+import { Router, Query, UseMiddlewares, Ctx } from "nestjs-trpc";
+import z from "zod";
+
+import { AppService } from "./app.service.js";
+import type { UserSession } from "./auth/auth.js";
+import { AuthTRPCMiddleware } from "./libs/middlewares/auth.trpc.middleware.js";
+import type { InnerContext } from "./libs/trpc/inner.context.js";
+
+@Router({ alias: "appRouter" })
+export class AppRouterClass {
+  constructor(private readonly appService: AppService) {}
+
+  @Query()
+  @UseMiddlewares(AuthTRPCMiddleware)
+  testAuth(@Ctx() ctx: InnerContext): UserSession {
+    return ctx.session!;
+  }
+
+  @Query({ output: z.string() })
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}
+```
+{{else}}
+### Router Example
+
+Routers are defined using the `@Router` decorator from `nestjs-trpc`. **Router names must start with a lowercase letter.**
+
+```typescript
+import { Router, Query } from "nestjs-trpc";
+import z from "zod";
+
+@Router({ alias: "appRouter" })
+export class AppRouterClass {
+  constructor(private readonly appService: AppService) {}
+
+  @Query({ output: z.string() })
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}
+```
+{{/if}}
+
+Import the router in your module:
+
+```typescript
+import { AppRouterClass as AppRouter } from "./app.router.js";
+
+@Module({
+  providers: [AppRouter],
+})
+export class AppModule {}
+```
+{{/if}}

package/dist/templates/base/pnpm-workspace.yaml.hbs

@@ -1,5 +1,8 @@
 allowBuilds:
   "@nestjs/core": true
+{{#if swagger}}
+  "@scarf/scarf": true
+{{/if}}
 {{#if usePrisma}}
   prisma: true
   "@prisma/engines": true

package/dist/templates/base/src/app.controller.ts.hbs

@@ -1,9 +1,15 @@
 import { Controller, Get } from "@nestjs/common";
+{{#if swagger}}
+import { ApiOperation, ApiResponse, ApiTags } from "@nestjs/swagger";
+{{/if}}
 {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
 import { AllowAnonymous } from "@thallesp/nestjs-better-auth";
 {{/if}}
 import { AppService } from "./app.service.js";
 
+{{#if swagger}}
+@ApiTags("App")
+{{/if}}
 @Controller()
 export class AppController {
   constructor(private readonly appService: AppService) {}
@@ -11,6 +17,10 @@ export class AppController {
   {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
   @AllowAnonymous()
   {{/if}}
+  {{#if swagger}}
+  @ApiOperation({ summary: "/api" })
+  @ApiResponse({ status: 200, description: "Returns a hello world message" })
+  {{/if}}
   @Get()
   getHello(): string {
     return this.appService.getHello();

package/dist/templates/base/src/app.module.ts.hbs

@@ -1,17 +1,30 @@
 import { Module } from "@nestjs/common";
 {{#if (or hasDatabase hasOrm)}}
 import { env } from "./config/env.js";
-{{/if}}
 import { DbModule } from "./database/db.module.js";
-{{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
+{{/if}}
+{{#if shouldImportAuthModule}}
 import { AuthModule } from "./auth/auth.module.js";
 {{/if}}
+{{#if hasTrpc}}
+import { TRPCModule } from "nestjs-trpc";
+import { AppRouterClass as AppRouter } from "./app.router.js";
+import { AppContext } from "./libs/trpc/context.js";
+import { AppErrorHandler } from "./libs/trpc/error.handler.js";
+{{#if hasTrpcAndAuth}}
+import { AuthTRPCMiddleware } from "./libs/middlewares/auth.trpc.middleware.js";
+{{/if}}
+{{/if}}
 
+{{#if hasRest}}
 import { AppController } from "./app.controller.js";
+{{/if}}
 import { AppService } from "./app.service.js";
 
 @Module({
+  {{#if hasRest}}
   controllers: [AppController],
+  {{/if}}
   imports: [
     {{#if (or hasDatabase hasOrm)}}
     DbModule.forRoot({
@@ -21,10 +34,26 @@ import { AppService } from "./app.service.js";
       {{#if hasMongodb}}mongodbUrl: env.MONGODB_URL,{{/if}}
     }),
     {{/if}}
-    {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
+    {{#if shouldImportAuthModule}}
     AuthModule,
     {{/if}}
+    {{#if hasTrpc}}
+    TRPCModule.forRoot({
+      context: AppContext,
+      onError: AppErrorHandler,
+    }),
+    {{/if}}
+  ],
+  providers: [
+    AppService,
+    {{#if hasTrpc}}
+    {{#if hasTrpcAndAuth}}
+    AuthTRPCMiddleware,
+    {{/if}}
+    AppContext,
+    AppErrorHandler,
+    AppRouter,
+    {{/if}}
   ],
-  providers: [AppService],
 })
 export class AppModule {}

package/dist/templates/base/src/app.router.spec.ts.hbs

@@ -0,0 +1,58 @@
+import { Test, TestingModule } from "@nestjs/testing";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+import { AppRouterClass } from "./app.router.js";
+import { AppService } from "./app.service.js";
+{{#if hasTrpcAndAuth}}
+import { AuthTRPCMiddleware } from "./libs/middlewares/auth.trpc.middleware.js";
+import type { InnerContext } from "./libs/trpc/inner.context.js";
+{{/if}}
+
+describe(AppRouterClass, () => {
+  let router: AppRouterClass;
+
+  const mockAppService = {
+    getHello: vi.fn<() => string>().mockReturnValue("Hello World!"),
+  };
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [
+        AppRouterClass,
+        { provide: AppService, useValue: mockAppService },
+        {{#if hasTrpcAndAuth}}
+        { provide: AuthTRPCMiddleware, useValue: {} },
+        {{/if}}
+      ],
+    }).compile();
+
+    router = module.get<AppRouterClass>(AppRouterClass);
+  });
+
+  it("should be defined", () => {
+    expect(router).toBeDefined();
+  });
+
+  describe("getHello", () => {
+    it("should return the hello message from AppService", () => {
+      const result = router.getHello();
+      expect(result).toBe("Hello World!");
+      expect(mockAppService.getHello).toHaveBeenCalledWith();
+    });
+  });
+
+{{#if hasTrpcAndAuth}}
+  describe("testAuth", () => {
+    it("should return the session from context", () => {
+      const mockCtx = {
+        session: {
+          session: { expiresAt: new Date() },
+          user: { email: "test@example.com", id: "1", name: "Test User" },
+        },
+      } as InnerContext;
+      const result = router.testAuth(mockCtx);
+      expect(result).toStrictEqual(mockCtx.session);
+    });
+  });
+{{/if}}
+});

package/dist/templates/base/src/app.router.ts.hbs

@@ -0,0 +1,26 @@
+import { Router, Query, UseMiddlewares, Ctx } from "nestjs-trpc";
+import z from "zod";
+{{#if hasTrpcAndAuth}}
+import type { UserSession } from "./auth/auth.js";
+import { AuthTRPCMiddleware } from "./libs/middlewares/auth.trpc.middleware.js";
+import type { InnerContext } from "./libs/trpc/inner.context.js";
+{{/if}}
+import { AppService } from "./app.service.js";
+
+@Router({ alias: "appRouter" })
+export class AppRouterClass {
+  constructor(private readonly appService: AppService) {}
+
+{{#if hasTrpcAndAuth}}
+  @Query()
+  @UseMiddlewares(AuthTRPCMiddleware)
+  testAuth(@Ctx() ctx: InnerContext): UserSession {
+    return ctx.session!;
+  }
+
+{{/if}}
+  @Query({ output: z.string() })
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}

package/dist/templates/base/src/database/adapters/interfaces/db-adapter.interface.ts.hbs

@@ -1,8 +1,8 @@
 {{#if (or hasPostgres hasMysql hasSqlite)}}
 export interface ISqlAdapter<TClient = unknown> {
-  query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
-  execute(sql: string, params?: unknown[]): Promise<unknown>;
-  getClient(): TClient;
+  query: <T = unknown>(sql: string, params?: unknown[]) => Promise<T[]>;
+  execute: (sql: string, params?: unknown[]) => Promise<unknown>;
+  getClient: () => TClient;
 }
 {{/if}}
 

package/dist/templates/base/src/libs/middlewares/auth.trpc.middleware.ts.hbs

@@ -0,0 +1,42 @@
+import { Injectable } from "@nestjs/common";
+import { AuthService } from "@thallesp/nestjs-better-auth";
+import { TRPCError } from "@trpc/server";
+import {
+  MiddlewareOptions,
+  MiddlewareResponse,
+  TRPCMiddleware,
+} from "nestjs-trpc";
+import type { ContextOptions } from "nestjs-trpc";
+
+import { createAuth } from "../../auth/auth.js";
+
+type AppAuth = ReturnType<typeof createAuth>;
+
+@Injectable()
+export class AuthTRPCMiddleware implements TRPCMiddleware {
+  constructor(private readonly authService: AuthService<AppAuth>) {}
+
+  async use(
+    opts: MiddlewareOptions<ContextOptions>
+  ): Promise<MiddlewareResponse> {
+    const { ctx, next } = opts;
+
+    const session = await this.authService.api.getSession({
+      headers: ctx.req.headers,
+    });
+
+    if (session === null) {
+      throw new TRPCError({
+        code: "UNAUTHORIZED",
+        message: "No session found.",
+      });
+    }
+
+    return next({
+      ctx: {
+        ...ctx,
+        session,
+      },
+    });
+  }
+}

package/dist/templates/base/src/libs/trpc/context.ts.hbs

@@ -0,0 +1,13 @@
+// oxlint-disable require-await
+import { Injectable } from "@nestjs/common";
+import { ContextOptions, TRPCContext } from "nestjs-trpc";
+
+@Injectable()
+export class AppContext implements TRPCContext {
+  async create(opts: ContextOptions): Promise<Record<string, unknown>> {
+    return {
+      req: opts.req,
+      res: opts.res,
+    };
+  }
+}

package/dist/templates/base/src/libs/trpc/error.handler.ts.hbs

@@ -0,0 +1,10 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { OnErrorOptions, TRPCErrorHandler } from "nestjs-trpc";
+
+@Injectable()
+export class AppErrorHandler implements TRPCErrorHandler {
+  private logger = new Logger("TRPC Router");
+  onError(opts: OnErrorOptions): void {
+    this.logger.error(`[${opts.type}] ${opts.path}: ${opts.error.message}`);
+  }
+}

package/dist/templates/base/src/libs/trpc/inner.context.ts.hbs

@@ -0,0 +1,7 @@
+import { ContextOptions } from "nestjs-trpc";
+
+import { auth } from "../../auth/auth.js";
+
+export type InnerContext = {
+  session: Awaited<ReturnType<typeof auth.api.getSession>>;
+} & ContextOptions;

package/dist/templates/base/src/libs/trpc/protected.ts.hbs

@@ -0,0 +1,12 @@
+// oxlint-disable typescript/no-explicit-any
+import { TRPCError } from "@trpc/server";
+
+export function requireAuth(ctx: any) {
+  if (!ctx.session?.user) {
+    throw new TRPCError({
+      code: "UNAUTHORIZED",
+    });
+  }
+
+  return ctx.session.user;
+}

package/dist/templates/base/src/libs/trpc/scripts/fix-trpc-generated.mjs.hbs

@@ -0,0 +1,21 @@
+// This script is needed because nestjs-trpc doesn't have support for NestJS 12 yet.
+// Awaiting PR approval to support the new ESM support.
+import { readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+const generatedFile = path.join(
+  import.meta.dirname,
+  "..",
+  "@generated",
+  "server.ts"
+);
+
+let content = readFileSync(generatedFile, "utf-8");
+
+content = content.replaceAll(
+  /(?<ext>\.router)(?<quote>")/gu,
+  "$<ext>.js$<quote>"
+);
+
+writeFileSync(generatedFile, content, "utf-8");
+console.log("Fixed trpc generated file:", generatedFile);

package/dist/templates/base/src/libs/trpc/scripts/watch-trpc.mjs.hbs

@@ -0,0 +1,91 @@
+// This script is needed because nestjs-trpc doesn't have support for NestJS 12 yet.
+// Awaiting PR approval to support the new ESM support.
+import { spawn } from "node:child_process";
+import { watchFile, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+const generatedFile = path.join(
+  import.meta.dirname,
+  "..",
+  "@generated",
+  "server.ts"
+);
+const REGEX_REPLACE = /(?<ext>\.router)(?<quote>")/gu;
+
+function fixGeneratedFile() {
+  try {
+    let content = readFileSync(generatedFile, "utf-8");
+    const original = content;
+    content = content.replaceAll(REGEX_REPLACE, "$<ext>.js$<quote>");
+    if (content !== original) {
+      writeFileSync(generatedFile, content, "utf-8");
+      console.log("Fixed trpc generated file:", generatedFile);
+    }
+  } catch {
+    // file might not exist yet
+  }
+}
+
+// Run generate + fix upfront
+const projectRoot = path.join(import.meta.dirname, "..", "..", "..", "..");
+const SHELL = process.platform === "win32" ? "powershell.exe" : true;
+{{#if isMonorepo}}
+const genCmd =
+  "pnpm exec nestjs-trpc generate -e src/app.module.ts -o ../../packages/api/src/trpc/@generated";
+{{else}}
+const genCmd =
+  "pnpm exec nestjs-trpc generate -e src/app.module.ts -o src/libs/trpc/@generated";
+{{/if}}
+
+const spawnOpts = {
+  cwd: projectRoot,
+  shell: SHELL,
+  stdio: "inherit",
+};
+
+const gen = spawn(genCmd, [], spawnOpts);
+
+gen.on("close", (code) => {
+  if (code !== 0) {
+    process.exit(code);
+  }
+  fixGeneratedFile();
+
+  // Watch generated file for changes and re-apply fix
+  watchFile(generatedFile, { interval: 500 }, () => {
+    fixGeneratedFile();
+  });
+
+  // Start watch mode
+  {{#if isMonorepo}}
+  const watch = spawn(
+    "pnpm",
+    [
+      "exec",
+      "nestjs-trpc",
+      "watch",
+      "-e",
+      "src/app.module.ts",
+      "-o",
+      " ../../packages/api/src/trpc/@generated",
+    ],
+    spawnOpts
+  );
+  {{else}}
+  const watch = spawn(
+    "pnpm",
+    [
+      "exec",
+      "nestjs-trpc",
+      "watch",
+      "-e",
+      "src/app.module.ts",
+      "-o",
+      "src/libs/trpc/@generated",
+    ],
+    spawnOpts
+  );
+  {{/if}}
+
+  watch.on("close", (exitCode) => process.exit(exitCode ?? 0));
+});

package/dist/templates/base/src/main.ts.hbs

@@ -2,16 +2,89 @@ import { NestFactory } from "@nestjs/core";
 {{#if (eq httpProvider "fastify")}}
 import { FastifyAdapter, NestFastifyApplication } from "@nestjs/platform-fastify";
 {{/if}}
+import { Logger } from "@nestjs/common";
 
 import { AppModule } from "./app.module.js";
 import { env } from "./config/env.js";
+{{#if swagger}}
+import { createDocs } from "./docs/create-docs.js";
+{{/if}}
+{{#if (and swagger useSwaggerScalar)}}
+import { apiReference } from "@scalar/nestjs-api-reference";
+{{/if}}
+{{#if (and swagger (eq useSwaggerScalar false))}}
+import { SwaggerModule } from "@nestjs/swagger";
+{{/if}}
+{{#if (and swagger (or (eq auth "better-auth") (eq auth "better-auth:stateless") hasBetterAuthWithoutRest))}}
+import { auth } from "./auth/auth.js";
+{{/if}}
 
 async function bootstrap() {
-  const app = await NestFactory.create{{#if (eq httpProvider "fastify")}}<NestFastifyApplication>(AppModule, new FastifyAdapter(){{else}}(AppModule{{/if}}{{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}, { bodyParser: false }{{/if}});
+  const app = await NestFactory.create{{#if (eq httpProvider "fastify")}}<NestFastifyApplication>(AppModule, new FastifyAdapter(){{else}}(AppModule{{/if}}{{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless") hasBetterAuthWithoutRest)}}, { bodyParser: false }{{/if}});
   app.enableCors({
     origin: env.CORS_ORIGIN,
   });
   app.setGlobalPrefix("api");
+  {{#if swagger}}
+  const docsPath = "/docs";
+  {{#if useSwaggerScalar}}
+  app.use(
+    docsPath,
+    apiReference({
+      content: await createDocs(app, {
+        description: "{{description}}",
+        title: "{{projectNamePascalCase}} API",
+        integrations: {
+          {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless") hasBetterAuthWithoutRest)}}
+          betterAuth: {
+            auth,
+            pathPrefix: "/api/auth",
+          },
+          {{/if}}
+          {{#if (includes apis "trpc")}}
+          trpc: {
+            routerFilePath: "./src/libs/trpc/@generated/server.ts",
+            pathPrefix: "/trpc",
+          },
+          {{/if}}
+          zod: {
+            withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
+          },
+        },
+        version: "1.0.0",
+      }),
+      pageTitle: "{{projectNamePascalCase}} API Docs",
+      theme: "default",
+    }),
+  );
+  {{else}}
+  const document = await createDocs(app, {
+    title: "{{projectNamePascalCase}} API",
+    description: "{{description}}",
+    version: "1.0.0",
+    integrations: {
+      {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless") hasBetterAuthWithoutRest)}}
+      betterAuth: {
+        auth,
+        pathPrefix: "/api/auth",
+      },
+      {{/if}}
+      {{#if (includes apis "trpc")}}
+      trpc: {
+        routerFilePath: "./src/trpc/router.ts",
+        pathPrefix: "/trpc",
+      },
+      {{/if}}
+      zod: {
+        withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
+      },
+    },
+  });
+  SwaggerModule.setup(docsPath, app, document);
+  {{/if}}
+  Logger.log(`Swagger documentation available at http://localhost:${env.PORT ?? 3000}${docsPath}`, "SwaggerDocs");
+  {{/if}}
   await app.listen(env.PORT ?? 3000);
+  Logger.log(`Started backend server on http://localhost:${env.PORT ?? 3000}/api`, "Main");
 }
 await bootstrap();