stackkit-cli 0.4.3 → 0.4.5

package/modules/database/mongoose/module.json

@@ -0,0 +1,55 @@
+{
+  "name": "mongoose",
+  "displayName": "Mongoose (MongoDB)",
+  "description": "Mongoose ODM for MongoDB database",
+  "category": "database",
+  "provider": "mongoose",
+  "database": "mongodb",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "mongoose": "^8.8.4",
+    "mongodb": "^6.10.0"
+  },
+  "devDependencies": {
+    "@types/mongoose": "^5.11.97"
+  },
+  "envVars": {
+    "common": [
+      {
+        "key": "DATABASE_URL",
+        "value": "mongodb+srv://username:password@cluster.mongodb.net/mydb",
+        "required": true
+      }
+    ]
+  },
+  "frameworkPatches": {
+    "express": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "baseUrl": ".",
+            "paths": {
+              "@/*": ["./*"]
+            }
+          },
+          "include": ["src/**/*", "lib/**/*"],
+          "exclude": ["node_modules", "dist"]
+        }
+      }
+    }
+  },
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "{{dbDescription}}",
+      "source": "lib/{{dbFile}}",
+      "destination": "{{lib}}/{{dbFile}}"
+    },
+    {
+      "type": "create-file",
+      "description": "Create sample User model",
+      "source": "models/User.ts",
+      "destination": "{{models}}/User.ts"
+    }
+  ]
+}

package/modules/database/prisma/files/lib/prisma.ts

@@ -0,0 +1,4 @@
+import "dotenv/config";
+import { PrismaClient } from "./generated/prisma/client";
+{{prismaClientInit}}
+export { prisma };

package/modules/database/prisma/files/prisma/schema.prisma

@@ -0,0 +1,8 @@
+generator client {
+    provider = "prisma-client"
+    output   = "../lib/generated/prisma"
+}
+
+datasource db {
+    provider = "{{provider}}"
+}

package/modules/database/prisma/files/prisma.config.ts

@@ -0,0 +1,12 @@
+import "dotenv/config";
+import { defineConfig, env } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  datasource: {
+    url: env('DATABASE_URL'),
+  },
+});

package/modules/database/prisma/module.json

@@ -0,0 +1,122 @@
+{
+  "name": "prisma",
+  "displayName": "Prisma",
+  "description": "Prisma ORM",
+  "category": "database",
+  "provider": "prisma",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "common": {
+      "@prisma/client": "^7.2.0",
+      "dotenv": "^17.2.3"
+    },
+    "providers": {
+      "postgresql": {
+        "@prisma/adapter-pg": "^7.2.0",
+        "pg": "^8.16.3"
+      },
+      "mongodb": {
+        "@prisma/client": "6.19"
+      },
+      "mysql": {
+        "@prisma/adapter-mariadb": "^7.2.0"
+      },
+      "sqlite": {
+        "@prisma/adapter-better-sqlite3": "^7.2.0"
+      }
+    }
+  },
+  "devDependencies": {
+    "common": {
+      "prisma": "^7.2.0",
+      "tsx": "^4.21.0"
+    },
+    "providers": {
+      "postgresql": {
+        "@types/pg": "^8.16.0"
+      },
+      "mongodb": {
+        "prisma": "6.19"
+      },
+      "mysql": {},
+      "sqlite": {
+        "@types/better-sqlite3": "^7.6.13"
+      }
+    }
+  },
+  "envVars": {
+    "common": [
+      {
+        "key": "DATABASE_URL",
+        "value": "{{connectionString}}",
+        "required": true
+      }
+    ],
+    "providers": {
+      "mysql": [
+        {
+          "key": "DATABASE_HOST",
+          "value": "localhost",
+          "required": true
+        },
+        {
+          "key": "DATABASE_USER",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "DATABASE_PASSWORD",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "DATABASE_NAME",
+          "value": "mydb",
+          "required": true
+        },
+        {
+          "key": "DATABASE_PORT",
+          "value": "3306",
+          "required": false
+        }
+      ]
+    }
+  },
+  "frameworkPatches": {
+    "express": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "baseUrl": ".",
+            "paths": {
+              "@/*": ["./*"]
+            }
+          },
+          "include": ["src/**/*", "lib/**/*"],
+          "exclude": ["node_modules", "dist", "lib/generated/prisma"]
+        }
+      }
+    }
+  },
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Prisma schema",
+      "source": "prisma/schema.prisma",
+      "destination": "prisma/schema.prisma"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Prisma config",
+      "source": "prisma.config.ts",
+      "destination": "prisma.config.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "{{dbDescription}}",
+      "source": "lib/{{dbFile}}",
+      "destination": "{{lib}}/{{dbFile}}"
+    }
+  ],
+  "postInstall": ["npx prisma generate"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackkit-cli",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "CLI for StackKit - Production-ready project generator and module system",
   "main": "dist/index.js",
   "bin": {

package/templates/express/.env.example

@@ -1,11 +1,2 @@
 PORT=3000
-NODE_ENV=development
-APP_URL=http://localhost:3000
-SITE_URL=http://localhost:5173
-
-# Proxy (set to true if running behind a proxy/load-balancer)
-TRUST_PROXY=false
-
-# Rate limit
-RATE_LIMIT_MAX=100
-RATE_LIMIT_WINDOW_MS=900000
+NODE_ENV=development

package/templates/express/package.json

@@ -1,12 +1,10 @@
 {
-  "name": "my-app",
+  "name": "my-express-app",
   "version": "1.0.0",
   "private": true,
   "type": "module",
   "scripts": {
     "dev": "tsx watch src/server.ts",
-    "clean": "rimraf dist",
-    "prebuild": "npm run clean",
     "build": "tsc",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
@@ -14,26 +12,22 @@
     "start:prod": "cross-env NODE_ENV=production node dist/server.js"
   },
   "dependencies": {
-    "compression": "^1.7.4",
     "cors": "^2.8.5",
-    "dotenv": "^16.4.7",
-    "express": "^4.21.2",
-    "express-rate-limit": "^6.7.0",
-    "helmet": "^7.0.0",
-    "morgan": "^1.10.0"
+    "dotenv": "^17.2.3",
+    "express": "^5.2.1",
+    "helmet": "^8.1.0",
+    "morgan": "^1.10.1"
   },
   "devDependencies": {
-    "@types/compression": "^1.8.1",
-    "@types/cors": "^2.8.17",
-    "@types/express": "^4.17.21",
-    "@types/morgan": "^1.9.4",
-    "@types/node": "^22.10.5",
-    "@typescript-eslint/eslint-plugin": "^8.52.0",
-    "@typescript-eslint/parser": "^8.52.0",
-    "cross-env": "^7.0.3",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^25.0.8",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "cross-env": "^10.1.0",
     "eslint": "^9.39.2",
-    "rimraf": "^5.0.0",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.2"
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
   }
-}
+}

package/templates/express/src/app.ts

@@ -1,54 +1,31 @@
-import compression from "compression";
 import cors from "cors";
 import express, { Application, NextFunction, Request, Response } from "express";
-import rateLimit from "express-rate-limit";
 import helmet from "helmet";
 import morgan from "morgan";
 import { env } from "./config/env";
+import { authRoutes } from "./features/health/health.route";
 import { errorHandler } from "./middlewares/error.middleware";
 
 // app initialization
 const app: Application = express();
 app.use(express.json());
 
-// trust proxy when behind reverse proxy (like Heroku, Vercel, Load Balancers)
-if (env.app.trust_proxy) {
-  app.set("trust proxy", 1);
-}
-
 // security headers
 app.use(helmet());
 
-// response compression
-app.use(compression());
-
-// rate limiting
-const limiter = rateLimit({
-  windowMs: env.app.rateLimit.windowMs,
-  max: env.app.rateLimit.max,
-  standardHeaders: true,
-  legacyHeaders: false,
-});
-app.use(limiter);
-
 // logging
-if (env.node.isProduction) {
+if (env.isProduction) {
   app.use(morgan("combined"));
 } else {
   app.use(morgan("dev"));
 }
 
 // cors configuration
-app.use(
-  cors({
-    origin: [env.app.site_url],
-    credentials: true,
-  }),
-);
+app.use(cors());
 
 // Home page route
-app.get("/", (req: Request, res: Response) => {
-  res.json({
+app.get("/", (_req: Request, res: Response) => {
+  res.status(200).json({
     title: "Welcome to your Express app",
     description:
       "Built with StackKit - A production-ready Express template with TypeScript, security, and best practices.",
@@ -57,8 +34,11 @@ app.get("/", (req: Request, res: Response) => {
   });
 });
 
+// routes
+app.use("/api/health", authRoutes);
+
 // unhandled routes
-app.use((req: Request, res: Response, next: NextFunction) => {
+app.use((req: Request, _res: Response, next: NextFunction) => {
   const error: any = new Error(`Can't find ${req.originalUrl} on this server!`);
   error.status = 404;
 

package/templates/express/src/config/env.ts

@@ -4,20 +4,9 @@ import path from "path";
 dotenv.config({ path: path.join(process.cwd(), ".env") });
 
 const env = {
-  app: {
-    port: Number(process.env.PORT) || 3000,
-    url: process.env.APP_URL || "http://localhost:3000",
-    site_url: process.env.SITE_URL || "http://localhost:5173",
-    trust_proxy: (process.env.TRUST_PROXY || "false") === "true",
-    rateLimit: {
-      max: Number(process.env.RATE_LIMIT_MAX) || 100,
-      windowMs: Number(process.env.RATE_LIMIT_WINDOW_MS) || 15 * 60 * 1000,
-    },
-  },
-  node: {
-    env: process.env.NODE_ENV || "development",
-    isProduction: (process.env.NODE_ENV || "development") === "production",
-  },
+  port: Number(process.env.PORT) || 3000,
+  node_env: process.env.NODE_ENV || "development",
+  isProduction: (process.env.NODE_ENV || "development") === "production",
 };
 
 export { env };

package/templates/express/src/features/health/health.controller.ts

@@ -0,0 +1,18 @@
+import { NextFunction, Request, Response } from "express";
+
+const health = async (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.status(200).json({
+      success: true,
+      message: "API is healthy!",
+      timestamp: new Date().toISOString(),
+      version: "1.0.0",
+    });
+  } catch (error) {
+    next(error);
+  }
+};
+
+export const healthController = {
+  health,
+};

package/templates/express/src/features/health/health.route.ts

@@ -0,0 +1,9 @@
+import { Router } from "express";
+import { healthController } from "./health.controller";
+
+const router = Router();
+
+// demo route
+router.get("/", healthController.health);
+
+export const authRoutes = router;

package/templates/express/src/features/health/health.service.ts

@@ -0,0 +1,6 @@
+// Demo service - placeholder for future use
+// Add your service logic here when needed
+
+export const healthServices = {
+  // placeholder
+};

package/templates/express/src/middlewares/error.middleware.ts

@@ -1,7 +1,7 @@
 import { NextFunction, Request, Response } from "express";
 import { env } from "../config/env";
 
-export const errorHandler = (err: any, req: Request, res: Response, next: NextFunction) => {
+export const errorHandler = (err: any, _req: Request, res: Response, _: NextFunction) => {
   const statusCode = err.status || 500;
   const errorMessage = err?.message || "Internal server error!";
 
@@ -10,7 +10,7 @@ export const errorHandler = (err: any, req: Request, res: Response, next: NextFu
     message: errorMessage,
   };
 
-  if (!env.node.isProduction) {
+  if (!env.isProduction) {
     payload.errors = err?.stack || err;
   }
 

package/templates/express/src/server.ts

@@ -1,7 +1,7 @@
 import app from "./app";
 import { env } from "./config/env";
 
-const port = env.app.port;
+const port = env.port;
 
 app.listen(port, () => {
   console.log(`Server is running on http://localhost:${port}`);

package/templates/express/template.json

@@ -3,11 +3,9 @@
   "displayName": "Express.js",
   "framework": "express",
   "description": "Express.js REST API with TypeScript",
-  "files": ["src/", ".env.example", ".gitignore", "package.json", "tsconfig.json"],
+  "files": ["src/", ".gitignore", "package.json", "tsconfig.json", ".env.example"],
   "scripts": {
     "dev": "tsx watch src/server.ts",
-    "clean": "rimraf dist",
-    "prebuild": "npm run clean",
     "build": "tsc",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
@@ -16,8 +14,6 @@
   },
   "jsScripts": {
     "dev": "tsx --watch src/server.js",
-    "clean": "rimraf dist",
-    "prebuild": "npm run clean",
     "build": "echo 'No build step for JavaScript'",
     "lint": "eslint src --ext .js",
     "lint:fix": "eslint src --ext .js --fix",

package/templates/express/tsconfig.json

@@ -1,6 +1,5 @@
 {
   "compilerOptions": {
-    "rootDir": "./src",
     "outDir": "./dist",
     "module": "ESNext",
     "moduleResolution": "node",

package/templates/nextjs/lib/env.ts

@@ -0,0 +1,8 @@
+export const env = {
+  app: {
+    url: process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000",
+  },
+
+  isDev: process.env.NODE_ENV === "development",
+  isProd: process.env.NODE_ENV === "production",
+} as const;

package/templates/nextjs/package.json

@@ -15,13 +15,13 @@
     "react-dom": "19.2.3"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4",
-    "@types/node": "^20",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "eslint": "^9",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/node": "^25.0.8",
+    "@types/react": "^19.2.8",
+    "@types/react-dom": "^19.2.3",
+    "eslint": "^9.39.2",
     "eslint-config-next": "16.1.1",
-    "tailwindcss": "^4",
-    "typescript": "^5"
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3"
   }
 }

package/templates/react-vite/.env.example

@@ -1,2 +1 @@
-# API Configuration
-VITE_API_URL=http://localhost:3000
+VITE_API_URL=http://localhost:3000

package/templates/react-vite/.prettierignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+coverage
+*.log

package/templates/react-vite/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": false,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always"
+}

package/templates/react-vite/README.md

@@ -14,6 +14,7 @@ A production-ready React starter template with TypeScript, Vite, and essential l
 - **SEO Ready** with React Helmet Async
 - **Error Boundaries** for graceful error handling
 - **ESLint** for code quality
+- **Prettier** for code formatting
 - **Custom Hooks** included
 
 ## Quick Start
@@ -30,6 +31,18 @@ pnpm build
 
 # Preview production build
 pnpm preview
+
+# Run linter
+pnpm lint
+
+# Fix linting issues
+pnpm lint:fix
+
+# Format code
+pnpm format
+
+# Check formatting
+pnpm format:check
 ```
 
 ## Project Structure
@@ -44,6 +57,7 @@ src/
 ├── pages/        # Route pages
 ├── types/        # TypeScript types
 ├── utils/        # Helper functions
+├── test/         # Test setup
 ├── App.tsx       # Main app component
 ├── main.tsx      # Entry point
 └── index.css     # Global styles
@@ -51,6 +65,14 @@ src/
 
 ## Environment Variables
 
+Copy `.env.example` to `.env` and update the values:
+
+```bash
+cp .env.example .env
+```
+
+## Environment Variables
+
 Create a `.env` file:
 
 ```env

package/templates/react-vite/package.json

@@ -12,33 +12,33 @@
   },
   "dependencies": {
     "@tailwindcss/vite": "^4.1.18",
-    "@tanstack/react-query": "^5.62.0",
-    "@tanstack/react-query-devtools": "^5.62.0",
-    "axios": "^1.7.7",
+    "@tanstack/react-query": "^5.90.16",
+    "@tanstack/react-query-devtools": "^5.91.2",
+    "axios": "^1.13.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
     "react-helmet-async": "^2.0.5",
-    "react-hot-toast": "^2.4.1",
+    "react-hot-toast": "^2.6.0",
     "react-router": "^7.12.0",
     "tailwind-merge": "^3.4.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.0.8",
+    "@types/react": "^19.2.8",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
+    "@vitejs/plugin-react": "^5.1.2",
     "autoprefixer": "^10.4.23",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "globals": "^16.5.0",
+    "eslint-plugin-react-refresh": "^0.4.26",
+    "globals": "^17.0.0",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.1.18",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4"
+    "typescript-eslint": "^8.53.0",
+    "vite": "^7.3.1"
   }
-}
+}

package/templates/react-vite/src/router.tsx

@@ -1,11 +1,9 @@
 import { createBrowserRouter } from "react-router";
-import { userService } from "./api/services/user.service";
 import { ErrorBoundary } from "./components/ErrorBoundary";
 import Layout from "./components/Layout";
 import About from "./pages/About";
 import Home from "./pages/Home";
 import NotFound from "./pages/NotFound";
-import UserProfile from "./pages/UserProfile";
 
 export const router = createBrowserRouter([
   {
@@ -15,16 +13,6 @@ export const router = createBrowserRouter([
     children: [
       { index: true, Component: Home },
       { path: "about", Component: About },
-      {
-        path: "users/:userId",
-        loader: async ({ params }) => {
-          const id = params.userId;
-          if (!id) throw new Response("Missing user id", { status: 400 });
-          const user = await userService.getUser(id);
-          return user;
-        },
-        Component: UserProfile,
-      },
       { path: "*", Component: NotFound },
     ],
   },