better-ts-stack 1.1.3 → 2.0.0

package/templates/backend/express/src/index.ts

@@ -1,76 +1,76 @@
-import 'dotenv/config';
-import express, { Express, Request, Response, NextFunction } from 'express';
-import cors from 'cors';
-import helmet from 'helmet';
-import morgan from 'morgan';
-{{#if (eq database 'mongoose')}}
-import { connectDB } from './lib/db';
-{{/if}}
-import healthRouter from './routes/health';
-{{#if useAuth}}
-import authRouter from './routes/auth';
-{{/if}}
-
-
-
-const app: Express = express();
-const port = process.env.PORT || 3000;
-
-// Middleware
-app.use(helmet());
-app.use(cors());
-app.use(morgan('dev'));
-app.use(express.json());
-app.use(express.urlencoded({ extended: true }));
-
-// Routes
-app.use('/health', healthRouter);
-{{#if useAuth}}
-app.use('/auth', authRouter);
-{{/if}}
-
-// 404 handler
-app.use((_req: Request, res: Response) => {
-  res.status(404).json({ error: 'Not Found' });
-});
-
-// Error handler
-app.use(
-  (
-    err: Error & { status?: number; statusCode?: number; expose?: boolean },
-    _req: Request,
-    res: Response,
-    _next: NextFunction,
-  ) => {
-    // Middleware such as express.json() sets 4xx statuses (bad JSON, body too large)
-    const status = err.status ?? err.statusCode ?? 500;
-
-    if (status >= 400 && status < 500) {
-      res.status(status).json({ error: err.expose ? err.message : 'Bad Request' });
-      return;
-    }
-
-    console.error(err.stack);
-    res.status(500).json({ error: 'Internal Server Error' });
-  },
-);
-
-{{#if (eq database 'mongoose')}}
-void awaitDatabase().catch((error: unknown) => {
-  console.error(error);
-  process.exitCode = 1;
-});
-async function awaitDatabase(): Promise<void> {
-  await connectDB();
-  app.listen(port);
-}
-{{else}}
-app.listen(port, () => {
-  console.log(`Server is running on http://localhost:${port} 
-    Health: http://localhost:${port}/health
-    `);
-});
-
-{{/if}}
-
-export default app;
+import 'dotenv/config';
+import express, { Express, Request, Response, NextFunction } from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import morgan from 'morgan';
+{{#if (eq database 'mongoose')}}
+import { connectDB } from './lib/db';
+{{/if}}
+import healthRouter from './routes/health';
+{{#if useAuth}}
+import authRouter from './routes/auth';
+{{/if}}
+
+
+
+const app: Express = express();
+const port = process.env.PORT || 3000;
+
+// Middleware
+app.use(helmet());
+app.use(cors());
+app.use(morgan('dev'));
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+// Routes
+app.use('/health', healthRouter);
+{{#if useAuth}}
+app.use('/auth', authRouter);
+{{/if}}
+
+// 404 handler
+app.use((_req: Request, res: Response) => {
+  res.status(404).json({ error: 'Not Found' });
+});
+
+// Error handler
+app.use(
+  (
+    err: Error & { status?: number; statusCode?: number; expose?: boolean },
+    _req: Request,
+    res: Response,
+    _next: NextFunction,
+  ) => {
+    // Middleware such as express.json() sets 4xx statuses (bad JSON, body too large)
+    const status = err.status ?? err.statusCode ?? 500;
+
+    if (status >= 400 && status < 500) {
+      res.status(status).json({ error: err.expose ? err.message : 'Bad Request' });
+      return;
+    }
+
+    console.error(err.stack);
+    res.status(500).json({ error: 'Internal Server Error' });
+  },
+);
+
+{{#if (eq database 'mongoose')}}
+void awaitDatabase().catch((error: unknown) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+async function awaitDatabase(): Promise<void> {
+  await connectDB();
+  app.listen(port);
+}
+{{else}}
+app.listen(port, () => {
+  console.log(`Server is running on http://localhost:${port} 
+    Health: http://localhost:${port}/health
+    `);
+});
+
+{{/if}}
+
+export default app;

package/templates/backend/express/src/routes/health.ts

@@ -1,12 +1,12 @@
-import { Request, Response, Router } from "express";
-
-const router: Router = Router();
-
-router.get("/", (_req: Request, res: Response) => {
-  res.status(200).json({
-    status: "ok",
-    timestamp: new Date().toISOString(),
-  });
-});
-
-export default router;
+import { Request, Response, Router } from "express";
+
+const router: Router = Router();
+
+router.get("/", (_req: Request, res: Response) => {
+  res.status(200).json({
+    status: "ok",
+    timestamp: new Date().toISOString(),
+  });
+});
+
+export default router;

package/templates/backend/express/tsconfig.json

@@ -1,25 +1,25 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "NodeNext",
-    "lib": ["ES2020"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "moduleResolution": "NodeNext",
-    "types": ["node"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "moduleResolution": "NodeNext",
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/backend/nestjs/.prettierignore

@@ -0,0 +1,52 @@
+# Dependencies
+node_modules
+**/node_modules
+
+# Build outputs
+.next
+out
+dist
+build
+**/dist
+**/.next
+**/out
+**/build
+
+# Generated files
+*.min.js
+*.min.css
+coverage
+.nyc_output
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lock
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Templates (do not format generated/scaffold content)
+templates
+**/templates/**
+*.hbs

package/templates/backend/nestjs/.prettierrc

@@ -0,0 +1,16 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": false,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": ["@trivago/prettier-plugin-sort-imports"],
+  "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
+  "importOrderSeparation": true,
+  "importOrderSortSpecifiers": true,
+  "importOrderCaseInsensitive": true,
+  "importOrderParserPlugins": ["typescript", "decorators-legacy"]
+}

package/templates/backend/nestjs/config.json

@@ -0,0 +1,44 @@
+{
+  "id": "nestjs",
+  "name": "NestJS Base",
+  "description": "Base NestJS server with TypeScript, security headers, and a health check",
+  "type": "base",
+  "scripts": {
+    "dev": "cross-env NODE_ENV=development nest start --watch",
+    "build": "nest build",
+    "start": "cross-env NODE_ENV=production {{runner}} dist/main.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "type:check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@nestjs/common": "^12.1.2",
+    "@nestjs/core": "^12.1.2",
+    "@nestjs/platform-express": "^12.1.2",
+    "cross-env": "^10.1.0",
+    "dotenv": "^17.4.2",
+    "helmet": "^8.3.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@nestjs/cli": "^12.0.8",
+    "@nestjs/schematics": "^12.0.6",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.13.3",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.69.0"
+  },
+  "envVars": {
+    "PORT": "3000"
+  },
+  "templateFiles": [
+    "src/app.module.ts.hbs"
+  ]
+}

package/templates/backend/nestjs/eslint.config.mjs

@@ -0,0 +1,40 @@
+import eslint from "@eslint/js";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import tseslint from "typescript-eslint";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export default tseslint.config(
+  {
+    ignores: [
+      "dist",
+      "node_modules",
+      "templates/**/*",
+      "bin/**/*",
+      "src/generated/**",
+    ],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: "./tsconfig.eslint.json",
+        tsconfigRootDir: __dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/no-floating-promises": "error",
+      "no-console": "off",
+    },
+  }
+);

package/templates/backend/nestjs/gitignore

@@ -0,0 +1,36 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.tsbuildinfo

package/templates/backend/nestjs/nest-cli.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "tsConfigPath": "tsconfig.json"
+  }
+}

package/templates/backend/nestjs/src/app.module.ts.hbs

@@ -0,0 +1,34 @@
+import { Module } from "@nestjs/common";
+{{#if (eq database 'mongoose')}}
+import { MongooseModule } from "@nestjs/mongoose";
+{{/if}}
+
+{{#if useAuth}}
+import { AuthModule } from "./auth/auth.module.js";
+{{/if}}
+{{#if (eq database 'drizzle')}}
+import { DatabaseModule } from "./database/database.module.js";
+{{/if}}
+import { HealthController } from "./health/health.controller.js";
+{{#if (eq database 'prisma')}}
+import { PrismaModule } from "./prisma/prisma.module.js";
+{{/if}}
+
+@Module({
+  imports: [
+    {{#if (eq database 'prisma')}}
+    PrismaModule,
+    {{/if}}
+    {{#if (eq database 'drizzle')}}
+    DatabaseModule,
+    {{/if}}
+    {{#if (eq database 'mongoose')}}
+    MongooseModule.forRoot(process.env.MONGODB_URI!),
+    {{/if}}
+    {{#if useAuth}}
+    AuthModule,
+    {{/if}}
+  ],
+  controllers: [HealthController],
+})
+export class AppModule {}

package/templates/backend/nestjs/src/health/health.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from "@nestjs/common";
+
+@Controller("health")
+export class HealthController {
+  @Get()
+  check(): { status: string; timestamp: string } {
+    return {
+      status: "ok",
+      timestamp: new Date().toISOString(),
+    };
+  }
+}

package/templates/backend/nestjs/src/main.ts

@@ -0,0 +1,23 @@
+import { NestFactory } from "@nestjs/core";
+// Loads .env before app.module.js reads process.env
+import "dotenv/config";
+import helmet from "helmet";
+
+import { AppModule } from "./app.module.js";
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  const port = process.env.PORT ?? 3000;
+
+  app.use(helmet());
+  app.enableCors();
+  // Lets modules close database connections when the process is stopped
+  app.enableShutdownHooks();
+
+  await app.listen(port);
+  console.log(`Server is running on http://localhost:${port}
+    Health: http://localhost:${port}/health
+    `);
+}
+
+void bootstrap();

package/templates/backend/nestjs/tsconfig.eslint.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "allowJs": true,
+    "rootDir": "."
+  },
+  "include": ["src/**/*", "eslint.config.mjs", "prisma.config.ts"]
+}

package/templates/backend/nestjs/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "strictPropertyInitialization": false,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/frontend/nextjs/app/layout.tsx

@@ -12,10 +12,10 @@ const geistMono = Geist_Mono({
   subsets: ["latin"],
 });
 
-export const metadata: Metadata = {
-  title: "better-ts-stack starter",
-  description: "Generated with better-ts-stack",
-};
+export const metadata: Metadata = {
+  title: "better-ts-stack starter",
+  description: "Generated with better-ts-stack",
+};
 
 export default function RootLayout({
   children,
@@ -23,12 +23,12 @@ export default function RootLayout({
   children: React.ReactNode;
 }>) {
   return (
-    <html lang="en">
-      <body
-        className={`${geistSans.variable} ${geistMono.variable} bg-background text-foreground antialiased`}
-      >
-        {children}
-      </body>
-    </html>
-  );
-}
+    <html lang="en">
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} bg-background text-foreground antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}