create-stackkit-app 0.2.0 → 0.3.1

package/templates/auth/better-auth-react/config.json

@@ -0,0 +1,15 @@
+{
+  "name": "better-auth-react",
+  "displayName": "Better Auth (React)",
+  "description": "Client-side authentication with Better Auth for React",
+  "frameworks": ["react", "react-vite"],
+  "dependencies": {
+    "better-auth": "^1.0.0"
+  },
+  "envVars": {
+    "VITE_AUTH_URL": {
+      "value": "http://localhost:3000",
+      "description": "Base URL of your auth server (optional if same domain)"
+    }
+  }
+}

package/templates/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/templates/auth/better-auth-react/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/templates/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/templates/auth/nextauth/app/api/auth/[...nextauth]/route.ts

@@ -0,0 +1,3 @@
+import { handlers } from '@/lib/auth';
+
+export const { GET, POST } = handlers;

package/templates/auth/nextauth/config.json

@@ -0,0 +1,18 @@
+{
+  "name": "nextauth",
+  "displayName": "Auth.js (NextAuth)",
+  "auth": "nextauth",
+  "compatibleWith": {
+    "frameworks": ["nextjs"],
+    "databases": ["prisma-postgresql", "prisma-mongodb"]
+  },
+  "dependencies": {
+    "next-auth": "^5.0.0-beta.25",
+    "@auth/prisma-adapter": "^2.7.4"
+  },
+  "env": {
+    "AUTH_SECRET": "your-secret-here",
+    "NEXTAUTH_URL": "http://localhost:3000"
+  },
+  "files": ["app/api/auth/[...nextauth]/route.ts", "lib/auth.ts", "middleware.ts"]
+}

package/templates/auth/nextauth/lib/auth.ts

@@ -0,0 +1,31 @@
+import { prisma } from '@/lib/db';
+import { PrismaAdapter } from '@auth/prisma-adapter';
+import NextAuth from 'next-auth';
+import CredentialsProvider from 'next-auth/providers/credentials';
+
+export const { handlers, auth, signIn, signOut } = NextAuth({
+  adapter: PrismaAdapter(prisma),
+  session: {
+    strategy: 'jwt',
+  },
+  providers: [
+    CredentialsProvider({
+      name: 'Credentials',
+      credentials: {
+        email: { label: 'Email', type: 'email' },
+        password: { label: 'Password', type: 'password' },
+      },
+      async authorize(credentials) {
+        // Add your authentication logic here
+        if (!credentials?.email || !credentials?.password) {
+          return null;
+        }
+        // Replace with your actual user lookup
+        return { id: '1', email: credentials.email as string };
+      },
+    }),
+  ],
+  pages: {
+    signIn: '/auth/signin',
+  },
+});

package/templates/bases/express-base/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/bases/express-base/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "dotenv": "^16.4.7",
+    "cors": "^2.8.5"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.5",
+    "@types/cors": "^2.8.17",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/bases/express-base/src/index.ts

@@ -0,0 +1,27 @@
+import express, { Request, Response } from 'express';
+import dotenv from 'dotenv';
+import cors from 'cors';
+
+dotenv.config();
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+// Middleware
+app.use(cors());
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+// Routes
+app.get('/health', (req: Request, res: Response) => {
+  res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+
+app.get('/', (req: Request, res: Response) => {
+  res.json({ message: 'Welcome to StackKit API' });
+});
+
+// Start server
+app.listen(PORT, () => {
+  console.log(`🚀 Server running on http://localhost:${PORT}`);
+});

package/templates/bases/express-base/template.json

@@ -0,0 +1,7 @@
+{
+  "name": "express-base",
+  "displayName": "Express.js",
+  "framework": "express",
+  "description": "Express.js REST API with TypeScript",
+  "files": ["src/", "tsconfig.json", "package.json"]
+}

package/templates/bases/express-base/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/bases/nextjs-base/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

package/templates/bases/nextjs-base/app/globals.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/templates/{next-prisma-postgres-shadcn → bases/nextjs-base}/app/layout.tsx

@@ -1,22 +1,19 @@
 import type { Metadata } from 'next';
-import { Inter } from 'next/font/google';
 import './globals.css';
 
-const inter = Inter({ subsets: ['latin'] });
-
 export const metadata: Metadata = {
   title: 'StackKit App',
-  description: 'Created with StackKit',
+  description: 'Generated by create-stackkit-app',
 };
 
 export default function RootLayout({
   children,
 }: Readonly<{
-  children: React.ReactNode;
+  children: React.Node;
 }>) {
   return (
     <html lang="en">
-      <body className={inter.className}>{children}</body>
+      <body>{children}</body>
     </html>
   );
 }

package/templates/bases/nextjs-base/app/page.tsx

@@ -0,0 +1,8 @@
+export default function Home() {
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center p-24">
+      <h1 className="text-4xl font-bold">Welcome to StackKit</h1>
+      <p className="mt-4 text-xl">Your project is ready to go!</p>
+    </main>
+  );
+}

package/templates/{next-prisma-postgres-shadcn → bases/nextjs-base}/next.config.ts

@@ -1,7 +1,5 @@
 import type { NextConfig } from 'next';
 
-const nextConfig: NextConfig = {
-  /* config options here */
-};
+const nextConfig: NextConfig = {};
 
 export default nextConfig;

package/templates/bases/nextjs-base/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "^15.1.6",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.6",
+    "@types/react-dom": "^19.0.2",
+    "eslint": "^9",
+    "eslint-config-next": "^15.1.6",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/bases/nextjs-base/template.json

@@ -0,0 +1,7 @@
+{
+  "name": "nextjs-base",
+  "displayName": "Next.js",
+  "framework": "nextjs",
+  "description": "Next.js 15 App Router with TypeScript",
+  "files": ["app/", "public/", "next.config.ts", "tsconfig.json", "package.json"]
+}

package/templates/{next-prisma-postgres-shadcn → bases/nextjs-base}/tsconfig.json

@@ -22,11 +22,6 @@
       "@/*": ["./*"]
     }
   },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts"
-  ],
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
   "exclude": ["node_modules"]
 }

package/templates/databases/prisma-mongodb/config.json

@@ -0,0 +1,21 @@
+{
+  "name": "prisma-mongodb",
+  "displayName": "Prisma + MongoDB",
+  "database": "prisma-mongodb",
+  "compatibleWith": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.2.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.2.0"
+  },
+  "scripts": {
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:studio": "prisma studio"
+  },
+  "env": {
+    "DATABASE_URL": "mongodb://localhost:27017/mydb"
+  },
+  "files": ["prisma/schema.prisma", "lib/db.ts"]
+}

package/templates/{next-prisma-postgres-shadcn → databases/prisma-mongodb}/lib/db.ts

@@ -1,5 +1,4 @@
 import { PrismaClient } from '@prisma/client';
-import { env } from './env';
 
 const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined;
@@ -8,7 +7,7 @@ const globalForPrisma = globalThis as unknown as {
 export const prisma =
   globalForPrisma.prisma ??
   new PrismaClient({
-    log: env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
+    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
   });
 
-if (env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;

package/templates/databases/prisma-mongodb/prisma/schema.prisma

@@ -0,0 +1,16 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "mongodb"
+    url      = env("DATABASE_URL")
+}
+
+model User {
+    id        String   @id @default(auto()) @map("_id") @db.ObjectId
+    email     String   @unique
+    name      String?
+    createdAt DateTime @default(now())
+    updatedAt DateTime @updatedAt
+}

package/templates/databases/prisma-postgresql/config.json

@@ -0,0 +1,22 @@
+{
+  "name": "prisma-postgresql",
+  "displayName": "Prisma + PostgreSQL",
+  "database": "prisma-postgresql",
+  "compatibleWith": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.2.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.2.0"
+  },
+  "scripts": {
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:studio": "prisma studio"
+  },
+  "env": {
+    "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb"
+  },
+  "files": ["prisma/schema.prisma", "lib/db.ts"]
+}

package/templates/databases/prisma-postgresql/lib/db.ts

@@ -0,0 +1,13 @@
+import { PrismaClient } from '@prisma/client';
+
+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'],
+  });
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;

package/templates/databases/prisma-postgresql/prisma/schema.prisma

@@ -0,0 +1,16 @@
+generator client {
+    provider = "prisma-client-js"
+}
+
+datasource db {
+    provider = "postgresql"
+    url      = env("DATABASE_URL")
+}
+
+model User {
+    id        String   @id @default(cuid())
+    email     String   @unique
+    name      String?
+    createdAt DateTime @default(now())
+    updatedAt DateTime @updatedAt
+}

package/templates/next-prisma-postgres-shadcn/.env.example

@@ -1,5 +0,0 @@
-# Database
-DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
-
-# App
-NODE_ENV="development"

package/templates/next-prisma-postgres-shadcn/.eslintrc.json

@@ -1,7 +0,0 @@
-{
-  "extends": "next/core-web-vitals",
-  "rules": {
-    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
-    "@typescript-eslint/no-explicit-any": "warn"
-  }
-}

package/templates/next-prisma-postgres-shadcn/.prettierrc

@@ -1,8 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false
-}

package/templates/next-prisma-postgres-shadcn/README.md

@@ -1,85 +0,0 @@
-# Project
-
-Created with [StackKit](https://github.com/tariqul420/stackkit).
-
-## Setup
-
-```bash
-# Install dependencies
-pnpm install
-
-# Configure environment
-cp .env.example .env
-# Update DATABASE_URL in .env
-
-# Run migrations
-pnpm prisma migrate dev
-
-# Start dev server
-pnpm dev
-```
-
-Open [http://localhost:3000](http://localhost:3000)
-
-## Stack
-
-- Next.js 15 (App Router)
-- TypeScript
-- Prisma + PostgreSQL
-- Tailwind CSS
-- shadcn/ui
-- Zod validation
-
-## Structure
-
-```
-├── app/              # Next.js routes
-├── lib/              # Utilities
-├── prisma/           # Database schema
-└── public/           # Static files
-```
-
-## Scripts
-
-```bash
-pnpm dev              # Development server
-pnpm build            # Production build
-pnpm start            # Start production
-pnpm lint             # Run linter
-pnpm prisma studio    # Open Prisma Studio
-```
-
-## Add Features
-
-```bash
-npx stackkit-cli add auth
-```
-├── lib/                 # Shared utilities
-│   ├── db.ts           # Prisma client
-│   └── env.ts          # Environment validation
-├── prisma/             # Database schema
-│   └── schema.prisma
-└── public/             # Static assets
-```
-
-## Available Commands
-
-- `pnpm dev` - Start development server
-- `pnpm build` - Build for production
-- `pnpm start` - Start production server
-- `pnpm lint` - Run ESLint
-- `pnpm format` - Format code with Prettier
-
-## Adding Features
-
-Use StackKit to add more features to your project:
-
-```bash
-npx stackkit add auth
-```
-
-## Learn More
-
-- [Next.js Documentation](https://nextjs.org/docs)
-- [Prisma Documentation](https://www.prisma.io/docs)
-- [StackKit Documentation](https://github.com/yourusername/stackkit)

package/templates/next-prisma-postgres-shadcn/app/api/health/route.ts

@@ -1,25 +0,0 @@
-import { NextResponse } from 'next/server';
-import { prisma } from '@/lib/db';
-
-export async function GET() {
-  try {
-    // Test database connection
-    await prisma.$queryRaw`SELECT 1`;
-
-    return NextResponse.json({
-      status: 'ok',
-      timestamp: new Date().toISOString(),
-      database: 'connected',
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        status: 'error',
-        timestamp: new Date().toISOString(),
-        database: 'disconnected',
-        error: error instanceof Error ? error.message : 'Unknown error',
-      },
-      { status: 500 }
-    );
-  }
-}

package/templates/next-prisma-postgres-shadcn/app/globals.css

@@ -1 +0,0 @@
-@import 'tailwindcss';

package/templates/next-prisma-postgres-shadcn/app/page.tsx

@@ -1,29 +0,0 @@
-export default function HomePage() {
-  return (
-    <main className="flex min-h-screen flex-col items-center justify-center p-24">
-      <div className="z-10 max-w-5xl w-full items-center justify-between font-mono text-sm">
-        <h1 className="text-4xl font-bold mb-4">Welcome to StackKit</h1>
-        <p className="text-lg text-gray-600 dark:text-gray-400">
-          Your production-ready Next.js starter
-        </p>
-        <div className="mt-8 space-y-2">
-          <p>✅ Next.js 15 App Router</p>
-          <p>✅ TypeScript</p>
-          <p>✅ Prisma + PostgreSQL</p>
-          <p>✅ Tailwind CSS</p>
-          <p>✅ Environment validation</p>
-        </div>
-        <div className="mt-8">
-          <a
-            href="/api/health"
-            className="text-blue-600 hover:underline"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            Check API Health →
-          </a>
-        </div>
-      </div>
-    </main>
-  );
-}

package/templates/next-prisma-postgres-shadcn/lib/env.ts

@@ -1,15 +0,0 @@
-import { z } from 'zod';
-
-const envSchema = z.object({
-  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
-  DATABASE_URL: z.string().url(),
-});
-
-const parsedEnv = envSchema.safeParse(process.env);
-
-if (!parsedEnv.success) {
-  console.error('❌ Invalid environment variables:', parsedEnv.error.format());
-  throw new Error('Invalid environment variables');
-}
-
-export const env = parsedEnv.data;

package/templates/next-prisma-postgres-shadcn/package.json

@@ -1,32 +0,0 @@
-{
-  "name": "my-app",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "eslint . --ext .ts,.tsx",
-    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
-    "postinstall": "prisma generate"
-  },
-  "dependencies": {
-    "@prisma/client": "^5.8.0",
-    "next": "16.1.1",
-    "react": "19.2.3",
-    "react-dom": "19.2.3",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@tailwindcss/postcss": "^4",
-    "@types/node": "^20",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "eslint": "^9",
-    "eslint-config-next": "16.1.1",
-    "prettier": "^3.2.4",
-    "prisma": "^5.8.0",
-    "tailwindcss": "^4",
-    "typescript": "^5"
-  }
-}

package/templates/next-prisma-postgres-shadcn/prisma/schema.prisma

@@ -1,20 +0,0 @@
-// This is your Prisma schema file
-// Learn more about it in the docs: https://pris.ly/d/prisma-schema
-
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "postgresql"
-  url      = env("DATABASE_URL")
-}
-
-// Example model - replace with your own
-model User {
-  id        String   @id @default(cuid())
-  email     String   @unique
-  name      String?
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-}