create-stackkit-app 0.4.1 → 0.4.3

package/modules/auth/better-auth-react/files/lib/auth-client.ts

@@ -1,8 +1,8 @@
-import { createAuthClient } from 'better-auth/react';
+import { createAuthClient } from "better-auth/react";
 
 export const authClient = createAuthClient({
   /** The base URL of the server (optional if you're using the same domain) */
-  baseURL: import.meta.env.VITE_AUTH_URL || 'http://localhost:3000',
+  baseURL: import.meta.env.VITE_AUTH_URL || "http://localhost:3000",
 });
 
 // Export specific methods for convenience

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

@@ -1,18 +1,20 @@
 {
-  "name": "auth",
+  "name": "better-auth-react",
   "displayName": "Better Auth (React)",
   "description": "Client-side authentication with Better Auth for React",
   "category": "auth",
-  "supportedFrameworks": ["react", "react-vite"],
+  "provider": "better-auth",
+  "supportedFrameworks": ["react-vite"],
   "dependencies": {
-    "better-auth": "^1.0.0"
+    "better-auth": "^1.1.4"
   },
+  "devDependencies": {},
   "envVars": [
     {
       "key": "VITE_AUTH_URL",
       "value": "http://localhost:3000",
-      "description": "Base URL of your auth server (optional if same domain)",
-      "required": false
+      "description": "Base URL of your auth server",
+      "required": true
     }
   ],
   "patches": [

package/modules/auth/clerk-express/files/lib/auth.ts

@@ -1,4 +1,4 @@
-import { clerkClient, clerkMiddleware, requireAuth } from '@clerk/express';
+import { clerkClient, clerkMiddleware, requireAuth } from "@clerk/express";
 
 export { clerkMiddleware, requireAuth };
 

package/modules/auth/clerk-express/module.json

@@ -1,19 +1,34 @@
 {
   "name": "clerk-express",
+  "displayName": "Clerk (Express)",
   "description": "Clerk Authentication for Express.js",
   "category": "auth",
-  "framework": "express",
+  "provider": "clerk",
+  "supportedFrameworks": ["express"],
   "dependencies": {
     "@clerk/express": "^1.4.5"
   },
-  "env": {
-    "CLERK_PUBLISHABLE_KEY": "pk_test_your_key_here",
-    "CLERK_SECRET_KEY": "sk_test_your_key_here"
-  },
-  "files": [
+  "devDependencies": {},
+  "envVars": [
+    {
+      "key": "CLERK_PUBLISHABLE_KEY",
+      "value": "",
+      "description": "Clerk publishable key (from Clerk dashboard)",
+      "required": true
+    },
+    {
+      "key": "CLERK_SECRET_KEY",
+      "value": "",
+      "description": "Clerk secret key (from Clerk dashboard)",
+      "required": true
+    }
+  ],
+  "patches": [
     {
-      "source": "files/lib/auth.ts",
-      "destination": "lib/auth.ts"
+      "type": "create-file",
+      "description": "Create Clerk auth middleware",
+      "source": "lib/auth.ts",
+      "destination": "{{lib}}/auth.ts"
     }
   ]
 }

package/modules/auth/clerk-nextjs/files/lib/auth-provider.tsx

@@ -1,4 +1,4 @@
-import { ClerkProvider } from '@clerk/nextjs';
+import { ClerkProvider } from "@clerk/nextjs";
 
 export function AuthProvider({ children }: { children: React.ReactNode }) {
   return <ClerkProvider>{children}</ClerkProvider>;

package/modules/auth/clerk-nextjs/files/middleware.ts

@@ -1,9 +1,9 @@
-import { authMiddleware } from '@clerk/nextjs';
+import { authMiddleware } from "@clerk/nextjs";
 
 export default authMiddleware({
-  publicRoutes: ['/'],
+  publicRoutes: ["/"],
 });
 
 export const config = {
-  matcher: ['/((?!.+\\.[\\w]+$|_next).*)', '/', '/(api|trpc)(.*)'],
+  matcher: ["/((?!.+\\.[\\w]+$|_next).*)", "/", "/(api|trpc)(.*)"],
 };

package/modules/auth/clerk-nextjs/module.json

@@ -1,26 +1,63 @@
 {
   "name": "clerk-nextjs",
-  "description": "Clerk Authentication for Next.js",
+  "displayName": "Clerk (Next.js)",
+  "description": "Clerk Authentication for Next.js App Router",
   "category": "auth",
-  "framework": "nextjs",
+  "provider": "clerk",
+  "supportedFrameworks": ["nextjs"],
   "dependencies": {
     "@clerk/nextjs": "^6.10.2"
   },
-  "env": {
-    "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY": "pk_test_your_key_here",
-    "CLERK_SECRET_KEY": "sk_test_your_key_here",
-    "NEXT_PUBLIC_CLERK_SIGN_IN_URL": "/sign-in",
-    "NEXT_PUBLIC_CLERK_SIGN_UP_URL": "/sign-up",
-    "NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL": "/",
-    "NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL": "/"
-  },
-  "files": [
+  "devDependencies": {},
+  "envVars": [
+    {
+      "key": "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY",
+      "value": "",
+      "description": "Clerk publishable key (from Clerk dashboard)",
+      "required": true
+    },
+    {
+      "key": "CLERK_SECRET_KEY",
+      "value": "",
+      "description": "Clerk secret key (from Clerk dashboard)",
+      "required": true
+    },
+    {
+      "key": "NEXT_PUBLIC_CLERK_SIGN_IN_URL",
+      "value": "/sign-in",
+      "description": "Sign in page URL",
+      "required": true
+    },
+    {
+      "key": "NEXT_PUBLIC_CLERK_SIGN_UP_URL",
+      "value": "/sign-up",
+      "description": "Sign up page URL",
+      "required": true
+    },
+    {
+      "key": "NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL",
+      "value": "/",
+      "description": "Redirect URL after sign in",
+      "required": true
+    },
+    {
+      "key": "NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL",
+      "value": "/",
+      "description": "Redirect URL after sign up",
+      "required": true
+    }
+  ],
+  "patches": [
     {
-      "source": "files/lib/auth-provider.tsx",
-      "destination": "lib/auth-provider.tsx"
+      "type": "create-file",
+      "description": "Create Clerk auth provider",
+      "source": "lib/auth-provider.tsx",
+      "destination": "{{lib}}/auth-provider.tsx"
     },
     {
-      "source": "files/middleware.ts",
+      "type": "create-file",
+      "description": "Create Clerk middleware",
+      "source": "middleware.ts",
       "destination": "middleware.ts"
     }
   ]

package/modules/auth/clerk-react/files/lib/auth-provider.tsx

@@ -1,9 +1,9 @@
-import { ClerkProvider } from '@clerk/clerk-react';
+import { ClerkProvider } from "@clerk/clerk-react";
 
 const publishableKey = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY;
 
 if (!publishableKey) {
-  throw new Error('Missing Publishable Key');
+  throw new Error("Missing Publishable Key");
 }
 
 export function AuthProvider({ children }: { children: React.ReactNode }) {

package/modules/auth/clerk-react/module.json

@@ -1,18 +1,28 @@
 {
   "name": "clerk-react",
+  "displayName": "Clerk (React)",
   "description": "Clerk Authentication for React",
   "category": "auth",
-  "framework": "react-vite",
+  "provider": "clerk",
+  "supportedFrameworks": ["react-vite"],
   "dependencies": {
     "@clerk/clerk-react": "^5.19.2"
   },
-  "env": {
-    "VITE_CLERK_PUBLISHABLE_KEY": "pk_test_your_key_here"
-  },
-  "files": [
+  "devDependencies": {},
+  "envVars": [
+    {
+      "key": "VITE_CLERK_PUBLISHABLE_KEY",
+      "value": "",
+      "description": "Clerk publishable key (from Clerk dashboard)",
+      "required": true
+    }
+  ],
+  "patches": [
     {
-      "source": "files/lib/auth-provider.tsx",
-      "destination": "lib/auth-provider.tsx"
+      "type": "create-file",
+      "description": "Create Clerk auth provider",
+      "source": "lib/auth-provider.tsx",
+      "destination": "src/lib/auth-provider.tsx"
     }
   ]
 }

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

@@ -1,9 +1,9 @@
-import mongoose from 'mongoose';
+import mongoose from "mongoose";
 
-const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://localhost:27017/myapp';
+const MONGODB_URI = process.env.MONGODB_URI || "mongodb://localhost:27017/myapp";
 
 if (!MONGODB_URI) {
-  throw new Error('Please define the MONGODB_URI environment variable');
+  throw new Error("Please define the MONGODB_URI environment variable");
 }
 
 let cached = global.mongoose;

package/modules/database/mongoose-mongodb/module.json

@@ -1,17 +1,55 @@
 {
   "name": "mongoose-mongodb",
-  "description": "Mongoose ODM for MongoDB",
+  "displayName": "Mongoose + MongoDB",
+  "description": "Mongoose ODM for MongoDB database",
   "category": "database",
+  "provider": "mongoose",
+  "database": "mongodb",
+  "supportedFrameworks": ["nextjs", "express"],
   "dependencies": {
     "mongoose": "^8.8.4"
   },
-  "env": {
-    "MONGODB_URI": "mongodb://localhost:27017/myapp"
+  "devDependencies": {},
+  "envVars": [
+    {
+      "key": "MONGODB_URI",
+      "value": "mongodb://localhost:27017/myapp",
+      "description": "MongoDB connection string",
+      "required": true
+    }
+  ],
+  "frameworkPatches": {
+    "express": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "paths": {
+              "@/*": ["./src/*"],
+              "@/models/*": ["./src/models/*"]
+            }
+          },
+          "include": ["src/**/*", "src/models/**/*"]
+        }
+      }
+    },
+    "nextjs": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "paths": {
+              "@/models/*": ["./models/*"]
+            }
+          }
+        }
+      }
+    }
   },
-  "files": [
+  "patches": [
     {
-      "source": "files/lib/db.ts",
-      "destination": "lib/db.ts"
+      "type": "create-file",
+      "description": "Create MongoDB connection with Mongoose",
+      "source": "lib/db.ts",
+      "destination": "{{lib}}/db.ts"
     }
   ]
 }

package/modules/database/prisma-mongodb/files/lib/db.ts

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

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

@@ -7,7 +7,7 @@ datasource db {
     url      = env("DATABASE_URL")
 }
 
-// Example model - customize as needed
+// Example model - customize based on your auth provider
 model User {
     id        String   @id @default(auto()) @map("_id") @db.ObjectId
     email     String   @unique

package/modules/database/prisma-mongodb/module.json

@@ -1,8 +1,10 @@
 {
-  "name": "database",
+  "name": "prisma-mongodb",
   "displayName": "Prisma + MongoDB",
-  "description": "Add Prisma ORM with MongoDB database",
+  "description": "Prisma ORM with MongoDB database",
   "category": "database",
+  "provider": "prisma",
+  "database": "mongodb",
   "supportedFrameworks": ["nextjs", "express"],
   "dependencies": {
     "@prisma/client": "^6.1.0"
@@ -18,17 +20,39 @@
       "required": true
     }
   ],
+  "frameworkPatches": {
+    "express": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "paths": {
+              "@/*": ["./src/*"]
+            }
+          },
+          "include": ["src/**/*"],
+          "exclude": ["node_modules", "dist", "prisma/migrations"]
+        }
+      }
+    },
+    "nextjs": {
+      "tsconfig.json": {
+        "merge": {
+          "exclude": ["node_modules", ".next", "out", "prisma/migrations"]
+        }
+      }
+    }
+  },
   "patches": [
     {
       "type": "create-file",
       "description": "Create Prisma schema for MongoDB",
-      "source": "prisma/schema.prisma",
+      "source": "files/prisma/schema.prisma",
       "destination": "prisma/schema.prisma"
     },
     {
       "type": "create-file",
       "description": "Create Prisma client singleton",
-      "source": "lib/db.ts",
+      "source": "files/lib/db.ts",
       "destination": "{{lib}}/db.ts"
     }
   ],

package/modules/database/prisma-postgresql/files/lib/db.ts

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

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

@@ -7,7 +7,7 @@ datasource db {
     url      = env("DATABASE_URL")
 }
 
-// Example model - customize as needed
+// Example model - customize based on your auth provider
 model User {
     id        String   @id @default(cuid())
     email     String   @unique

package/modules/database/prisma-postgresql/module.json

@@ -1,8 +1,10 @@
 {
-  "name": "database",
+  "name": "prisma-postgresql",
   "displayName": "Prisma + PostgreSQL",
-  "description": "Add Prisma ORM with PostgreSQL database",
+  "description": "Prisma ORM with PostgreSQL database",
   "category": "database",
+  "provider": "prisma",
+  "database": "postgresql",
   "supportedFrameworks": ["nextjs", "express"],
   "dependencies": {
     "@prisma/client": "^6.1.0"
@@ -18,17 +20,39 @@
       "required": true
     }
   ],
+  "frameworkPatches": {
+    "express": {
+      "tsconfig.json": {
+        "merge": {
+          "compilerOptions": {
+            "paths": {
+              "@/*": ["./src/*"]
+            }
+          },
+          "include": ["src/**/*"],
+          "exclude": ["node_modules", "dist", "prisma/migrations"]
+        }
+      }
+    },
+    "nextjs": {
+      "tsconfig.json": {
+        "merge": {
+          "exclude": ["node_modules", ".next", "out", "prisma/migrations"]
+        }
+      }
+    }
+  },
   "patches": [
     {
       "type": "create-file",
       "description": "Create Prisma schema",
-      "source": "prisma/schema.prisma",
+      "source": "files/prisma/schema.prisma",
       "destination": "prisma/schema.prisma"
     },
     {
       "type": "create-file",
       "description": "Create Prisma client singleton",
-      "source": "lib/db.ts",
+      "source": "files/lib/db.ts",
       "destination": "{{lib}}/db.ts"
     }
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stackkit-app",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Create a new StackKit project with modular composition",
   "main": "dist/index.js",
   "bin": {
@@ -51,6 +51,11 @@
     "@types/inquirer": "^9.0.7",
     "@types/node": "^20.11.0",
     "@types/validate-npm-package-name": "^4.0.2",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "recast": "^0.20.5",
+    "@babel/core": "^7.28.5",
+    "@babel/plugin-transform-typescript": "^7.28.5",
+    "@babel/parser": "^7.28.5",
+    "@babel/plugin-transform-react-jsx": "^7.27.1"
   }
-}
+}

package/templates/express/.env.example

@@ -0,0 +1,11 @@
+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

package/templates/express/eslint.config.cjs

@@ -0,0 +1,42 @@
+module.exports = [
+  // Global ignores
+  {
+    ignores: ['**/node_modules/**', '**/dist/**', '.env'],
+  },
+
+  // TypeScript files
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: require('@typescript-eslint/parser'),
+      parserOptions: {
+        project: './tsconfig.json',
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': require('@typescript-eslint/eslint-plugin'),
+    },
+    rules: {
+      'prefer-const': 'error',
+      'no-console': 'off',
+      eqeqeq: ['error', 'always'],
+      curly: ['error', 'multi-line'],
+      'no-implicit-coercion': ['warn', { allow: ['!!'] }],
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^(?:_|next)$' }],
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+
+  // JavaScript files
+  {
+    files: ['**/*.js'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    rules: {},
+  },
+];

package/templates/express/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "my-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",
+    "start": "node dist/server.js",
+    "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"
+  },
+  "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",
+    "eslint": "^9.39.2",
+    "rimraf": "^5.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/express/src/app.ts

@@ -0,0 +1,71 @@
+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 { 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) {
+  app.use(morgan("combined"));
+} else {
+  app.use(morgan("dev"));
+}
+
+// cors configuration
+app.use(
+  cors({
+    origin: [env.app.site_url],
+    credentials: true,
+  }),
+);
+
+// Home page route
+app.get("/", (req: Request, res: Response) => {
+  res.json({
+    title: "Welcome to your Express app",
+    description:
+      "Built with StackKit - A production-ready Express template with TypeScript, security, and best practices.",
+    version: "1.0.0",
+    docs: "https://github.com/tariqul420/stackkit",
+  });
+});
+
+// unhandled routes
+app.use((req: Request, res: Response, next: NextFunction) => {
+  const error: any = new Error(`Can't find ${req.originalUrl} on this server!`);
+  error.status = 404;
+
+  next(error);
+});
+
+// Global error handler
+app.use(errorHandler);
+
+export default app;