create-stackkit-app 0.4.0 → 0.4.2

package/README.md

@@ -1,6 +1,6 @@
 # create-stackkit-app
 
-Create production-ready projects with one command.
+Create production-ready projects with your preferred stack in seconds.
 
 ## Usage
 
@@ -8,18 +8,32 @@ Create production-ready projects with one command.
 npx create-stackkit-app my-app
 ```
 
-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
+Interactive wizard helps you choose:
+- **Framework**: Next.js, Express, or React + Vite
+- **Database**: Prisma (PostgreSQL/MongoDB), Mongoose (MongoDB)
+- **Authentication**: Better Auth, Clerk
+- **Package manager**: pnpm, npm, or yarn
 
-## Development
+## Quick Start
 
 ```bash
-pnpm install
-pnpm build
-npx . test-app
+# Create project
+npx create-stackkit-app my-app
+
+# Navigate and run
+cd my-app
+npm run dev
 ```
 
-See [main README](../../README.md) for full documentation.
+## Features
+
+- TypeScript configured
+- ESLint + Prettier set up
+- Tailwind CSS included
+- Database client configured
+- Auth flows ready (if selected)
+- Environment variables templated
+
+## Documentation
+
+Full documentation available at [stackkit.dev](https://stackkit.dev) or [GitHub](https://github.com/tariqul420/stackkit)

package/dist/lib/create-project.js

@@ -84,8 +84,6 @@ async function getProjectConfig(projectName) {
                 // 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' },
@@ -94,7 +92,6 @@ async function getProjectConfig(projectName) {
                 // 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' },
@@ -170,11 +167,11 @@ async function composeTemplate(config, targetDir) {
     await copyBaseFramework(templatesDir, targetDir, config.framework);
     // 2. Merge database configuration
     if (config.database !== 'none') {
-        await mergeDatabaseConfig(templatesDir, targetDir, config.database);
+        await mergeDatabaseConfig(templatesDir, targetDir, config.database, config.framework);
     }
     // 3. Merge auth configuration
     if (config.auth !== 'none') {
-        await mergeAuthConfig(templatesDir, targetDir, config.framework, config.auth);
+        await mergeAuthConfig(templatesDir, targetDir, config.framework, config.auth, config.database);
     }
     // 4. Update package.json with project name
     const packageJsonPath = path_1.default.join(targetDir, 'package.json');
@@ -189,7 +186,7 @@ async function composeTemplate(config, targetDir) {
     }
 }
 async function copyBaseFramework(templatesDir, targetDir, framework) {
-    const baseDir = path_1.default.join(templatesDir, 'bases', `${framework}-base`);
+    const baseDir = path_1.default.join(templatesDir, framework);
     if (!(await fs_extra_1.default.pathExists(baseDir))) {
         throw new Error(`Base template not found for framework: ${framework}\n` + `Expected at: ${baseDir}`);
     }
@@ -200,7 +197,7 @@ async function copyBaseFramework(templatesDir, targetDir, framework) {
         },
     });
 }
-async function mergeDatabaseConfig(templatesDir, targetDir, database) {
+async function mergeDatabaseConfig(templatesDir, targetDir, database, framework) {
     // Use modules directory (sibling to templates)
     const modulesDir = path_1.default.join(templatesDir, '..', 'modules');
     const dbModulePath = path_1.default.join(modulesDir, 'database', database);
@@ -242,8 +239,16 @@ async function mergeDatabaseConfig(templatesDir, targetDir, database) {
         envVars[envVar.key] = envVar.value;
     }
     await mergeEnvFile(targetDir, envVars);
+    // Apply framework-specific patches from database module
+    if (moduleData.frameworkPatches) {
+        const frameworkKey = framework === 'react-vite' ? 'react' : framework;
+        const patches = moduleData.frameworkPatches[frameworkKey];
+        if (patches) {
+            await applyFrameworkPatches(targetDir, patches);
+        }
+    }
 }
-async function mergeAuthConfig(templatesDir, targetDir, framework, auth) {
+async function mergeAuthConfig(templatesDir, targetDir, framework, auth, database = 'none') {
     // Use modules directory (sibling to templates)
     const modulesDir = path_1.default.join(templatesDir, '..', 'modules');
     // Auth modules are now named with framework suffix
@@ -303,6 +308,47 @@ async function mergeAuthConfig(templatesDir, targetDir, framework, auth) {
             }
         }
     }
+    // Handle database-specific adapters and schemas
+    if (database !== 'none' && moduleData.databaseAdapters) {
+        const adapterConfig = moduleData.databaseAdapters[database];
+        if (adapterConfig) {
+            // Copy adapter file
+            if (adapterConfig.adapter) {
+                const adapterSource = path_1.default.join(authModulePath, adapterConfig.adapter);
+                const adapterFileName = path_1.default.basename(adapterConfig.adapter);
+                // Determine destination based on framework
+                let adapterDest;
+                if (framework === 'nextjs') {
+                    adapterDest = path_1.default.join(targetDir, 'lib', 'auth.ts');
+                }
+                else if (framework === 'express') {
+                    adapterDest = path_1.default.join(targetDir, 'src', 'auth.ts');
+                }
+                else {
+                    adapterDest = path_1.default.join(targetDir, 'src', 'lib', 'auth.ts');
+                }
+                if (await fs_extra_1.default.pathExists(adapterSource)) {
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(adapterDest));
+                    await fs_extra_1.default.copy(adapterSource, adapterDest, { overwrite: true });
+                }
+            }
+            // Copy schema file if it exists
+            if (adapterConfig.schema && adapterConfig.schemaDestination) {
+                const schemaSource = path_1.default.join(authModulePath, adapterConfig.schema);
+                const schemaDest = path_1.default.join(targetDir, adapterConfig.schemaDestination);
+                if (await fs_extra_1.default.pathExists(schemaSource)) {
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(schemaDest));
+                    await fs_extra_1.default.copy(schemaSource, schemaDest, { overwrite: true });
+                }
+            }
+            // Merge adapter-specific dependencies
+            if (adapterConfig.dependencies) {
+                await mergePackageJson(targetDir, {
+                    dependencies: adapterConfig.dependencies,
+                });
+            }
+        }
+    }
     // Merge package.json with module dependencies
     await mergePackageJson(targetDir, {
         dependencies: moduleData.dependencies,
@@ -429,6 +475,40 @@ async function initGit(cwd) {
         throw new Error('Git initialization failed');
     }
 }
+async function applyFrameworkPatches(targetDir, patches) {
+    for (const [filename, patchConfig] of Object.entries(patches)) {
+        const filePath = path_1.default.join(targetDir, filename);
+        if (await fs_extra_1.default.pathExists(filePath)) {
+            const fileContent = await fs_extra_1.default.readJson(filePath);
+            if (patchConfig.merge) {
+                // Deep merge configuration
+                const merged = deepMerge(fileContent, patchConfig.merge);
+                await fs_extra_1.default.writeJson(filePath, merged, { spaces: 2 });
+            }
+        }
+    }
+}
+function deepMerge(target, source) {
+    const output = { ...target };
+    for (const key in source) {
+        if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+            if (target[key]) {
+                output[key] = deepMerge(target[key], source[key]);
+            }
+            else {
+                output[key] = source[key];
+            }
+        }
+        else if (Array.isArray(source[key])) {
+            // For arrays, merge uniquely
+            output[key] = Array.from(new Set([...(target[key] || []), ...source[key]]));
+        }
+        else {
+            output[key] = source[key];
+        }
+    }
+    return output;
+}
 function showNextSteps(config) {
     console.log(chalk_1.default.green.bold(`\n✓ Created ${config.projectName}\n`));
     console.log(chalk_1.default.bold('Next steps:'));

package/dist/lib/template-composer.js

@@ -17,7 +17,7 @@ class TemplateComposer {
         const configs = [];
         const filesToCopy = [];
         // 1. Load base framework template
-        const baseConfig = await this.loadConfig(path_1.default.join(this.templatesDir, 'bases', `${framework}-base`));
+        const baseConfig = await this.loadConfig(path_1.default.join(this.templatesDir, framework));
         configs.push(baseConfig);
         // Copy base files
         const baseFiles = await this.getBaseFiles(framework);

package/modules/auth/better-auth-express/adapters/mongoose-mongodb.ts

@@ -0,0 +1,13 @@
+import { betterAuth } from 'better-auth';
+import { mongodbAdapter } from 'better-auth/adapters/mongodb';
+import { client } from './db';
+
+export const auth = betterAuth({
+  database: mongodbAdapter(client),
+  emailAndPassword: {
+    enabled: true,
+  },
+});
+
+export type Session = typeof auth.$Infer.Session;
+export type User = typeof auth.$Infer.User;

package/modules/auth/better-auth-express/adapters/prisma-mongodb.ts

@@ -0,0 +1,15 @@
+import { prismaAdapter } from '@better-auth/prisma';
+import { betterAuth } from 'better-auth';
+import { prisma } from './db';
+
+export const auth = betterAuth({
+  database: prismaAdapter(prisma, {
+    provider: 'mongodb',
+  }),
+  emailAndPassword: {
+    enabled: true,
+  },
+});
+
+export type Session = typeof auth.$Infer.Session;
+export type User = typeof auth.$Infer.User;

package/modules/auth/better-auth-express/adapters/prisma-postgresql.ts

@@ -0,0 +1,15 @@
+import { prismaAdapter } from '@better-auth/prisma';
+import { betterAuth } from 'better-auth';
+import { prisma } from './db';
+
+export const auth = betterAuth({
+  database: prismaAdapter(prisma, {
+    provider: 'postgresql',
+  }),
+  emailAndPassword: {
+    enabled: true,
+  },
+});
+
+export type Session = typeof auth.$Infer.Session;
+export type User = typeof auth.$Infer.User;

package/modules/auth/better-auth-express/files/schemas/prisma-mongodb-schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "mongodb"
+    url      = env("DATABASE_URL")
+}
+
+// Better Auth models for MongoDB
+model User {
+  id            String    @id @default(auto()) @map("_id") @db.ObjectId
+  name          String
+  email         String
+  emailVerified Boolean   @default(false)
+  image         String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  sessions      Session[]
+  accounts      Account[]
+  role          String    @default("USER")
+
+  @@unique([email])
+  @@map("user")
+}
+
+model Session {
+  id        String   @id @default(auto()) @map("_id") @db.ObjectId
+  expiresAt DateTime
+  token     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  ipAddress String?
+  userAgent String?
+  userId    String   @db.ObjectId
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("session")
+}
+
+model Account {
+  id                    String    @id @default(auto()) @map("_id") @db.ObjectId
+  accountId             String
+  providerId            String
+  userId                String    @db.ObjectId
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@index([userId])
+  @@map("account")
+}
+
+model Verification {
+  id         String   @id @default(auto()) @map("_id") @db.ObjectId
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([identifier])
+  @@map("verification")
+}

package/modules/auth/better-auth-express/files/schemas/prisma-postgresql-schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "postgresql"
+    url      = env("DATABASE_URL")
+}
+
+// Better Auth models for PostgreSQL
+model User {
+  id            String    @id @default(cuid())
+  name          String
+  email         String
+  emailVerified Boolean   @default(false)
+  image         String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  sessions      Session[]
+  accounts      Account[]
+  role          String    @default("USER")
+
+  @@unique([email])
+  @@map("user")
+}
+
+model Session {
+  id        String   @id @default(cuid())
+  expiresAt DateTime
+  token     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  ipAddress String?
+  userAgent String?
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("session")
+}
+
+model Account {
+  id                    String    @id @default(cuid())
+  accountId             String
+  providerId            String
+  userId                String
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@index([userId])
+  @@map("account")
+}
+
+model Verification {
+  id         String   @id @default(cuid())
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([identifier])
+  @@map("verification")
+}

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

@@ -1,11 +1,34 @@
 {
-  "name": "auth",
+  "name": "better-auth-express",
   "displayName": "Better Auth (Express)",
   "description": "Modern authentication with Better Auth for Express",
   "category": "auth",
   "supportedFrameworks": ["express"],
-  "dependencies": {
-    "better-auth": "^1.0.0"
+  "databaseAdapters": {
+    "prisma-postgresql": {
+      "adapter": "adapters/prisma-postgresql.ts",
+      "schema": "files/schemas/prisma-postgresql-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {
+        "better-auth": "^1.1.4",
+        "@better-auth/prisma": "^1.1.4"
+      }
+    },
+    "prisma-mongodb": {
+      "adapter": "adapters/prisma-mongodb.ts",
+      "schema": "files/schemas/prisma-mongodb-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {
+        "better-auth": "^1.1.4",
+        "@better-auth/prisma": "^1.1.4"
+      }
+    },
+    "mongoose-mongodb": {
+      "adapter": "adapters/mongoose-mongodb.ts",
+      "dependencies": {
+        "better-auth": "^1.1.4"
+      }
+    }
   },
   "envVars": [
     {

package/modules/auth/better-auth-nextjs/adapters/mongoose-mongodb.ts

@@ -0,0 +1,24 @@
+import { client } from '@/lib/db';
+import { betterAuth } from 'better-auth';
+import { mongodbAdapter } from 'better-auth/adapters/mongodb';
+
+export const auth = betterAuth({
+  database: mongodbAdapter(client),
+  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/adapters/prisma-mongodb.ts

@@ -0,0 +1,26 @@
+import { prisma } from '@/lib/db';
+import { prismaAdapter } from '@better-auth/prisma';
+import { betterAuth } from 'better-auth';
+
+export const auth = betterAuth({
+  database: prismaAdapter(prisma, {
+    provider: '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/adapters/prisma-postgresql.ts

@@ -0,0 +1,26 @@
+import { prisma } from '@/lib/db';
+import { prismaAdapter } from '@better-auth/prisma';
+import { betterAuth } from 'better-auth';
+
+export const auth = betterAuth({
+  database: prismaAdapter(prisma, {
+    provider: 'postgresql',
+  }),
+  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/files/schemas/prisma-mongodb-schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "mongodb"
+    url      = env("DATABASE_URL")
+}
+
+// Better Auth models for MongoDB
+model User {
+  id            String    @id @default(auto()) @map("_id") @db.ObjectId
+  name          String
+  email         String
+  emailVerified Boolean   @default(false)
+  image         String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  sessions      Session[]
+  accounts      Account[]
+  role          String    @default("USER")
+
+  @@unique([email])
+  @@map("user")
+}
+
+model Session {
+  id        String   @id @default(auto()) @map("_id") @db.ObjectId
+  expiresAt DateTime
+  token     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  ipAddress String?
+  userAgent String?
+  userId    String   @db.ObjectId
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("session")
+}
+
+model Account {
+  id                    String    @id @default(auto()) @map("_id") @db.ObjectId
+  accountId             String
+  providerId            String
+  userId                String    @db.ObjectId
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@index([userId])
+  @@map("account")
+}
+
+model Verification {
+  id         String   @id @default(auto()) @map("_id") @db.ObjectId
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([identifier])
+  @@map("verification")
+}

package/modules/auth/better-auth-nextjs/files/schemas/prisma-postgresql-schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "postgresql"
+    url      = env("DATABASE_URL")
+}
+
+// Better Auth models for PostgreSQL
+model User {
+  id            String    @id @default(cuid())
+  name          String
+  email         String
+  emailVerified Boolean   @default(false)
+  image         String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  sessions      Session[]
+  accounts      Account[]
+  role          String    @default("USER")
+
+  @@unique([email])
+  @@map("user")
+}
+
+model Session {
+  id        String   @id @default(cuid())
+  expiresAt DateTime
+  token     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  ipAddress String?
+  userAgent String?
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("session")
+}
+
+model Account {
+  id                    String    @id @default(cuid())
+  accountId             String
+  providerId            String
+  userId                String
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@index([userId])
+  @@map("account")
+}
+
+model Verification {
+  id         String   @id @default(cuid())
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([identifier])
+  @@map("verification")
+}