better-ts-stack 1.1.4 → 2.0.1

package/package.json

@@ -1,66 +1,71 @@
-{
-  "name": "better-ts-stack",
-  "version": "1.1.4",
-  "description": "A powerful CLI tool that generates fully configured TypeScript projects with backend, frontend, database integration, Docker support, and more--all through an interactive setup.",
-  "keywords": [
-    "cli",
-    "builder",
-    "backend",
-    "typescript",
-    "express",
-    "prisma",
-    "template"
-  ],
-  "homepage": "https://better-ts-stack.abdullahtech.me",
-  "bugs": {
-    "url": "https://github.com/Abdullah-dev0/better-ts-stack/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Abdullah-dev0/better-ts-stack.git"
-  },
-  "license": "MIT",
-  "author": "Abdullah",
-  "type": "commonjs",
-  "main": "dist/index.js",
-  "bin": {
-    "better-ts-stack": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "templates"
-  ],
-  "scripts": {
-    "dev": "tsx  src/index.ts",
-    "build": "tsc",
-    "postbuild": "node -e \"const fs=require('fs');const p='dist/index.js';fs.writeFileSync(p,'#!/usr/bin/env node\\n'+fs.readFileSync(p,'utf8'))\"",
-    "prepack": "npm run build",
-    "start": "node dist/index.js",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix",
-    "format": "prettier --write  \"**/*.{ts,tsx,js,jsx,json,md,mdx,css}\"",
-    "format:check": "prettier --check  \"**/*.{ts,tsx,js,jsx,json,md,mdx,css}\"",
-    "type:check": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.7.0",
-    "consola": "^3.4.2",
-    "fs-extra": "^11.4.0",
-    "handlebars": "^4.7.9",
-    "zod": "^4.5.4"
-  },
-  "devDependencies": {
-    "@better-ts-stack/eslint-config": "*",
-    "@better-ts-stack/prettier-config": "*",
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.13.3",
-    "eslint": "^10.10.0",
-    "prettier": "^3.9.6",
-    "tsx": "^4.23.13",
-    "typescript": "^6.0.3"
-  },
-  "engines": {
-    "node": ">=24.0.0"
-  },
-  "prettier": "@better-ts-stack/prettier-config"
-}
+{
+  "name": "better-ts-stack",
+  "version": "2.0.1",
+  "description": "A CLI that scaffolds Express, NestJS, Next.js, and TanStack Start projects with a database, authentication, and Docker already set up.",
+  "keywords": [
+    "cli",
+    "builder",
+    "backend",
+    "typescript",
+    "express",
+    "nestjs",
+    "nextjs",
+    "tanstack-start",
+    "prisma",
+    "drizzle",
+    "mongoose",
+    "template"
+  ],
+  "homepage": "https://better-ts-stack.abdullahtech.me",
+  "bugs": {
+    "url": "https://github.com/Abdullah-dev0/better-ts-stack/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abdullah-dev0/better-ts-stack.git"
+  },
+  "license": "MIT",
+  "author": "Abdullah",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "bin": {
+    "better-ts-stack": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "dev": "tsx  src/index.ts",
+    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "tsc",
+    "postbuild": "node -e \"const fs=require('fs');const p='dist/index.js';fs.writeFileSync(p,'#!/usr/bin/env node\\n'+fs.readFileSync(p,'utf8'))\"",
+    "prepack": "npm run build",
+    "start": "node dist/index.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write  \"**/*.{ts,tsx,js,jsx,json,md,mdx,css}\"",
+    "format:check": "prettier --check  \"**/*.{ts,tsx,js,jsx,json,md,mdx,css}\"",
+    "type:check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/core": "^1.4.3",
+    "fs-extra": "^11.4.0",
+    "handlebars": "^4.7.9",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@better-ts-stack/eslint-config": "*",
+    "@better-ts-stack/prettier-config": "*",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.13.3",
+    "eslint": "^10.10.0",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "prettier": "@better-ts-stack/prettier-config"
+}

package/templates/backend/express/.prettierrc

@@ -7,8 +7,8 @@
   "useTabs": false,
   "arrowParens": "always",
   "endOfLine": "lf",
-  "plugins": ["@trivago/prettier-plugin-sort-imports", "prettier-plugin-tailwindcss"],
-  "importOrder": ["^react", "^next", "<THIRD_PARTY_MODULES>", "^@repo/(.*)$", "^@/(.*)$", "^[./]"],
+  "plugins": ["@trivago/prettier-plugin-sort-imports"],
+  "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
   "importOrderSeparation": true,
   "importOrderSortSpecifiers": true,
   "importOrderGroupNamespaceSpecifiers": true,

package/templates/backend/express/config.json

@@ -1,44 +1,40 @@
-{
-  "id": "express",
-  "name": "Express Base",
-  "description": "Base Express server with TypeScript, middleware, and best practices",
-  "type": "base",
-  "scripts": {
-    "dev": "cross-env NODE_ENV=development {{#if (eq packageManager 'bun')}}bun --watch src/index.ts{{else}}tsx watch src/index.ts{{/if}}",
-    "build": "tsc",
-    "start": "cross-env NODE_ENV=production {{runner}} dist/index.js",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "type:check": "tsc --noEmit"
-  },
-  "dependencies": {
-    "express": "^5.2.1",
-    "dotenv": "^17.4.2",
-    "cors": "^2.8.6",
-    "cross-env": "^10.1.0",
-    "helmet": "^8.3.0",
-    "morgan": "^1.12.0"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.6",
-    "@types/morgan": "^1.9.10",
-    "@types/node": "^24.13.3",
-    "eslint": "^10.10.0",
-    "eslint-config-prettier": "^10.1.8",
-    "prettier": "^3.9.6",
-    "prettier-plugin-tailwindcss": "^0.8.1",
-    "tsx": "^4.23.13",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.69.0"
-  },
-  "envVars": {
-    "PORT": "3000"
-  },
-  "templateFiles": [
-    "src/index.ts"
-  ]
-}
+{
+  "id": "express",
+  "name": "Express Base",
+  "description": "Base Express server with TypeScript, security headers, and a health check",
+  "type": "base",
+  "scripts": {
+    "dev": "cross-env NODE_ENV=development {{#if (eq packageManager 'bun')}}bun --watch src/index.ts{{else}}tsx watch src/index.ts{{/if}}",
+    "build": "tsc",
+    "start": "cross-env NODE_ENV=production {{runner}} dist/index.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "type:check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "dotenv": "^17.4.2",
+    "cors": "^2.8.6",
+    "cross-env": "^10.1.0",
+    "helmet": "^8.3.0",
+    "morgan": "^1.12.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^24.13.3",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.69.0"
+  },
+  "envVars": {
+    "PORT": "3000"
+  }
+}

package/templates/backend/express/src/{index.ts → index.ts.hbs}

@@ -1,76 +1,75 @@
-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" });
+  },
+);
+
+function listen(): void {
+  app.listen(port, () => {
+    console.log(`Server is running on http://localhost:${port}
+    Health: http://localhost:${port}/health
+    `);
+  });
+}
+
+{{#if (eq database 'mongoose')}}
+void connectDB()
+  .then(listen)
+  .catch((error: unknown) => {
+    console.error(error);
+    process.exitCode = 1;
+  });
+{{else}}
+listen();
+{{/if}}
+
+export default app;

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,41 @@
+{
+  "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"
+  }
+}

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();