create-stackkit-app 0.4.4 → 0.4.6

package/modules/auth/better-auth/module.json

@@ -5,50 +5,33 @@
   "category": "auth",
   "provider": "better-auth",
   "supportedFrameworks": ["nextjs", "express", "react-vite"],
+  "compatibility": {
+    "frameworks": ["nextjs", "express", "react-vite"],
+    "databases": ["prisma", "mongoose"],
+    "languages": ["typescript", "javascript"],
+    "packageManagers": ["npm", "yarn", "pnpm", "bun"]
+  },
   "databaseAdapters": {
     "prisma-postgresql": {
-      "adapterCode": "import { prisma } from \"{{dbImport}}\";\nimport { prismaAdapter } from \"@better-auth/prisma\";\n\nexport const auth = betterAuth({\n  database: prismaAdapter(prisma, {\n    provider: \"postgresql\",\n  }),",
-      "schema": "files/schemas/prisma-schema.prisma",
-      "schemaDestination": "prisma/schema.prisma",
       "dependencies": {
-        "better-auth": "^1.1.4"
+        "@prisma/adapter-pg": "^5.0.0",
+        "pg": "^8.0.0"
       }
     },
     "prisma-mongodb": {
-      "adapterCode": "import { prisma } from \"{{dbImport}}\";\nimport { prismaAdapter } from \"@better-auth/prisma\";\n\nexport const auth = betterAuth({\n  database: prismaAdapter(prisma, {\n    provider: \"mongodb\",\n  }),",
-      "schema": "files/schemas/prisma-schema.prisma",
-      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    },
+    "prisma-mysql": {
       "dependencies": {
-        "better-auth": "^1.1.4"
+        "@prisma/adapter-mariadb": "^5.0.0",
+        "mysql2": "^3.0.0"
       }
     },
-    "mongoose-mongodb": {
-      "adapterCode": "import { client } from \"{{dbImport}}\";\nimport { mongodbAdapter } from \"better-auth/adapters/mongodb\";\n\nexport const auth = betterAuth({\n  database: mongodbAdapter(client),",
+    "prisma-sqlite": {
       "dependencies": {
-        "better-auth": "^1.1.4"
+        "@prisma/adapter-better-sqlite3": "^5.0.0",
+        "better-sqlite3": "^9.0.0"
       }
     }
-  },
-  "envVars": [
-    {
-      "key": "BETTER_AUTH_SECRET",
-      "value": "",
-      "description": "Secret key for Better Auth. Generate with: openssl rand -base64 32",
-      "required": true
-    },
-    {
-      "key": "BETTER_AUTH_URL",
-      "value": "http://localhost:3000",
-      "description": "Base URL of your application (change in production)",
-      "required": true
-    }
-  ],
-  "patches": [
-    {
-      "type": "create-file",
-      "description": "Create Better Auth configuration",
-      "source": "files/lib/auth.ts",
-      "destination": "{{lib}}/auth.ts"
-    }
-  ]
+  }
 }

package/modules/database/mongoose/files/lib/db.ts

@@ -0,0 +1,63 @@
+import mongoose from "mongoose";
+
+type MongooseCache = {
+  conn: typeof mongoose | null;
+  promise: Promise<typeof mongoose> | null;
+};
+
+const globalWithMongoose = globalThis as unknown as {
+  mongoose: MongooseCache;
+};
+
+// Initialize the cache if not already present
+const cached = globalWithMongoose.mongoose || {
+  conn: null,
+  promise: null,
+};
+
+if (!globalWithMongoose.mongoose) {
+  globalWithMongoose.mongoose = cached;
+}
+
+async function dbConnect(): Promise<typeof mongoose> {
+  if (cached.conn) {
+    return cached.conn;
+  }
+
+  const uri = process.env.DATABASE_URL as string;
+
+  if (!cached.promise) {
+    const opts = {
+      bufferCommands: false,
+      connectTimeoutMS: 10000,
+      serverSelectionTimeoutMS: 10000,
+      // serverApi removed: not needed for mongoose-only connection
+    };
+
+    cached.promise = mongoose
+      .connect(uri, opts)
+      .then(async (mongooseInstance: typeof mongoose) => {
+        console.info("MongoDB connected successfully");
+        if (mongoose.connection.db) {
+          await mongoose.connection.db.admin().command({ ping: 1 });
+          console.info("Pinged your deployment. You successfully connected to MongoDB!");
+        }
+        return mongooseInstance;
+      })
+      .catch((error: Error) => {
+        console.error("MongoDB connection failed", { error });
+        throw error;
+      });
+  }
+
+  try {
+    cached.conn = await cached.promise;
+  } catch (error) {
+    cached.promise = null;
+    throw error;
+  }
+
+  return cached.conn;
+}
+
+export { dbConnect as mongoose, dbConnect as connectMongoose };

package/modules/database/{mongoose-mongodb → mongoose}/files/models/User.ts

@@ -3,7 +3,6 @@ import mongoose, { Document, Schema } from "mongoose";
 export interface IUser extends Document {
   name: string;
   email: string;
-  password: string;
   createdAt: Date;
   updatedAt: Date;
 }
@@ -22,10 +21,6 @@ const UserSchema: Schema = new Schema(
       lowercase: true,
       trim: true,
     },
-    password: {
-      type: String,
-      required: true,
-    },
   },
   {
     timestamps: true,

package/modules/database/mongoose/generator.json

@@ -0,0 +1,33 @@
+{
+  "name": "mongoose",
+  "type": "database",
+  "priority": 5,
+  "operations": [
+    {
+      "type": "create-file",
+      "source": "lib/db.ts",
+      "destination": "src/lib/db.ts"
+    },
+    {
+      "type": "create-file",
+      "source": "models/User.ts",
+      "destination": "src/lib/models.ts"
+    },
+    {
+      "type": "create-file",
+      "destination": "scripts/seed.ts",
+      "condition": { "features": ["seed"] },
+      "content": "import dbConnect from '../src/lib/db'\nimport { User } from '../src/lib/models'\n\nasync function main() {\n  await dbConnect()\n\n  // Create a default user\n  const user = await User.findOneAndUpdate(\n    { email: 'admin@example.com' },\n    {\n      email: 'admin@example.com',\n      name: 'Admin User',\n      role: 'ADMIN',\n    },\n    { upsert: true, new: true }\n  )\n\n  console.log('Created user:', user)\n}\n\nmain().catch(console.error)"
+    }
+  ],
+  "dependencies": {
+    "mongoose": "^8.8.0"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "db:seed": "tsx scripts/seed.ts"
+  },
+  "envVars": {
+    "MONGODB_URI": "mongodb://localhost:27017/database_name"
+  }
+}

package/modules/database/mongoose/module.json

@@ -0,0 +1,15 @@
+{
+  "name": "mongoose",
+  "displayName": "Mongoose (MongoDB)",
+  "description": "Mongoose ODM for MongoDB database",
+  "category": "database",
+  "provider": "mongoose",
+  "database": "mongodb",
+  "supportedFrameworks": ["nextjs", "express"],
+  "compatibility": {
+    "frameworks": ["nextjs", "express"],
+    "databases": ["mongoose"],
+    "languages": ["typescript", "javascript"],
+    "packageManagers": ["npm", "yarn", "pnpm", "bun"]
+  }
+}

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

@@ -1,6 +1,9 @@
-import "dotenv/config";
-import { PrismaClient } from "@/generated/prisma/client";
+import { PrismaClient } from '@prisma/client'
 
-{{prismaClientInit}}
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined
+}
 
-export { prisma };
+export const prisma = globalForPrisma.prisma ?? new PrismaClient()
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma

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

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

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

@@ -1,5 +1,5 @@
 import "dotenv/config";
-import { defineConfig } from "prisma/config";
+import { defineConfig, env } from "prisma/config";
 
 export default defineConfig({
   schema: "prisma/schema.prisma",
@@ -7,6 +7,6 @@ export default defineConfig({
     path: "prisma/migrations",
   },
   datasource: {
-    url: process.env["DATABASE_URL"],
+    url: env('DATABASE_URL'),
   },
 });

package/modules/database/prisma/generator.json

@@ -0,0 +1,46 @@
+{
+  "name": "prisma",
+  "type": "database",
+  "priority": 5,
+  "operations": [
+    {
+      "type": "create-file",
+      "destination": "prisma/schema.prisma",
+      "content": "// This is your Prisma schema file,\n// learn more about it in the docs: https://pris.ly/d/prisma-schema\n\ngenerator client {\n  provider = \"prisma-client-js\"\n}\n\ndatasource db {\n  provider = \"{{prismaProvider}}\"\n}\n\nmodel User {\n  id        String   @id {{#if prismaProvider==\"postgresql\"}}@default(cuid()){{/if}}{{#if prismaProvider!=\"postgresql\"}}@default(uuid()){{/if}}\n  email     String   @unique\n  name      String?\n  password  String?\n  role      String   @default(\"USER\")\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  {{#if auth==\"better-auth\"}}accounts Account[]\n  sessions Session[]\n  {{/if}}\n}\n\n{{#if auth==\"better-auth\"}}model Account {\n  id                String  @id {{#if prismaProvider==\"postgresql\"}}@default(cuid()){{/if}}{{#if prismaProvider!=\"postgresql\"}}@default(uuid()){{/if}}\n  accountId         String\n  providerId        String\n  userId            String\n  user              User    @relation(fields: [userId], references: [id], onDelete: Cascade)\n\n  @@unique([providerId, accountId])\n}\n\nmodel Session {\n  id        String   @id {{#if prismaProvider==\"postgresql\"}}@default(cuid()){{/if}}{{#if prismaProvider!=\"postgresql\"}}@default(uuid()){{/if}}\n  expiresAt DateTime\n  token     String   @unique\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n}\n{{/if}}"
+    },
+    {
+      "type": "create-file",
+      "source": "prisma.config.ts",
+      "destination": "prisma.config.ts"
+    },
+    {
+      "type": "create-file",
+      "source": "lib/prisma.ts",
+      "destination": "{{lib}}/prisma.ts"
+    },
+    {
+      "type": "create-file",
+      "destination": "prisma/seed.ts",
+      "condition": { "features": ["seed"] },
+      "content": "import { PrismaClient } from '@prisma/client'\n\nconst prisma = new PrismaClient()\n\nasync function main() {\n  // Create a default user\n  const user = await prisma.user.upsert({\n    where: { email: 'admin@example.com' },\n    update: {},\n    create: {\n      email: 'admin@example.com',\n      name: 'Admin User',\n      role: 'ADMIN',\n    },\n  })\n  console.log('Created user:', user)\n}\n\nmain()\n  .then(async () => {\n    await prisma.$disconnect()\n  })\n  .catch(async (e) => {\n    console.error(e)\n    await prisma.$disconnect()\n    process.exit(1)\n  })"
+    }
+  ],
+  "dependencies": {
+    "prisma": "^7.2.0",
+    "@prisma/client": "^7.2.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "prisma": "^7.2.0"
+  },
+  "scripts": {
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:seed": "tsx prisma/seed.ts",
+    "db:migrate": "prisma migrate dev",
+    "db:studio": "prisma studio"
+  },
+  "envVars": {
+    "DATABASE_URL": "postgresql://username:password@localhost:5432/database_name"
+  }
+}

package/modules/database/prisma/module.json

@@ -5,136 +5,10 @@
   "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}}",
-        "description": "Database connection URL",
-        "required": true
-      }
-    ],
-    "providers": {
-      "mysql": [
-        {
-          "key": "DATABASE_HOST",
-          "value": "localhost",
-          "description": "MySQL host",
-          "required": true
-        },
-        {
-          "key": "DATABASE_USER",
-          "value": "",
-          "description": "MySQL username",
-          "required": true
-        },
-        {
-          "key": "DATABASE_PASSWORD",
-          "value": "",
-          "description": "MySQL password",
-          "required": true
-        },
-        {
-          "key": "DATABASE_NAME",
-          "value": "mydb",
-          "description": "MySQL database name",
-          "required": true
-        },
-        {
-          "key": "DATABASE_PORT",
-          "value": "3306",
-          "description": "MySQL port",
-          "required": false
-        }
-      ]
-    }
-  },
-  "frameworkPatches": {
-    "express": {
-      "tsconfig.json": {
-        "merge": {
-          "compilerOptions": {
-            "baseUrl": ".",
-            "paths": {
-              "@/*": ["./src/*"]
-            }
-          },
-          "include": ["src/**/*"],
-          "exclude": ["node_modules", "dist", "prisma/migrations"]
-        }
-      }
-    },
-    "nextjs": {
-      "tsconfig.json": {
-        "merge": {
-          "compilerOptions": {
-            "paths": {
-              "@/*": ["./*"]
-            }
-          },
-          "exclude": ["node_modules", ".next", "out", "prisma/migrations"]
-        }
-      }
-    }
-  },
-  "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": "Create Prisma client singleton",
-      "source": "lib/prisma.ts",
-      "destination": "{{lib}}/prisma.ts"
-    }
-  ],
-  "postInstall": ["npx prisma generate"]
+  "compatibility": {
+    "frameworks": ["nextjs", "express"],
+    "databases": ["prisma"],
+    "languages": ["typescript", "javascript"],
+    "packageManagers": ["npm", "yarn", "pnpm", "bun"]
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stackkit-app",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Create a new StackKit project with modular composition",
   "main": "dist/index.js",
   "bin": {

package/templates/express/.env.example

@@ -1,3 +1,2 @@
-# APP CONFIGURATION
 PORT=3000
 NODE_ENV=development

package/templates/express/package.json

@@ -22,12 +22,12 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/morgan": "^1.9.10",
-    "@types/node": "^25.0.6",
-    "@typescript-eslint/eslint-plugin": "^8.52.0",
-    "@typescript-eslint/parser": "^8.52.0",
+    "@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",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }
-}
+}

package/templates/express/src/app.ts

@@ -3,7 +3,7 @@ import express, { Application, NextFunction, Request, Response } from "express";
 import helmet from "helmet";
 import morgan from "morgan";
 import { env } from "./config/env";
-import { authRoutes } from "./features/auth/auth.route";
+import { authRoutes } from "./features/health/health.route";
 import { errorHandler } from "./middlewares/error.middleware";
 
 // app initialization
@@ -35,7 +35,7 @@ app.get("/", (_req: Request, res: Response) => {
 });
 
 // routes
-app.use("/api/auth", authRoutes);
+app.use("/api/health", authRoutes);
 
 // unhandled routes
 app.use((req: Request, _res: Response, next: NextFunction) => {

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/template.json

@@ -1,8 +1,12 @@
 {
-  "name": "express-base",
+  "name": "express",
   "displayName": "Express.js",
   "framework": "express",
   "description": "Express.js REST API with TypeScript",
+  "compatibility": {
+    "databases": ["prisma", "mongoose"],
+    "auth": ["better-auth"]
+  },
   "files": ["src/", ".gitignore", "package.json", "tsconfig.json", ".env.example"],
   "scripts": {
     "dev": "tsx watch src/server.ts",
@@ -19,22 +23,5 @@
     "lint:fix": "eslint src --ext .js --fix",
     "start": "node src/server.js",
     "start:prod": "cross-env NODE_ENV=production node src/server.js"
-  },
-  "fileReplacements": [
-    {
-      "file": "src/server.js",
-      "from": "import app from './app'",
-      "to": "import app from './app.js'"
-    },
-    {
-      "file": "src/app.js",
-      "from": "import { env } from './config/env'",
-      "to": "import { env } from './config/env.js'"
-    },
-    {
-      "file": "src/app.js",
-      "from": "import { errorHandler } from './middlewares/error.middleware'",
-      "to": "import { errorHandler } from './middlewares/error.middleware.js'"
-    }
-  ]
+  }
 }

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/nextjs/template.json

@@ -1,8 +1,12 @@
 {
-  "name": "nextjs-base",
+  "name": "nextjs",
   "displayName": "Next.js",
   "framework": "nextjs",
   "description": "Next.js 16 App Router with TypeScript",
+  "compatibility": {
+    "databases": ["prisma", "mongoose"],
+    "auth": ["better-auth", "authjs"]
+  },
   "files": [
     "app/",
     "public/",

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"
+}