stackkit-cli 0.1.0 → 0.1.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackkit-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for StackKit - Production-ready project generator and module system",
   "main": "dist/index.js",
   "bin": {
@@ -29,6 +29,12 @@
     "nextjs",
     "template"
   ],
+  "files": [
+    "dist",
+    "bin",
+    "templates",
+    "modules"
+  ],
   "author": "Your Name",
   "license": "MIT",
   "dependencies": {

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

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

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

@@ -0,0 +1,7 @@
+{
+  "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

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

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

@@ -0,0 +1,79 @@
+# StackKit Project
+
+This project was created with [StackKit](https://github.com/yourusername/stackkit).
+
+## Getting Started
+
+1. Install dependencies:
+
+```bash
+pnpm install
+```
+
+2. Copy the environment variables:
+
+```bash
+cp .env.example .env
+```
+
+3. Update the `DATABASE_URL` in `.env` with your PostgreSQL connection string.
+
+4. Run database migrations:
+
+```bash
+pnpm prisma migrate dev --name init
+```
+
+5. Start the development server:
+
+```bash
+pnpm dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+## Tech Stack
+
+- **Next.js 15** - React framework with App Router
+- **TypeScript** - Type-safe JavaScript
+- **Prisma** - Next-generation ORM
+- **PostgreSQL** - Robust relational database
+- **Tailwind CSS** - Utility-first CSS framework
+- **Zod** - TypeScript-first schema validation
+
+## Project Structure
+
+```
+├── app/                  # Next.js App Router
+│   ├── api/             # API routes
+│   ├── layout.tsx       # Root layout
+│   └── page.tsx         # Home page
+├── 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

@@ -0,0 +1,25 @@
+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

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

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

@@ -0,0 +1,22 @@
+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',
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>{children}</body>
+    </html>
+  );
+}

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

@@ -0,0 +1,29 @@
+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/db.ts

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

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

@@ -0,0 +1,15 @@
+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/next.config.ts

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

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

@@ -0,0 +1,32 @@
+{
+  "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

@@ -0,0 +1,20 @@
+// 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
+}

package/templates/next-prisma-postgres-shadcn/public/.gitkeep

@@ -0,0 +1 @@
+# This file is used to keep the public directory in git

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

@@ -0,0 +1,18 @@
+{
+  "name": "next-prisma-postgres-shadcn",
+  "displayName": "Next.js + Prisma + PostgreSQL + shadcn/ui",
+  "description": "Production-ready Next.js App Router with Prisma, PostgreSQL, shadcn/ui, and best practices",
+  "tags": ["nextjs", "prisma", "postgresql", "shadcn", "typescript"],
+  "defaultPackageManager": "pnpm",
+  "features": [
+    "Next.js 15 App Router",
+    "TypeScript",
+    "Prisma ORM",
+    "PostgreSQL",
+    "shadcn/ui components",
+    "Tailwind CSS",
+    "Environment validation (Zod)",
+    "ESLint + Prettier",
+    "Health check API route"
+  ]
+}

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

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}