create-stackkit-app 0.3.1 → 0.4.0

package/README.md

@@ -1,107 +1,25 @@
 # create-stackkit-app
 
-Production-ready project generator with interactive wizard setup.
-
-[![npm](https://img.shields.io/npm/v/create-stackkit-app)](https://www.npmjs.com/package/create-stackkit-app)
+Create production-ready projects with one command.
 
 ## Usage
 
 ```bash
-# npm
-npx create-stackkit-app@latest my-app
-
-# pnpm
-pnpm dlx create-stackkit-app@latest my-app
-
-# yarn
-yarn dlx create-stackkit-app@latest my-app
-
-# bun
-bunx create-stackkit-app@latest my-app
-```
-
-## Interactive Wizard
-
-The wizard guides you through project setup:
-
-1. **Framework Selection**
-   - Next.js
-   - Express.js
-   - React (Vite)
-   - Astro
-
-2. **Database/ORM**
-   - Prisma + PostgreSQL
-   - Prisma + MongoDB
-   - Mongoose + MongoDB
-   - Drizzle + PostgreSQL
-   - None
-
-3. **Authentication**
-   - Auth.js (NextAuth)
-   - Better Auth
-   - Clerk
-   - None
-
-4. **Language**
-   - TypeScript _(recommended)_
-   - JavaScript
-
-5. **Package Manager**
-   - pnpm _(recommended)_
-   - npm
-   - yarn
-
-## Automatic Setup
-
-After answering questions, the tool automatically:
-
-✅ Creates project files  
-✅ Installs dependencies  
-✅ Initializes git repository
-
-No manual `npm install` or `git init` needed.
-
-## What's Included
-
-Default Next.js + Prisma + PostgreSQL template:
-
-- ⚡ Next.js 15 with App Router
-- 🛡️ TypeScript
-- 🗄️ Prisma ORM + PostgreSQL
-- 🎨 shadcn/ui components
-- 💅 Tailwind CSS
-- ✅ Zod validation
-- 🔧 ESLint + Prettier
-
-## Next Steps
-
-After creating your project:
-
-```bash
-cd my-app
-pnpm dev
+npx create-stackkit-app my-app
 ```
 
-Add modules to existing projects:
+Interactive wizard for:
+- **Framework**: Next.js, Express, React (Vite)
+- **Database**: Prisma, Drizzle, Mongoose, or none
+- **Auth**: Auth.js, Better Auth, Clerk, or none
+- **Language**: TypeScript or JavaScript
 
-```bash
-npx stackkit-cli add auth
-```
-
-## Full CLI
-
-For advanced features:
+## Development
 
 ```bash
-npm install -g stackkit-cli
-
-stackkit list    # View all templates/modules
-stackkit add auth
+pnpm install
+pnpm build
+npx . test-app
 ```
 
-See [stackkit-cli](https://www.npmjs.com/package/stackkit-cli) for details.
-
-## License
-
-MIT
+See [main README](../../README.md) for full documentation.

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -14,4 +14,3 @@ async function main() {
     }
 }
 main();
-//# sourceMappingURL=index.js.map

package/dist/lib/create-project.d.ts

@@ -1,2 +1 @@
 export declare function createProject(projectName?: string): Promise<void>;
-//# sourceMappingURL=create-project.d.ts.map

package/dist/lib/create-project.js

@@ -54,36 +54,30 @@ async function getProjectConfig(projectName) {
                 { name: 'Next.js', value: 'nextjs' },
                 { name: 'Express.js', value: 'express' },
                 { name: 'React (Vite)', value: 'react-vite' },
-                { name: 'Astro', value: 'astro' },
             ],
         },
         {
             type: 'list',
             name: 'database',
             message: 'Select database/ORM:',
-            choices: (answers) => {
-                // React apps don't need server-side database
-                if (answers.framework === 'react-vite') {
-                    return [{ name: 'None', value: 'none' }];
-                }
-                return [
-                    { name: 'Prisma + PostgreSQL', value: 'prisma-postgresql' },
-                    { name: 'Prisma + MongoDB', value: 'prisma-mongodb' },
-                    { name: 'Mongoose + MongoDB', value: 'mongoose-mongodb' },
-                    { name: 'Drizzle + PostgreSQL', value: 'drizzle-postgresql' },
-                    { name: 'None', value: 'none' },
-                ];
-            },
+            when: (answers) => answers.framework !== 'react-vite',
+            choices: [
+                { name: 'Prisma + PostgreSQL', value: 'prisma-postgresql' },
+                { name: 'Prisma + MongoDB', value: 'prisma-mongodb' },
+                { name: 'Mongoose + MongoDB', value: 'mongoose-mongodb' },
+                { name: 'Drizzle + PostgreSQL', value: 'drizzle-postgresql' },
+                { name: 'None', value: 'none' },
+            ],
         },
         {
             type: 'list',
             name: 'auth',
             message: 'Select authentication:',
             choices: (answers) => {
-                // React apps - client-side only
                 if (answers.framework === 'react-vite') {
                     return [
-                        { name: 'Better Auth (React)', value: 'better-auth-react' },
+                        { name: 'Better Auth', value: 'better-auth-react' },
+                        { name: 'Clerk', value: 'clerk-react' },
                         { name: 'None', value: 'none' },
                     ];
                 }
@@ -93,7 +87,7 @@ async function getProjectConfig(projectName) {
                         { name: 'Auth.js v5', value: 'authjs-nextjs' },
                         { name: 'NextAuth.js', value: 'nextauth' },
                         { name: 'Better Auth', value: 'better-auth-nextjs' },
-                        { name: 'Clerk', value: 'clerk' },
+                        { name: 'Clerk', value: 'clerk-nextjs' },
                         { name: 'None', value: 'none' },
                     ];
                 }
@@ -102,6 +96,7 @@ async function getProjectConfig(projectName) {
                     return [
                         { name: 'Auth.js', value: 'authjs-express' },
                         { name: 'Better Auth', value: 'better-auth-express' },
+                        { name: 'Clerk', value: 'clerk-express' },
                         { name: 'None', value: 'none' },
                     ];
                 }
@@ -130,7 +125,7 @@ async function getProjectConfig(projectName) {
     return {
         projectName: projectName || answers.projectName,
         framework: answers.framework,
-        database: answers.database,
+        database: answers.framework === 'react-vite' ? 'none' : answers.database,
         auth: answers.auth,
         language: answers.language,
         packageManager: answers.packageManager,
@@ -206,37 +201,51 @@ async function copyBaseFramework(templatesDir, targetDir, framework) {
     });
 }
 async function mergeDatabaseConfig(templatesDir, targetDir, database) {
-    const dbDir = path_1.default.join(templatesDir, 'databases', database);
-    if (!(await fs_extra_1.default.pathExists(dbDir))) {
-        console.warn(`Database template not found: ${database}`);
+    // Use modules directory (sibling to templates)
+    const modulesDir = path_1.default.join(templatesDir, '..', 'modules');
+    const dbModulePath = path_1.default.join(modulesDir, 'database', database);
+    if (!(await fs_extra_1.default.pathExists(dbModulePath))) {
+        console.warn(`Database module not found: ${database}`);
         return;
     }
-    // Read config
-    const configPath = path_1.default.join(dbDir, 'config.json');
-    if (!(await fs_extra_1.default.pathExists(configPath))) {
+    // Read module.json
+    const moduleJsonPath = path_1.default.join(dbModulePath, 'module.json');
+    if (!(await fs_extra_1.default.pathExists(moduleJsonPath))) {
         return;
     }
-    const config = await fs_extra_1.default.readJson(configPath);
-    // Copy database files
-    const entries = await fs_extra_1.default.readdir(dbDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.name === 'config.json')
-            continue;
-        const sourcePath = path_1.default.join(dbDir, entry.name);
-        const destPath = path_1.default.join(targetDir, entry.name);
-        if (entry.isDirectory()) {
-            await fs_extra_1.default.copy(sourcePath, destPath, { overwrite: false });
-        }
-        else {
-            await fs_extra_1.default.copy(sourcePath, destPath, { overwrite: false });
+    const moduleData = await fs_extra_1.default.readJson(moduleJsonPath);
+    // Copy files from module
+    const filesDir = path_1.default.join(dbModulePath, 'files');
+    if (await fs_extra_1.default.pathExists(filesDir)) {
+        // Copy files based on patches in module.json
+        for (const patch of moduleData.patches || []) {
+            if (patch.type === 'create-file') {
+                const sourceFile = path_1.default.join(filesDir, patch.source);
+                let destFile = path_1.default.join(targetDir, patch.destination);
+                // Simple placeholder replacement for lib
+                destFile = destFile.replace('{{lib}}', 'lib').replace('{{src}}', 'src');
+                if (await fs_extra_1.default.pathExists(sourceFile)) {
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(destFile));
+                    await fs_extra_1.default.copy(sourceFile, destFile, { overwrite: false });
+                }
+            }
         }
     }
-    // Merge package.json
-    await mergePackageJson(targetDir, config);
-    // Merge .env
-    await mergeEnvFile(targetDir, config.env || {});
+    // Merge package.json with module dependencies
+    await mergePackageJson(targetDir, {
+        dependencies: moduleData.dependencies,
+        devDependencies: moduleData.devDependencies,
+    });
+    // Merge .env with module envVars
+    const envVars = {};
+    for (const envVar of moduleData.envVars || []) {
+        envVars[envVar.key] = envVar.value;
+    }
+    await mergeEnvFile(targetDir, envVars);
 }
 async function mergeAuthConfig(templatesDir, targetDir, framework, auth) {
+    // Use modules directory (sibling to templates)
+    const modulesDir = path_1.default.join(templatesDir, '..', 'modules');
     // Auth modules are now named with framework suffix
     // e.g., better-auth-nextjs, authjs-express, better-auth-react
     // If auth already has framework suffix, use it directly
@@ -244,38 +253,67 @@ async function mergeAuthConfig(templatesDir, targetDir, framework, auth) {
     const authMap = {
         nextauth: 'nextauth',
         'better-auth': framework === 'nextjs' ? 'better-auth-nextjs' : 'better-auth-express',
-        clerk: 'clerk',
+        clerk: framework === 'nextjs'
+            ? 'clerk-nextjs'
+            : framework === 'react-vite'
+                ? 'clerk-react'
+                : 'clerk-express',
     };
     const authKey = auth.includes('-') ? auth : authMap[auth] || auth;
-    const authDir = path_1.default.join(templatesDir, 'auth', authKey);
-    if (!(await fs_extra_1.default.pathExists(authDir))) {
-        console.warn(`Auth template not found: ${authKey}`);
+    const authModulePath = path_1.default.join(modulesDir, 'auth', authKey);
+    if (!(await fs_extra_1.default.pathExists(authModulePath))) {
+        console.warn(`Auth module not found: ${authKey}`);
         return;
     }
-    // Read config
-    const configPath = path_1.default.join(authDir, 'config.json');
-    if (!(await fs_extra_1.default.pathExists(configPath))) {
+    // Read module.json
+    const moduleJsonPath = path_1.default.join(authModulePath, 'module.json');
+    if (!(await fs_extra_1.default.pathExists(moduleJsonPath))) {
         return;
     }
-    const config = await fs_extra_1.default.readJson(configPath);
-    // Copy auth files
-    const entries = await fs_extra_1.default.readdir(authDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.name === 'config.json')
-            continue;
-        const sourcePath = path_1.default.join(authDir, entry.name);
-        const destPath = path_1.default.join(targetDir, entry.name);
-        if (entry.isDirectory()) {
-            await fs_extra_1.default.copy(sourcePath, destPath, { overwrite: false });
-        }
-        else {
-            await fs_extra_1.default.copy(sourcePath, destPath, { overwrite: false });
+    const moduleData = await fs_extra_1.default.readJson(moduleJsonPath);
+    // Copy files from module
+    const filesDir = path_1.default.join(authModulePath, 'files');
+    if (await fs_extra_1.default.pathExists(filesDir)) {
+        // Determine path replacements based on framework
+        const getReplacements = () => {
+            if (framework === 'nextjs') {
+                return { lib: 'lib', router: 'app' };
+            }
+            else if (framework === 'express') {
+                return { lib: 'src', router: 'src' };
+            }
+            else {
+                return { lib: 'src', router: 'src' };
+            }
+        };
+        const replacements = getReplacements();
+        // Copy files based on patches in module.json
+        for (const patch of moduleData.patches || []) {
+            if (patch.type === 'create-file') {
+                const sourceFile = path_1.default.join(filesDir, patch.source);
+                let destFile = path_1.default.join(targetDir, patch.destination);
+                // Replace placeholders
+                destFile = destFile
+                    .replace('{{lib}}', replacements.lib)
+                    .replace('{{router}}', replacements.router);
+                if (await fs_extra_1.default.pathExists(sourceFile)) {
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(destFile));
+                    await fs_extra_1.default.copy(sourceFile, destFile, { overwrite: false });
+                }
+            }
         }
     }
-    // Merge package.json
-    await mergePackageJson(targetDir, config);
-    // Merge .env
-    await mergeEnvFile(targetDir, config.env || {});
+    // Merge package.json with module dependencies
+    await mergePackageJson(targetDir, {
+        dependencies: moduleData.dependencies,
+        devDependencies: moduleData.devDependencies,
+    });
+    // Merge .env with module envVars
+    const envVars = {};
+    for (const envVar of moduleData.envVars || []) {
+        envVars[envVar.key] = envVar.value;
+    }
+    await mergeEnvFile(targetDir, envVars);
 }
 async function mergePackageJson(targetDir, config) {
     const pkgPath = path_1.default.join(targetDir, 'package.json');
@@ -397,4 +435,3 @@ function showNextSteps(config) {
     console.log(chalk_1.default.cyan(`  cd ${config.projectName}`));
     console.log(chalk_1.default.cyan(`  ${config.packageManager}${config.packageManager === 'npm' ? ' run' : ''} dev\n`));
 }
-//# sourceMappingURL=create-project.js.map

package/dist/lib/template-composer.d.ts

@@ -14,4 +14,3 @@ export declare class TemplateComposer {
     private writeEnvFile;
     private getAuthKey;
 }
-//# sourceMappingURL=template-composer.d.ts.map

package/dist/lib/template-composer.js

@@ -7,7 +7,6 @@ exports.TemplateComposer = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 class TemplateComposer {
-    templatesDir;
     constructor(templatesDir) {
         this.templatesDir = templatesDir;
     }
@@ -196,4 +195,3 @@ class TemplateComposer {
     }
 }
 exports.TemplateComposer = TemplateComposer;
-//# sourceMappingURL=template-composer.js.map

package/{templates → modules}/auth/authjs-express/files/lib/auth.ts

@@ -1,6 +1,3 @@
-import { Auth } from '@auth/core';
-import GitHub from '@auth/core/providers/github';
-import Google from '@auth/core/providers/google';
 import Credentials from '@auth/core/providers/credentials';
 
 export const authConfig = {

package/{templates → modules}/auth/authjs-nextjs/files/lib/auth.ts

@@ -1,6 +1,4 @@
 import NextAuth from 'next-auth';
-import GitHub from 'next-auth/providers/github';
-import Google from 'next-auth/providers/google';
 import Credentials from 'next-auth/providers/credentials';
 
 export const { handlers, signIn, signOut, auth } = NextAuth({

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

@@ -0,0 +1,16 @@
+import { betterAuth } from 'better-auth';
+
+export const auth = betterAuth({
+  secret: process.env.BETTER_AUTH_SECRET!,
+  baseURL: process.env.BETTER_AUTH_URL!,
+
+  emailAndPassword: {
+    enabled: true,
+  },
+
+  // Uncomment to add database adapter
+  // database: {
+  //   provider: "pg", // or "mongodb", "mysql"
+  //   url: process.env.DATABASE_URL!,
+  // },
+});

package/{templates/auth/authjs-express → modules/auth/better-auth-express/files}/routes/auth.ts

@@ -1,11 +1,11 @@
 import { Router } from 'express';
-import { Auth } from '@auth/core';
-import { authConfig } from '../lib/auth';
+import { auth } from '../lib/auth';
 
 const router = Router();
 
+// Mount Better Auth handlers
 router.all('/auth/*', async (req, res) => {
-  const response = await Auth(req, authConfig);
+  const response = await auth.handler(req);
   return res.status(response.status).json(response.body);
 });
 

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

@@ -0,0 +1,38 @@
+{
+  "name": "auth",
+  "displayName": "Better Auth (Express)",
+  "description": "Modern authentication with Better Auth for Express",
+  "category": "auth",
+  "supportedFrameworks": ["express"],
+  "dependencies": {
+    "better-auth": "^1.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": "lib/auth.ts",
+      "destination": "src/lib/auth.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "Create auth routes",
+      "source": "routes/auth.ts",
+      "destination": "src/routes/auth.ts"
+    }
+  ]
+}

package/{templates/auth/better-auth-nextjs/app → modules/auth/better-auth-nextjs/files}/api/auth/[...all]/route.ts

@@ -2,3 +2,4 @@ import { auth } from '@/lib/auth';
 import { toNextJsHandler } from 'better-auth/next-js';
 
 export const { GET, POST } = toNextJsHandler(auth);
+

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/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>
+  );
+}