create-stackkit-app 0.3.0 → 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,13 +54,13 @@ 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:',
+            when: (answers) => answers.framework !== 'react-vite',
             choices: [
                 { name: 'Prisma + PostgreSQL', value: 'prisma-postgresql' },
                 { name: 'Prisma + MongoDB', value: 'prisma-mongodb' },
@@ -74,22 +74,34 @@ async function getProjectConfig(projectName) {
             name: 'auth',
             message: 'Select authentication:',
             choices: (answers) => {
-                const baseChoices = [
-                    { name: 'Auth.js (NextAuth)', value: 'nextauth' },
-                    { name: 'Better Auth', value: 'better-auth' },
-                    { name: 'Clerk', value: 'clerk' },
-                    { name: 'None', value: 'none' },
-                ];
-                // Filter choices based on framework compatibility
-                if (answers.framework === 'nextjs') {
-                    return baseChoices;
+                if (answers.framework === 'react-vite') {
+                    return [
+                        { name: 'Better Auth', value: 'better-auth-react' },
+                        { name: 'Clerk', value: 'clerk-react' },
+                        { name: 'None', value: 'none' },
+                    ];
                 }
-                else if (answers.framework === 'express') {
-                    return baseChoices.filter((c) => ['better-auth', 'none'].includes(c.value));
+                // Next.js apps
+                if (answers.framework === 'nextjs') {
+                    return [
+                        { name: 'Auth.js v5', value: 'authjs-nextjs' },
+                        { name: 'NextAuth.js', value: 'nextauth' },
+                        { name: 'Better Auth', value: 'better-auth-nextjs' },
+                        { name: 'Clerk', value: 'clerk-nextjs' },
+                        { name: 'None', value: 'none' },
+                    ];
                 }
-                else {
-                    return [{ name: 'None', value: 'none' }];
+                // Express apps
+                if (answers.framework === 'express') {
+                    return [
+                        { name: 'Auth.js', value: 'authjs-express' },
+                        { name: 'Better Auth', value: 'better-auth-express' },
+                        { name: 'Clerk', value: 'clerk-express' },
+                        { name: 'None', value: 'none' },
+                    ];
                 }
+                // Default - no auth
+                return [{ name: 'None', value: 'none' }];
             },
         },
         {
@@ -113,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,
@@ -189,73 +201,119 @@ 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) {
-    // Map auth selection to template directory
+    // 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
+    // Otherwise, map old names to new ones
     const authMap = {
-        'nextjs-nextauth': 'nextauth',
-        'nextjs-better-auth': 'better-auth-nextjs',
-        'express-better-auth': 'better-auth-express',
+        nextauth: 'nextauth',
+        'better-auth': framework === 'nextjs' ? 'better-auth-nextjs' : 'better-auth-express',
+        clerk: framework === 'nextjs'
+            ? 'clerk-nextjs'
+            : framework === 'react-vite'
+                ? 'clerk-react'
+                : 'clerk-express',
     };
-    const authKey = authMap[`${framework}-${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 authKey = auth.includes('-') ? auth : authMap[auth] || auth;
+    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');
@@ -377,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/modules/auth/authjs-express/files/lib/auth.ts

@@ -0,0 +1,40 @@
+import Credentials from '@auth/core/providers/credentials';
+
+export const authConfig = {
+  secret: process.env.AUTH_SECRET,
+  trustHost: true,
+  providers: [
+    // GitHub OAuth Provider
+    // Uncomment and add GITHUB_ID and GITHUB_SECRET to .env
+    // GitHub({
+    //   clientId: process.env.GITHUB_ID!,
+    //   clientSecret: process.env.GITHUB_SECRET!,
+    // }),
+
+    // Google OAuth Provider
+    // Uncomment and add GOOGLE_ID and GOOGLE_SECRET to .env
+    // Google({
+    //   clientId: process.env.GOOGLE_ID!,
+    //   clientSecret: process.env.GOOGLE_SECRET!,
+    // }),
+
+    // Credentials Provider (email/password)
+    Credentials({
+      credentials: {
+        email: { label: 'Email', type: 'email' },
+        password: { label: 'Password', type: 'password' },
+      },
+      authorize: async (credentials) => {
+        // Add your own authentication logic here
+        if (credentials?.email === 'demo@example.com' && credentials?.password === 'demo') {
+          return {
+            id: '1',
+            name: 'Demo User',
+            email: 'demo@example.com',
+          };
+        }
+        return null;
+      },
+    }),
+  ],
+};

package/modules/auth/authjs-express/files/routes/auth.ts

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

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

@@ -0,0 +1,39 @@
+{
+  "name": "auth",
+  "displayName": "Auth.js (Express)",
+  "description": "Authentication with Auth.js for Express",
+  "category": "auth",
+  "supportedFrameworks": ["express"],
+  "dependencies": {
+    "@auth/express": "^0.7.6",
+    "@auth/core": "^0.37.4"
+  },
+  "envVars": [
+    {
+      "key": "AUTH_SECRET",
+      "value": "",
+      "description": "Secret for encrypting tokens. Generate with: openssl rand -base64 32",
+      "required": true
+    },
+    {
+      "key": "AUTH_TRUST_HOST",
+      "value": "true",
+      "description": "Trust the host header (required for Express)",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Auth.js 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/modules/auth/authjs-nextjs/files/lib/auth.ts

@@ -0,0 +1,43 @@
+import NextAuth from 'next-auth';
+import Credentials from 'next-auth/providers/credentials';
+
+export const { handlers, signIn, signOut, auth } = NextAuth({
+  providers: [
+    // GitHub OAuth Provider
+    // Uncomment and add GITHUB_ID and GITHUB_SECRET to .env
+    // GitHub({
+    //   clientId: process.env.GITHUB_ID!,
+    //   clientSecret: process.env.GITHUB_SECRET!,
+    // }),
+
+    // Google OAuth Provider
+    // Uncomment and add GOOGLE_ID and GOOGLE_SECRET to .env
+    // Google({
+    //   clientId: process.env.GOOGLE_ID!,
+    //   clientSecret: process.env.GOOGLE_SECRET!,
+    // }),
+
+    // Credentials Provider (email/password)
+    Credentials({
+      credentials: {
+        email: { label: 'Email', type: 'email' },
+        password: { label: 'Password', type: 'password' },
+      },
+      authorize: async (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;
+      },
+    }),
+  ],
+  pages: {
+    signIn: '/auth/signin',
+  },
+});

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

@@ -0,0 +1,38 @@
+{
+  "name": "auth",
+  "displayName": "Auth.js v5 (Next.js)",
+  "description": "Modern authentication with Auth.js v5 (NextAuth successor)",
+  "category": "auth",
+  "supportedFrameworks": ["nextjs"],
+  "dependencies": {
+    "next-auth": "^5.0.0-beta.25"
+  },
+  "envVars": [
+    {
+      "key": "AUTH_SECRET",
+      "value": "",
+      "description": "Secret for encrypting tokens. Generate with: openssl rand -base64 32",
+      "required": true
+    },
+    {
+      "key": "AUTH_URL",
+      "value": "http://localhost:3000",
+      "description": "Canonical URL of your site (change in production)",
+      "required": false
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Auth.js configuration",
+      "source": "lib/auth.ts",
+      "destination": "{{lib}}/auth.ts"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Auth.js API route",
+      "source": "api/auth/[...nextauth]/route.ts",
+      "destination": "{{router}}/api/auth/[...nextauth]/route.ts"
+    }
+  ]
+}

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/modules/auth/better-auth-express/files/routes/auth.ts

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

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