create-stackkit-app 0.3.0 → 0.4.0

package/modules/auth/better-auth-nextjs/files/lib/auth.ts

@@ -0,0 +1,26 @@
+import { prismaAdapter } from '@better-auth/prisma';
+import { betterAuth } from 'better-auth';
+import { prisma } from './db';
+
+export const auth = betterAuth({
+  database: prismaAdapter(prisma, {
+    provider: 'postgresql', // Change to 'mongodb' if using MongoDB
+  }),
+  emailAndPassword: {
+    enabled: true,
+  },
+  socialProviders: {
+    // Uncomment to add OAuth providers
+    // google: {
+    //   clientId: process.env.GOOGLE_CLIENT_ID!,
+    //   clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+    // },
+    // github: {
+    //   clientId: process.env.GITHUB_CLIENT_ID!,
+    //   clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+    // },
+  },
+});
+
+export type Session = typeof auth.$Infer.Session;
+export type User = typeof auth.$Infer.User;

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

@@ -0,0 +1,41 @@
+{
+  "name": "auth",
+  "displayName": "Better Auth (Next.js)",
+  "description": "Modern authentication with Better Auth for Next.js App Router",
+  "category": "auth",
+  "provider": "better-auth",
+  "supportedFrameworks": ["nextjs"],
+  "compatibleDatabases": ["prisma-postgresql", "prisma-mongodb"],
+  "dependencies": {
+    "better-auth": "^1.1.4",
+    "@better-auth/prisma": "^1.1.4"
+  },
+  "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": "lib/auth.ts",
+      "destination": "{{lib}}/auth.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Better Auth API route handler",
+      "source": "app/api/auth/[...all]/route.ts",
+      "destination": "{{router}}/api/auth/[...all]/route.ts"
+    }
+  ]
+}

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

@@ -0,0 +1,9 @@
+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',
+});
+
+// Export specific methods for convenience
+export const { signIn, signUp, signOut, useSession } = authClient;

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

@@ -0,0 +1,26 @@
+{
+  "name": "auth",
+  "displayName": "Better Auth (React)",
+  "description": "Client-side authentication with Better Auth for React",
+  "category": "auth",
+  "supportedFrameworks": ["react", "react-vite"],
+  "dependencies": {
+    "better-auth": "^1.0.0"
+  },
+  "envVars": [
+    {
+      "key": "VITE_AUTH_URL",
+      "value": "http://localhost:3000",
+      "description": "Base URL of your auth server (optional if same domain)",
+      "required": false
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Better Auth client configuration",
+      "source": "lib/auth-client.ts",
+      "destination": "src/lib/auth-client.ts"
+    }
+  ]
+}

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

@@ -0,0 +1,7 @@
+import { clerkClient, clerkMiddleware, requireAuth } from '@clerk/express';
+
+export { clerkMiddleware, requireAuth };
+
+export async function getCurrentUser(userId: string) {
+  return await clerkClient.users.getUser(userId);
+}

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

@@ -0,0 +1,19 @@
+{
+  "name": "clerk-express",
+  "description": "Clerk Authentication for Express.js",
+  "category": "auth",
+  "framework": "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": [
+    {
+      "source": "files/lib/auth.ts",
+      "destination": "lib/auth.ts"
+    }
+  ]
+}

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

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

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

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

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

@@ -0,0 +1,27 @@
+{
+  "name": "clerk-nextjs",
+  "description": "Clerk Authentication for Next.js",
+  "category": "auth",
+  "framework": "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": [
+    {
+      "source": "files/lib/auth-provider.tsx",
+      "destination": "lib/auth-provider.tsx"
+    },
+    {
+      "source": "files/middleware.ts",
+      "destination": "middleware.ts"
+    }
+  ]
+}

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

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

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

@@ -0,0 +1,18 @@
+{
+  "name": "clerk-react",
+  "description": "Clerk Authentication for React",
+  "category": "auth",
+  "framework": "react-vite",
+  "dependencies": {
+    "@clerk/clerk-react": "^5.19.2"
+  },
+  "env": {
+    "VITE_CLERK_PUBLISHABLE_KEY": "pk_test_your_key_here"
+  },
+  "files": [
+    {
+      "source": "files/lib/auth-provider.tsx",
+      "destination": "lib/auth-provider.tsx"
+    }
+  ]
+}

package/modules/auth/nextauth/files/app-router/api/auth/[...nextauth]/route.ts

@@ -0,0 +1,6 @@
+import { authOptions } from '@/lib/auth';
+import NextAuth from 'next-auth';
+
+const handler = NextAuth(authOptions);
+
+export { handler as GET, handler as POST };

package/modules/auth/nextauth/files/lib/auth.ts

@@ -0,0 +1,82 @@
+import { AuthOptions } from 'next-auth';
+import CredentialsProvider from 'next-auth/providers/credentials';
+
+/**
+ * NextAuth.js Configuration
+ *
+ * Configure authentication providers and options here.
+ * See: https://next-auth.js.org/configuration/options
+ */
+export const authOptions: AuthOptions = {
+  providers: [
+    // GitHub OAuth Provider
+    // Uncomment and add GITHUB_ID and GITHUB_SECRET to .env
+    // GithubProvider({
+    //   clientId: process.env.GITHUB_ID!,
+    //   clientSecret: process.env.GITHUB_SECRET!,
+    // }),
+
+    // Google OAuth Provider
+    // Uncomment and add GOOGLE_ID and GOOGLE_SECRET to .env
+    // GoogleProvider({
+    //   clientId: process.env.GOOGLE_ID!,
+    //   clientSecret: process.env.GOOGLE_SECRET!,
+    // }),
+
+    // Credentials Provider (email/password)
+    // Replace with your own authentication logic
+    CredentialsProvider({
+      name: 'Credentials',
+      credentials: {
+        email: { label: 'Email', type: 'email', placeholder: 'user@example.com' },
+        password: { label: 'Password', type: 'password' },
+      },
+      async authorize(credentials) {
+        // Add your own authentication logic here
+        // This is just a demo - DO NOT use in production
+        if (credentials?.email === 'demo@example.com' && credentials?.password === 'demo') {
+          return {
+            id: '1',
+            name: 'Demo User',
+            email: 'demo@example.com',
+          };
+        }
+        return null;
+      },
+    }),
+  ],
+
+  // Database adapter (optional)
+  // Uncomment to persist sessions in database
+  // adapter: PrismaAdapter(prisma),
+
+  session: {
+    strategy: 'jwt',
+  },
+
+  pages: {
+    signIn: '/auth/signin',
+    // signOut: '/auth/signout',
+    // error: '/auth/error',
+    // verifyRequest: '/auth/verify-request',
+    // newUser: '/auth/new-user'
+  },
+
+  callbacks: {
+    async jwt({ token, user }) {
+      if (user) {
+        token.id = user.id;
+      }
+      return token;
+    },
+    async session({ session, token }) {
+      if (session.user) {
+        session.user.id = token.id as string;
+      }
+      return session;
+    },
+  },
+
+  // Enable debug messages in development
+  debug: process.env.NODE_ENV === 'development',
+};

package/modules/auth/nextauth/files/pages-router/api/auth/[...nextauth].ts

@@ -0,0 +1,4 @@
+import { authOptions } from '@/lib/auth';
+import NextAuth from 'next-auth';
+
+export default NextAuth(authOptions);

package/modules/auth/nextauth/module.json

@@ -0,0 +1,50 @@
+{
+  "name": "auth",
+  "displayName": "NextAuth.js Authentication",
+  "description": "Add authentication with NextAuth.js (supports multiple providers)",
+  "category": "auth",
+  "supportedFrameworks": ["nextjs"],
+  "dependencies": {
+    "next-auth": "^4.24.5"
+  },
+  "envVars": [
+    {
+      "key": "NEXTAUTH_URL",
+      "value": "http://localhost:3000",
+      "description": "The URL of your application (change in production)",
+      "required": true
+    },
+    {
+      "key": "NEXTAUTH_SECRET",
+      "value": "",
+      "description": "Secret for encrypting tokens. Generate with: openssl rand -base64 32",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create NextAuth API route for App Router",
+      "source": "app-router/api/auth/[...nextauth]/route.ts",
+      "destination": "{{router}}/api/auth/[...nextauth]/route.ts",
+      "condition": {
+        "router": "app"
+      }
+    },
+    {
+      "type": "create-file",
+      "description": "Create NextAuth API route for Pages Router",
+      "source": "pages-router/api/auth/[...nextauth].ts",
+      "destination": "{{router}}/api/auth/[...nextauth].ts",
+      "condition": {
+        "router": "pages"
+      }
+    },
+    {
+      "type": "create-file",
+      "description": "Create auth configuration",
+      "source": "lib/auth.ts",
+      "destination": "{{lib}}/auth.ts"
+    }
+  ]
+}

package/modules/database/drizzle-postgresql/files/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './lib/schema.ts',
+  out: './drizzle',
+  dialect: 'postgresql',
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});

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

@@ -0,0 +1,7 @@
+import { drizzle } from 'drizzle-orm/postgres-js';
+import postgres from 'postgres';
+
+const connectionString = process.env.DATABASE_URL!;
+
+export const client = postgres(connectionString, { prepare: false });
+export const db = drizzle(client);

package/modules/database/drizzle-postgresql/files/lib/schema.ts

@@ -0,0 +1,8 @@
+import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
+
+export const users = pgTable('users', {
+  id: serial('id').primaryKey(),
+  name: text('name').notNull(),
+  email: text('email').notNull().unique(),
+  createdAt: timestamp('created_at').defaultNow(),
+});

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

@@ -0,0 +1,34 @@
+{
+  "name": "drizzle-postgresql",
+  "description": "Drizzle ORM with PostgreSQL",
+  "category": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.36.4",
+    "postgres": "^3.4.5"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.28.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "env": {
+    "DATABASE_URL": "postgresql://postgres:password@localhost:5432/myapp"
+  },
+  "files": [
+    {
+      "source": "files/lib/db.ts",
+      "destination": "lib/db.ts"
+    },
+    {
+      "source": "files/lib/schema.ts",
+      "destination": "lib/schema.ts"
+    },
+    {
+      "source": "files/drizzle.config.ts",
+      "destination": "drizzle.config.ts"
+    }
+  ]
+}

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

@@ -0,0 +1,40 @@
+import mongoose from 'mongoose';
+
+const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://localhost:27017/myapp';
+
+if (!MONGODB_URI) {
+  throw new Error('Please define the MONGODB_URI environment variable');
+}
+
+let cached = global.mongoose;
+
+if (!cached) {
+  cached = global.mongoose = { conn: null, promise: null };
+}
+
+async function connectDB() {
+  if (cached.conn) {
+    return cached.conn;
+  }
+
+  if (!cached.promise) {
+    const opts = {
+      bufferCommands: false,
+    };
+
+    cached.promise = mongoose.connect(MONGODB_URI, opts).then((mongoose) => {
+      return mongoose;
+    });
+  }
+
+  try {
+    cached.conn = await cached.promise;
+  } catch (e) {
+    cached.promise = null;
+    throw e;
+  }
+
+  return cached.conn;
+}
+
+export default connectDB;

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

@@ -0,0 +1,17 @@
+{
+  "name": "mongoose-mongodb",
+  "description": "Mongoose ODM for MongoDB",
+  "category": "database",
+  "dependencies": {
+    "mongoose": "^8.8.4"
+  },
+  "env": {
+    "MONGODB_URI": "mongodb://localhost:27017/myapp"
+  },
+  "files": [
+    {
+      "source": "files/lib/db.ts",
+      "destination": "lib/db.ts"
+    }
+  ]
+}

package/{templates/databases/prisma-mongodb → modules/database/prisma-mongodb/files}/lib/db.ts

@@ -4,10 +4,6 @@ const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined;
 };
 
-export const prisma =
-  globalForPrisma.prisma ??
-  new PrismaClient({
-    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
-  });
+export const db = globalForPrisma.prisma ?? new PrismaClient();
 
-if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;

package/{templates/databases/prisma-mongodb → modules/database/prisma-mongodb/files}/prisma/schema.prisma

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

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

@@ -0,0 +1,36 @@
+{
+  "name": "database",
+  "displayName": "Prisma + MongoDB",
+  "description": "Add Prisma ORM with MongoDB database",
+  "category": "database",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.1.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.1.0"
+  },
+  "envVars": [
+    {
+      "key": "DATABASE_URL",
+      "value": "mongodb://localhost:27017/mydb",
+      "description": "MongoDB connection URL",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Prisma schema for MongoDB",
+      "source": "prisma/schema.prisma",
+      "destination": "prisma/schema.prisma"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Prisma client singleton",
+      "source": "lib/db.ts",
+      "destination": "{{lib}}/db.ts"
+    }
+  ],
+  "postInstall": ["npx prisma generate"]
+}

package/{templates/databases/prisma-postgresql → modules/database/prisma-postgresql/files}/lib/db.ts

@@ -4,10 +4,6 @@ const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined;
 };
 
-export const prisma =
-  globalForPrisma.prisma ??
-  new PrismaClient({
-    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
-  });
+export const db = globalForPrisma.prisma ?? new PrismaClient();
 
-if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;

package/{templates/databases/prisma-postgresql → modules/database/prisma-postgresql/files}/prisma/schema.prisma

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

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

@@ -0,0 +1,36 @@
+{
+  "name": "database",
+  "displayName": "Prisma + PostgreSQL",
+  "description": "Add Prisma ORM with PostgreSQL database",
+  "category": "database",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.1.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.1.0"
+  },
+  "envVars": [
+    {
+      "key": "DATABASE_URL",
+      "value": "postgresql://user:password@localhost:5432/mydb?schema=public",
+      "description": "PostgreSQL database connection URL",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Prisma schema",
+      "source": "prisma/schema.prisma",
+      "destination": "prisma/schema.prisma"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Prisma client singleton",
+      "source": "lib/db.ts",
+      "destination": "{{lib}}/db.ts"
+    }
+  ],
+  "postInstall": ["npx prisma generate"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stackkit-app",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Create a new StackKit project with modular composition",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,8 @@
   "files": [
     "dist",
     "bin",
-    "templates"
+    "templates",
+    "modules"
   ],
   "repository": {
     "type": "git",
@@ -23,10 +24,11 @@
   },
   "scripts": {
     "dev": "tsc --watch",
-    "build": "tsc",
-    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc && npm run copy-assets",
+    "copy-assets": "cp -r ../../templates . && cp -r ../../modules .",
+    "clean": "rm -rf dist templates modules",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && cp -r ../../templates ."
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "create",