stackpatch 1.1.9 → 1.2.1

package/dist/stackpatch.js

@@ -0,0 +1,1909 @@
+#!/usr/bin/env node
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var inquirer = require('inquirer');
+var chalk = require('chalk');
+var fse = require('fs-extra');
+var child_process = require('child_process');
+require('jimp');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// This file is executed via bin/stackpatch wrapper
+// ---------------- CONFIG ----------------
+// Get directory path - Works with both Bun and Node.js
+// Bun has import.meta.dir, Node.js doesn't - use fallback
+const CLI_DIR = undefined || path.dirname(new URL((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('stackpatch.js', document.baseURI).href))).pathname);
+// Resolve boilerplate path - use local boilerplate inside CLI package
+const BOILERPLATE_ROOT = path.resolve(CLI_DIR, "../boilerplate");
+const PATCHES = {
+    auth: {
+        path: "auth",
+        dependencies: ["next-auth", "react-hot-toast"],
+    },
+    "auth-ui": {
+        path: "auth",
+        dependencies: ["next-auth", "react-hot-toast"],
+    },
+    // Example for future patches:
+    // stripe: { path: "stripe", dependencies: ["stripe"] },
+    // redux: { path: "redux", dependencies: ["@reduxjs/toolkit", "react-redux"] },
+};
+const MANIFEST_VERSION = "1.0.0";
+// ---------------- Manifest & Tracking ----------------
+// Get manifest path for a target directory
+function getManifestPath(target) {
+    return path.join(target, ".stackpatch", "manifest.json");
+}
+// Read manifest if it exists
+function readManifest(target) {
+    const manifestPath = getManifestPath(target);
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// Write manifest
+function writeManifest(target, manifest) {
+    const manifestDir = path.join(target, ".stackpatch");
+    const manifestPath = getManifestPath(target);
+    if (!fs.existsSync(manifestDir)) {
+        fs.mkdirSync(manifestDir, { recursive: true });
+    }
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+}
+// Backup a file before modifying it
+function backupFile(filePath, target) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const backupDir = path.join(target, ".stackpatch", "backups");
+    if (!fs.existsSync(backupDir)) {
+        fs.mkdirSync(backupDir, { recursive: true });
+    }
+    const relativePath = path.relative(target, filePath);
+    const backupPath = path.join(backupDir, relativePath.replace(/\//g, "_").replace(/\\/g, "_"));
+    // Create directory structure in backup
+    const backupFileDir = path.dirname(backupPath);
+    if (!fs.existsSync(backupFileDir)) {
+        fs.mkdirSync(backupFileDir, { recursive: true });
+    }
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+// Restore a file from backup
+function restoreFile(backupPath, originalPath) {
+    if (!fs.existsSync(backupPath)) {
+        return false;
+    }
+    const originalDir = path.dirname(originalPath);
+    if (!fs.existsSync(originalDir)) {
+        fs.mkdirSync(originalDir, { recursive: true });
+    }
+    fs.copyFileSync(backupPath, originalPath);
+    return true;
+}
+// ---------------- Progress & UI Helpers ----------------
+// Show StackPatch logo (based on the actual SVG logo design)
+function showLogo() {
+    console.log("\n");
+    // StackPatch logo ASCII art
+    const logo = [
+        chalk.magentaBright("  _________ __                 __     __________         __         .__"),
+        chalk.magentaBright(" /   _____//  |______    ____ |  | __ \\\\______   \\_____ _/  |_  ____ |  |__"),
+        chalk.magentaBright(" \\_____  \\\\   __\\__  \\ _/ ___\\|  |/ /  |     ___/\\__  \\\\   __\\/ ___\\|  |  \\"),
+        chalk.magentaBright(" /        \\|  |  / __ \\\\  \\___|    <   |    |     / __ \\|  | \\  \\___|   Y  \\"),
+        chalk.magentaBright("/_______  /|__| (____  /\\___  >__|_ \\  |____|    (____  /__|  \\___  >___|  /"),
+        chalk.magentaBright("        \\/           \\/     \\/     \\/                 \\/          \\/     \\/"),
+        "",
+        chalk.white("  Composable frontend features for modern React & Next.js"),
+        chalk.gray("  Add authentication, UI components, and more with zero configuration"),
+        "",
+    ];
+    logo.forEach(line => console.log(line));
+}
+// Progress tracker with checkmarks
+class ProgressTracker {
+    steps = [];
+    addStep(name) {
+        this.steps.push({ name, status: "pending" });
+    }
+    startStep(index) {
+        if (index >= 0 && index < this.steps.length) {
+            this.steps[index].status = "processing";
+            const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+            let frameIndex = 0;
+            const step = this.steps[index];
+            const interval = setInterval(() => {
+                process.stdout.write(`\r${chalk.yellow(frames[frameIndex])} ${step.name}`);
+                frameIndex = (frameIndex + 1) % frames.length;
+            }, 100);
+            this.steps[index].interval = interval;
+        }
+    }
+    completeStep(index) {
+        if (index >= 0 && index < this.steps.length) {
+            if (this.steps[index].interval) {
+                clearInterval(this.steps[index].interval);
+                this.steps[index].interval = undefined;
+            }
+            process.stdout.write(`\r${chalk.green("✓")} ${this.steps[index].name}\n`);
+            this.steps[index].status = "completed";
+        }
+    }
+    failStep(index) {
+        if (index >= 0 && index < this.steps.length) {
+            if (this.steps[index].interval) {
+                clearInterval(this.steps[index].interval);
+                this.steps[index].interval = undefined;
+            }
+            process.stdout.write(`\r${chalk.red("✗")} ${this.steps[index].name}\n`);
+            this.steps[index].status = "failed";
+        }
+    }
+    getSteps() {
+        return this.steps;
+    }
+}
+// Helper function with spinner and checkmark
+async function withSpinner(text, fn) {
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    let frameIndex = 0;
+    const interval = setInterval(() => {
+        process.stdout.write(`\r${chalk.yellow(frames[frameIndex])} ${text}`);
+        frameIndex = (frameIndex + 1) % frames.length;
+    }, 100);
+    try {
+        const result = await fn();
+        clearInterval(interval);
+        process.stdout.write(`\r${chalk.green("✓")} ${text}\n`);
+        return result;
+    }
+    catch (error) {
+        clearInterval(interval);
+        process.stdout.write(`\r${chalk.red("✗")} ${text}\n`);
+        throw error;
+    }
+}
+async function copyFiles(src, dest) {
+    const addedFiles = [];
+    if (!fs.existsSync(src)) {
+        console.log(chalk.red(`❌ Boilerplate folder not found: ${src}`));
+        return { success: false, addedFiles: [] };
+    }
+    await fse.ensureDir(dest);
+    // Detect app directory location in target
+    const appDir = detectAppDirectory(dest);
+    const appDirPath = path.join(dest, appDir);
+    const componentsDir = detectComponentsDirectory(dest);
+    const componentsDirPath = path.join(dest, componentsDir);
+    const conflicts = [];
+    // Check for conflicts before copying
+    const entries = fse.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === "app") {
+            // For app directory, check conflicts in the detected app directory
+            if (fs.existsSync(appDirPath)) {
+                const appEntries = fse.readdirSync(path.join(src, "app"), { withFileTypes: true });
+                for (const appEntry of appEntries) {
+                    const destAppPath = path.join(appDirPath, appEntry.name);
+                    if (fs.existsSync(destAppPath)) {
+                        conflicts.push(destAppPath);
+                    }
+                }
+            }
+        }
+        else if (entry.name === "components") {
+            // For components directory, check conflicts in the detected components directory
+            if (fs.existsSync(componentsDirPath)) {
+                const componentEntries = fse.readdirSync(path.join(src, "components"), { withFileTypes: true });
+                for (const componentEntry of componentEntries) {
+                    const destComponentPath = path.join(componentsDirPath, componentEntry.name);
+                    if (fs.existsSync(destComponentPath)) {
+                        conflicts.push(destComponentPath);
+                    }
+                }
+            }
+        }
+        else {
+            // For other files/directories (middleware, etc.), check in root
+            const destPath = path.join(dest, entry.name);
+            if (fs.existsSync(destPath)) {
+                conflicts.push(destPath);
+            }
+        }
+    }
+    if (conflicts.length) {
+        console.log(chalk.yellow("\n⚠️ The following files already exist:"));
+        conflicts.forEach((f) => console.log(`  ${f}`));
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "overwrite",
+                message: "Do you want to overwrite them?",
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.red("\nAborted! No files were copied."));
+            return { success: false, addedFiles: [] };
+        }
+    }
+    // Track files from SOURCE (boilerplate) before copying
+    // This ensures we only track files that are actually from StackPatch
+    function trackSourceFiles(srcDir, baseDir, targetBase) {
+        if (!fs.existsSync(srcDir))
+            return;
+        const files = fs.readdirSync(srcDir, { withFileTypes: true });
+        for (const file of files) {
+            const srcFilePath = path.join(srcDir, file.name);
+            if (file.isDirectory()) {
+                trackSourceFiles(srcFilePath, baseDir, targetBase);
+            }
+            else {
+                const relativePath = path.relative(baseDir, srcFilePath);
+                const targetPath = targetBase
+                    ? path.join(targetBase, relativePath).replace(/\\/g, "/")
+                    : relativePath.replace(/\\/g, "/");
+                addedFiles.push(targetPath);
+            }
+        }
+    }
+    // Copy files with smart app directory handling
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        if (entry.name === "app") {
+            // Track files from SOURCE boilerplate before copying
+            trackSourceFiles(srcPath, srcPath, appDir);
+            // Copy app directory contents to the detected app directory location
+            await fse.ensureDir(appDirPath);
+            await fse.copy(srcPath, appDirPath, { overwrite: true });
+        }
+        else if (entry.name === "components") {
+            // Track files from SOURCE boilerplate before copying
+            trackSourceFiles(srcPath, srcPath, componentsDir);
+            // Copy components directory to the detected components directory location
+            await fse.ensureDir(componentsDirPath);
+            await fse.copy(srcPath, componentsDirPath, { overwrite: true });
+        }
+        else {
+            // For root-level files/directories, track from source
+            const srcStat = fs.statSync(srcPath);
+            if (srcStat.isDirectory()) {
+                trackSourceFiles(srcPath, srcPath, "");
+            }
+            else {
+                addedFiles.push(entry.name);
+            }
+            // Copy other files/directories (middleware, etc.) to root
+            const destPath = path.join(dest, entry.name);
+            await fse.copy(srcPath, destPath, { overwrite: true });
+        }
+    }
+    // Update imports in copied files to use correct paths
+    updateImportsInFiles(dest);
+    return { success: true, addedFiles };
+}
+// Detect the app directory location (app/ or src/app/)
+function detectAppDirectory(target) {
+    // Check for src/app first (more common in modern Next.js projects)
+    if (fs.existsSync(path.join(target, "src", "app"))) {
+        return "src/app";
+    }
+    // Check for app directory
+    if (fs.existsSync(path.join(target, "app"))) {
+        return "app";
+    }
+    // Check for src/pages (legacy)
+    if (fs.existsSync(path.join(target, "src", "pages"))) {
+        return "src/pages";
+    }
+    // Check for pages (legacy)
+    if (fs.existsSync(path.join(target, "pages"))) {
+        return "pages";
+    }
+    // Default to app if nothing found (will fail gracefully later)
+    return "app";
+}
+// Detect the components directory location (components/ or src/components/)
+function detectComponentsDirectory(target) {
+    const appDir = detectAppDirectory(target);
+    // If app is in src/app, components should be in src/components
+    if (appDir.startsWith("src/")) {
+        // Check if src/components exists
+        if (fs.existsSync(path.join(target, "src", "components"))) {
+            return "src/components";
+        }
+        // Even if it doesn't exist yet, return src/components to match app structure
+        return "src/components";
+    }
+    // If app is in root, components should be in root
+    if (fs.existsSync(path.join(target, "components"))) {
+        return "components";
+    }
+    // Default to components
+    return "components";
+}
+// Detect path aliases from tsconfig.json
+function detectPathAliases(target) {
+    const tsconfigPath = path.join(target, "tsconfig.json");
+    if (!fs.existsSync(tsconfigPath)) {
+        return null;
+    }
+    try {
+        const tsconfigContent = fs.readFileSync(tsconfigPath, "utf-8");
+        const tsconfig = JSON.parse(tsconfigContent);
+        const paths = tsconfig.compilerOptions?.paths;
+        if (!paths || typeof paths !== "object") {
+            return null;
+        }
+        // Look for common aliases like @/*, ~/*, etc.
+        for (const [alias, pathsArray] of Object.entries(paths)) {
+            if (Array.isArray(pathsArray) && pathsArray.length > 0) {
+                // Remove the /* from alias (e.g., "@/*" -> "@")
+                const cleanAlias = alias.replace(/\/\*$/, "");
+                // Get the first path and remove /* from it
+                const cleanPath = pathsArray[0].replace(/\/\*$/, "");
+                return { alias: cleanAlias, path: cleanPath };
+            }
+        }
+    }
+    catch (error) {
+        // If parsing fails, return null
+        return null;
+    }
+    return null;
+}
+// Generate import path for components
+function generateComponentImportPath(target, componentName, fromFile) {
+    const pathAlias = detectPathAliases(target);
+    const componentsDir = detectComponentsDirectory(target);
+    // If we have a path alias, use it
+    if (pathAlias) {
+        // Check if the alias path matches components directory
+        const aliasPath = pathAlias.path.replace(/^\.\//, ""); // Remove leading ./
+        // If alias points to root and components is in root, use alias
+        if (aliasPath === "" && componentsDir === "components") {
+            return `${pathAlias.alias}/components/${componentName}`;
+        }
+        // If alias points to src and components is in src/components, use alias
+        if (aliasPath === "src" && componentsDir === "src/components") {
+            return `${pathAlias.alias}/components/${componentName}`;
+        }
+        // Try to match the alias path structure
+        if (componentsDir.startsWith(aliasPath)) {
+            const relativeFromAlias = componentsDir.replace(new RegExp(`^${aliasPath}/?`), "");
+            return `${pathAlias.alias}/${relativeFromAlias}/${componentName}`;
+        }
+        // If alias path is "./" (root), components should be accessible via alias
+        if (aliasPath === "" || aliasPath === ".") {
+            return `${pathAlias.alias}/components/${componentName}`;
+        }
+    }
+    // Fallback: calculate relative path
+    // fromFile is the full path to the file we're importing into
+    const fromDir = path.dirname(fromFile);
+    const toComponents = path.join(target, componentsDir);
+    // Calculate relative path from the file's directory to components directory
+    const relativePath = path.relative(fromDir, toComponents).replace(/\\/g, "/");
+    const normalizedPath = relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+    return `${normalizedPath}/${componentName}`;
+}
+// Update imports in copied files to use correct paths
+function updateImportsInFiles(target) {
+    const appDir = detectAppDirectory(target);
+    const appDirPath = path.join(target, appDir);
+    if (!fs.existsSync(appDirPath)) {
+        return;
+    }
+    // Recursively find all .tsx and .ts files in the app directory
+    function findFiles(dir, fileList = []) {
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                findFiles(filePath, fileList);
+            }
+            else if (file.endsWith('.tsx') || file.endsWith('.ts')) {
+                fileList.push(filePath);
+            }
+        }
+        return fileList;
+    }
+    const files = findFiles(appDirPath);
+    for (const filePath of files) {
+        try {
+            let content = fs.readFileSync(filePath, 'utf-8');
+            let updated = false;
+            // Match imports like: from "@/components/component-name"
+            const importRegex = /from\s+["']@\/components\/([^"']+)["']/g;
+            const matches = Array.from(content.matchAll(importRegex));
+            for (const match of matches) {
+                const componentName = match[1];
+                const oldImport = match[0];
+                const newImportPath = generateComponentImportPath(target, componentName, filePath);
+                const newImport = oldImport.replace(/@\/components\/[^"']+/, newImportPath);
+                content = content.replace(oldImport, newImport);
+                updated = true;
+            }
+            if (updated) {
+                fs.writeFileSync(filePath, content, 'utf-8');
+            }
+        }
+        catch (error) {
+            // Silently skip files that can't be processed
+            continue;
+        }
+    }
+}
+// Check if dependency exists in package.json
+function hasDependency(target, depName) {
+    const packageJsonPath = path.join(target, "package.json");
+    if (!fs.existsSync(packageJsonPath))
+        return false;
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+        return !!deps[depName];
+    }
+    catch {
+        return false;
+    }
+}
+// Install dependencies (only missing ones)
+function installDependencies(target, deps) {
+    if (deps.length === 0)
+        return;
+    const missingDeps = deps.filter(dep => !hasDependency(target, dep));
+    if (missingDeps.length === 0) {
+        return; // Already installed, spinner will show completion
+    }
+    const result = child_process.spawnSync("pnpm", ["add", ...missingDeps], {
+        cwd: target,
+        stdio: "pipe",
+    });
+    if (result.status !== 0) {
+        throw new Error(`Failed to install dependencies: ${missingDeps.join(", ")}`);
+    }
+}
+// Remove dependencies from package.json
+function removeDependencies(target, deps) {
+    if (deps.length === 0)
+        return true;
+    const packageJsonPath = path.join(target, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        return false;
+    }
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        let modified = false;
+        // Remove from dependencies
+        if (packageJson.dependencies) {
+            for (const dep of deps) {
+                if (packageJson.dependencies[dep]) {
+                    delete packageJson.dependencies[dep];
+                    modified = true;
+                }
+            }
+        }
+        // Remove from devDependencies
+        if (packageJson.devDependencies) {
+            for (const dep of deps) {
+                if (packageJson.devDependencies[dep]) {
+                    delete packageJson.devDependencies[dep];
+                    modified = true;
+                }
+            }
+        }
+        if (modified) {
+            fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf-8");
+        }
+        return modified;
+    }
+    catch {
+        return false;
+    }
+}
+// Get all parent directories of a file path
+function getParentDirectories(filePath, rootPath) {
+    const dirs = [];
+    let current = path.dirname(filePath);
+    const root = path.resolve(rootPath);
+    while (current !== root && current !== path.dirname(current)) {
+        dirs.push(current);
+        current = path.dirname(current);
+    }
+    return dirs;
+}
+// Update layout.tsx to include Toaster
+function updateLayoutForToaster(target) {
+    const appDir = detectAppDirectory(target);
+    const layoutPath = path.join(target, appDir, "layout.tsx");
+    if (!fs.existsSync(layoutPath)) {
+        return { success: false, modified: false, filePath: layoutPath };
+    }
+    try {
+        const originalContent = fs.readFileSync(layoutPath, "utf-8");
+        let layoutContent = originalContent;
+        // Check if already has Toaster
+        if (layoutContent.includes("Toaster")) {
+            console.log(chalk.green("✅ Layout already has Toaster!"));
+            return { success: true, modified: false, filePath: layoutPath };
+        }
+        // Generate the correct import path
+        const importPath = generateComponentImportPath(target, "toaster", layoutPath);
+        // Check if import already exists (check for various patterns)
+        const hasImport = layoutContent.includes("toaster") &&
+            (layoutContent.includes("from") || layoutContent.includes("import"));
+        if (!hasImport) {
+            // Find the last import statement
+            const lines = layoutContent.split("\n");
+            let lastImportIndex = -1;
+            for (let i = 0; i < lines.length; i++) {
+                const trimmed = lines[i].trim();
+                if (trimmed.startsWith("import ") && trimmed.endsWith(";")) {
+                    lastImportIndex = i;
+                }
+                else if (trimmed && !trimmed.startsWith("//") && lastImportIndex >= 0) {
+                    break;
+                }
+            }
+            if (lastImportIndex >= 0) {
+                lines.splice(lastImportIndex + 1, 0, `import { Toaster } from "${importPath}";`);
+                layoutContent = lines.join("\n");
+            }
+        }
+        // Add Toaster component before closing AuthSessionProvider
+        if (layoutContent.includes("</AuthSessionProvider>")) {
+            layoutContent = layoutContent.replace(/(<\/AuthSessionProvider>)/, '<Toaster />\n        $1');
+        }
+        else if (layoutContent.includes("{children}")) {
+            // If AuthSessionProvider wraps children, add Toaster after children
+            layoutContent = layoutContent.replace(/(\{children\})/, '$1\n          <Toaster />');
+        }
+        // Backup before modifying
+        backupFile(layoutPath, target);
+        fs.writeFileSync(layoutPath, layoutContent, "utf-8");
+        console.log(chalk.green("✅ Updated layout.tsx with Toaster!"));
+        const relativePath = path.relative(target, layoutPath).replace(/\\/g, "/");
+        return { success: true, modified: true, filePath: relativePath, originalContent };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.log(chalk.yellow(`⚠️  Failed to update layout with Toaster: ${errorMessage}`));
+        return { success: false, modified: false, filePath: layoutPath };
+    }
+}
+// Update layout.tsx to include AuthSessionProvider
+function updateLayoutForAuth(target) {
+    const appDir = detectAppDirectory(target);
+    const layoutPath = path.join(target, appDir, "layout.tsx");
+    if (!fs.existsSync(layoutPath)) {
+        console.log(chalk.yellow("⚠️  layout.tsx not found. Skipping layout update."));
+        return { success: false, modified: false, filePath: layoutPath };
+    }
+    try {
+        const originalContent = fs.readFileSync(layoutPath, "utf-8");
+        let layoutContent = originalContent;
+        // Check if already has AuthSessionProvider
+        if (layoutContent.includes("AuthSessionProvider")) {
+            console.log(chalk.green("✅ Layout already has AuthSessionProvider!"));
+            return { success: true, modified: false, filePath: layoutPath };
+        }
+        // Generate the correct import path
+        const importPath = generateComponentImportPath(target, "session-provider", layoutPath);
+        // Check if import already exists (check for various patterns)
+        const hasImport = layoutContent.includes("session-provider") &&
+            (layoutContent.includes("from") || layoutContent.includes("import"));
+        if (!hasImport) {
+            // Find the last import statement (before the first non-import line)
+            const lines = layoutContent.split("\n");
+            let lastImportIndex = -1;
+            for (let i = 0; i < lines.length; i++) {
+                const trimmed = lines[i].trim();
+                if (trimmed.startsWith("import ") && trimmed.endsWith(";")) {
+                    lastImportIndex = i;
+                }
+                else if (trimmed && !trimmed.startsWith("//") && lastImportIndex >= 0) {
+                    break;
+                }
+            }
+            if (lastImportIndex >= 0) {
+                lines.splice(lastImportIndex + 1, 0, `import { AuthSessionProvider } from "${importPath}";`);
+                layoutContent = lines.join("\n");
+            }
+            else {
+                // No imports found, add after the first line
+                const firstNewline = layoutContent.indexOf("\n");
+                if (firstNewline > 0) {
+                    layoutContent =
+                        layoutContent.slice(0, firstNewline + 1) +
+                            `import { AuthSessionProvider } from "${importPath}";\n` +
+                            layoutContent.slice(firstNewline + 1);
+                }
+                else {
+                    layoutContent = `import { AuthSessionProvider } from "${importPath}";\n` + layoutContent;
+                }
+            }
+        }
+        // Wrap children with AuthSessionProvider
+        // Look for {children} pattern in body tag
+        const childrenPattern = /(\s*)(\{children\})(\s*)/;
+        if (childrenPattern.test(layoutContent)) {
+            layoutContent = layoutContent.replace(childrenPattern, '$1<AuthSessionProvider>{children}</AuthSessionProvider>$3');
+        }
+        else {
+            // Try to find body tag and wrap its content
+            const bodyRegex = /(<body[^>]*>)([\s\S]*?)(<\/body>)/;
+            const bodyMatch = layoutContent.match(bodyRegex);
+            if (bodyMatch) {
+                const bodyContent = bodyMatch[2].trim();
+                if (bodyContent && !bodyContent.includes("AuthSessionProvider")) {
+                    layoutContent = layoutContent.replace(bodyRegex, `$1\n        <AuthSessionProvider>${bodyContent}</AuthSessionProvider>\n      $3`);
+                }
+            }
+        }
+        // Backup before modifying
+        backupFile(layoutPath, target);
+        fs.writeFileSync(layoutPath, layoutContent, "utf-8");
+        console.log(chalk.green("✅ Updated layout.tsx with AuthSessionProvider!"));
+        const relativePath = path.relative(target, layoutPath).replace(/\\/g, "/");
+        return { success: true, modified: true, filePath: relativePath, originalContent };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.log(chalk.red(`❌ Failed to update layout.tsx: ${errorMessage}`));
+        return { success: false, modified: false, filePath: layoutPath };
+    }
+}
+// Ask user which OAuth providers to configure
+async function askOAuthProviders() {
+    const { providers } = await inquirer.prompt([
+        {
+            type: "checkbox",
+            name: "providers",
+            message: "Which OAuth providers would you like to configure?",
+            choices: [
+                { name: "Google", value: "google", checked: true },
+                { name: "GitHub", value: "github", checked: true },
+                { name: "Email/Password (Credentials)", value: "credentials", checked: true },
+            ],
+            validate: (input) => {
+                if (input.length === 0) {
+                    return "Please select at least one provider";
+                }
+                return true;
+            },
+        },
+    ]);
+    return providers;
+}
+// Setup authentication with selected OAuth providers
+async function setupAuth(target, selectedProviders) {
+    const tracker = new ProgressTracker();
+    tracker.addStep("Setting up authentication");
+    tracker.addStep("Generating environment files");
+    tracker.addStep("Configuring NextAuth with selected providers");
+    tracker.addStep("Updating UI components");
+    try {
+        const appDir = detectAppDirectory(target);
+        const nextAuthRoutePath = path.join(target, appDir, "api/auth/[...nextauth]/route.ts");
+        if (!fs.existsSync(nextAuthRoutePath)) {
+            console.log(chalk.yellow("⚠️  NextAuth route not found, skipping auth setup"));
+            return false;
+        }
+        tracker.startStep(0);
+        // Step 1: Generate .env.example file
+        tracker.startStep(1);
+        await generateEnvExample(target, selectedProviders);
+        tracker.completeStep(1);
+        // Step 2: Update NextAuth route with selected providers
+        tracker.startStep(2);
+        await updateNextAuthWithProviders(nextAuthRoutePath, selectedProviders);
+        tracker.completeStep(2);
+        // Step 3: Update UI components
+        tracker.startStep(3);
+        await updateAuthButtonWithProviders(target, selectedProviders);
+        tracker.completeStep(3);
+        tracker.completeStep(0);
+        // Show OAuth setup instructions
+        await showOAuthSetupInstructions(target, selectedProviders);
+        return true;
+    }
+    catch (error) {
+        tracker.failStep(0);
+        return false;
+    }
+}
+// Show OAuth setup instructions
+async function showOAuthSetupInstructions(target, selectedProviders = ["google", "github", "credentials"]) {
+    const envLocalPath = path.join(target, ".env.local");
+    let hasGoogleCreds = false;
+    let hasGitHubCreds = false;
+    if (fs.existsSync(envLocalPath)) {
+        const envContent = fs.readFileSync(envLocalPath, "utf-8");
+        hasGoogleCreds = envContent.includes("GOOGLE_CLIENT_ID") &&
+            envContent.includes("GOOGLE_CLIENT_SECRET") &&
+            !envContent.includes("your_google_client_id_here");
+        hasGitHubCreds = envContent.includes("GITHUB_CLIENT_ID") &&
+            envContent.includes("GITHUB_CLIENT_SECRET") &&
+            !envContent.includes("your_github_client_id_here");
+    }
+    console.log(chalk.blue.bold("\n📋 OAuth Setup Instructions\n"));
+    const needsGoogle = selectedProviders.includes("google") && !hasGoogleCreds;
+    const needsGitHub = selectedProviders.includes("github") && !hasGitHubCreds;
+    if (needsGoogle || needsGitHub) {
+        console.log(chalk.yellow("⚠️  OAuth credentials not configured yet.\n"));
+        if (needsGoogle) {
+            console.log(chalk.cyan.bold("🔵 Google OAuth Setup:"));
+            console.log(chalk.white("   1. Go to: ") + chalk.underline("https://console.cloud.google.com/"));
+            console.log(chalk.white("   2. Create a new project or select existing one"));
+            console.log(chalk.white("   3. Navigate to: APIs & Services > Credentials"));
+            console.log(chalk.white("   4. Click: Create Credentials > OAuth client ID"));
+            console.log(chalk.white("   5. Choose: Web application"));
+            console.log(chalk.white("   6. Add Authorized redirect URI:"));
+            console.log(chalk.magentaBright("      → ") + chalk.bold("http://localhost:3000/api/auth/callback/google"));
+            console.log(chalk.white("   7. Copy Client ID and Client Secret"));
+            console.log(chalk.white("   8. Add them to your .env.local file:\n"));
+            console.log(chalk.gray("      GOOGLE_CLIENT_ID=your_client_id_here"));
+            console.log(chalk.gray("      GOOGLE_CLIENT_SECRET=your_client_secret_here\n"));
+        }
+        if (needsGitHub) {
+            console.log(chalk.cyan.bold("🐙 GitHub OAuth Setup:"));
+            console.log(chalk.white("   1. Go to: ") + chalk.underline("https://github.com/settings/developers"));
+            console.log(chalk.white("   2. Click: New OAuth App"));
+            console.log(chalk.white("   3. Fill in the form:"));
+            console.log(chalk.white("      - Application name: Your app name"));
+            console.log(chalk.white("      - Homepage URL: http://localhost:3000"));
+            console.log(chalk.white("      - Authorization callback URL:"));
+            console.log(chalk.magentaBright("        → ") + chalk.bold("http://localhost:3000/api/auth/callback/github"));
+            console.log(chalk.white("   4. Click: Register application"));
+            console.log(chalk.white("   5. Copy Client ID"));
+            console.log(chalk.white("   6. Generate a new Client Secret"));
+            console.log(chalk.white("   7. Add them to your .env.local file:\n"));
+            console.log(chalk.gray("      GITHUB_CLIENT_ID=your_client_id_here"));
+            console.log(chalk.gray("      GITHUB_CLIENT_SECRET=your_client_secret_here\n"));
+        }
+        if (selectedProviders.includes("google") || selectedProviders.includes("github")) {
+            console.log(chalk.blue.bold("📝 Required Redirect URIs:"));
+            if (selectedProviders.includes("google")) {
+                console.log(chalk.white("   For Google: ") + chalk.bold("http://localhost:3000/api/auth/callback/google"));
+            }
+            if (selectedProviders.includes("github")) {
+                console.log(chalk.white("   For GitHub: ") + chalk.bold("http://localhost:3000/api/auth/callback/github"));
+            }
+            console.log(chalk.gray("\n   For production, also add your production domain URLs\n"));
+        }
+        console.log(chalk.green("✅ Once configured, restart your dev server and test OAuth login!"));
+    }
+    else {
+        console.log(chalk.green("✅ OAuth credentials are configured!"));
+        console.log(chalk.white("   Make sure your redirect URIs are set in:"));
+        console.log(chalk.cyan("   - Google Cloud Console"));
+        console.log(chalk.cyan("   - GitHub OAuth App settings\n"));
+    }
+    console.log(chalk.blue.bold("\n📚 Documentation:"));
+    console.log(chalk.white("   - Complete guide: ") + chalk.cyan("README.md"));
+    console.log(chalk.white("   - Custom Auth: See comments in ") + chalk.cyan("app/api/auth/[...nextauth]/route.ts"));
+    console.log(chalk.white("   - Login/Signup: See comments in ") + chalk.cyan("app/auth/login/page.tsx") + " and " + chalk.cyan("app/auth/signup/page.tsx\n"));
+}
+// Generate .env.example file
+async function generateEnvExample(target, providers = ["google", "github", "credentials"]) {
+    const envExamplePath = path.join(target, ".env.example");
+    const envLocalPath = path.join(target, ".env.local");
+    // Generate a random secret for NEXTAUTH_SECRET
+    const generateSecret = () => {
+        if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues) {
+            return Array.from(globalThis.crypto.getRandomValues(new Uint8Array(32)))
+                .map(b => b.toString(16).padStart(2, '0'))
+                .join('');
+        }
+        // Fallback: generate random bytes
+        const bytes = new Uint8Array(32);
+        for (let i = 0; i < 32; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+        return Array.from(bytes)
+            .map(b => b.toString(16).padStart(2, '0'))
+            .join('');
+    };
+    let envContent = `# NextAuth Configuration
+NEXTAUTH_URL=http://localhost:3000
+NEXTAUTH_SECRET=${generateSecret()}
+
+`;
+    if (providers.includes("google")) {
+        envContent += `# Google OAuth
+GOOGLE_CLIENT_ID=your_google_client_id_here
+GOOGLE_CLIENT_SECRET=your_google_client_secret_here
+
+`;
+    }
+    if (providers.includes("github")) {
+        envContent += `# GitHub OAuth
+GITHUB_CLIENT_ID=your_github_client_id_here
+GITHUB_CLIENT_SECRET=your_github_client_secret_here
+
+`;
+    }
+    // Write .env.example
+    fs.writeFileSync(envExamplePath, envContent, "utf-8");
+    console.log(chalk.green("✅ Created .env.example file"));
+    // Create .env.local if it doesn't exist
+    if (!fs.existsSync(envLocalPath)) {
+        fs.writeFileSync(envLocalPath, envContent.replace(/your_.*_here/g, ""), "utf-8");
+        console.log(chalk.green("✅ Created .env.local file (update with your credentials)"));
+    }
+}
+// Update NextAuth route with providers
+async function updateNextAuthWithProviders(routePath, selectedProviders = ["google", "github", "credentials"]) {
+    // Build imports based on selected providers
+    const imports = ["import NextAuth from \"next-auth\";", "import type { NextAuthOptions } from \"next-auth\";"];
+    if (selectedProviders.includes("google")) {
+        imports.push("import GoogleProvider from \"next-auth/providers/google\";");
+    }
+    if (selectedProviders.includes("github")) {
+        imports.push("import GitHubProvider from \"next-auth/providers/github\";");
+    }
+    if (selectedProviders.includes("credentials")) {
+        imports.push("import CredentialsProvider from \"next-auth/providers/credentials\";");
+    }
+    // Build providers array
+    const providersArray = [];
+    if (selectedProviders.includes("credentials")) {
+        providersArray.push(`    CredentialsProvider({
+      name: "Credentials",
+      credentials: {
+        email: { label: "Email", type: "email" },
+        password: { label: "Password", type: "password" },
+      },
+      async authorize(credentials) {
+        // TODO: Replace with your actual authentication logic
+        // This is a placeholder that accepts any email/password
+        // In production, you should:
+        // 1. Validate credentials against your database
+        // 2. Hash and compare passwords
+        // 3. Return user object or null
+
+        if (!credentials?.email || !credentials?.password) {
+          return null;
+        }
+
+        // Example: Check against hardcoded credentials (REMOVE IN PRODUCTION)
+        // Replace this with your database lookup
+        if (
+          credentials.email === "demo@example.com" &&
+          credentials.password === "demo123"
+        ) {
+          return {
+            id: "1",
+            email: credentials.email,
+            name: "Demo User",
+          };
+        }
+
+        // If credentials don't match, return null
+        return null;
+      },
+    })`);
+    }
+    if (selectedProviders.includes("google")) {
+        providersArray.push(`    GoogleProvider({
+      clientId: process.env.GOOGLE_CLIENT_ID!,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+    })`);
+    }
+    if (selectedProviders.includes("github")) {
+        providersArray.push(`    GitHubProvider({
+      clientId: process.env.GITHUB_CLIENT_ID!,
+      clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+    })`);
+    }
+    const providerAuthContent = `${imports.join("\n")}
+
+export const authOptions: NextAuthOptions = {
+  providers: [
+${providersArray.join(",\n")}
+  ],
+  pages: {
+    signIn: "/auth/login",
+    error: "/auth/error",
+  },
+  session: {
+    strategy: "jwt",
+  },
+  callbacks: {
+    async jwt({ token, user, account }) {
+      if (user) {
+        token.id = user.id;
+        token.email = user.email;
+        token.name = user.name;
+      }
+      if (account) {
+        token.accessToken = account.access_token;
+        token.provider = account.provider;
+      }
+      return token;
+    },
+    async session({ session, token }) {
+      if (session.user) {
+        session.user.id = token.id as string;
+        session.accessToken = token.accessToken as string;
+        session.provider = token.provider as string;
+      }
+      return session;
+    },
+  },
+};
+
+const handler = NextAuth(authOptions);
+
+export { handler as GET, handler as POST };
+`;
+    fs.writeFileSync(routePath, providerAuthContent, "utf-8");
+}
+// Copy protected route files
+async function copyProtectedRouteFiles(target) {
+    const protectedRouteSrc = path.join(BOILERPLATE_ROOT, "auth/components/protected-route.tsx");
+    const middlewareSrc = path.join(BOILERPLATE_ROOT, "auth/middleware.ts");
+    const componentsDir = detectComponentsDirectory(target);
+    const componentsDirPath = path.join(target, componentsDir);
+    const protectedRouteDest = path.join(componentsDirPath, "protected-route.tsx");
+    const middlewareDest = path.join(target, "middleware.ts");
+    // Ensure components directory exists
+    if (!fs.existsSync(componentsDirPath)) {
+        fs.mkdirSync(componentsDirPath, { recursive: true });
+    }
+    // Copy protected route component
+    if (fs.existsSync(protectedRouteSrc)) {
+        fs.copyFileSync(protectedRouteSrc, protectedRouteDest);
+    }
+    // Copy middleware (only if it doesn't exist)
+    if (fs.existsSync(middlewareSrc) && !fs.existsSync(middlewareDest)) {
+        fs.copyFileSync(middlewareSrc, middlewareDest);
+    }
+    // Copy auth navbar component (demo/example - won't overwrite existing navbar)
+    const authNavbarSrc = path.join(BOILERPLATE_ROOT, "auth/components/auth-navbar.tsx");
+    const authNavbarDest = path.join(componentsDirPath, "auth-navbar.tsx");
+    if (fs.existsSync(authNavbarSrc)) {
+        // Only copy if it doesn't exist (won't overwrite)
+        if (!fs.existsSync(authNavbarDest)) {
+            fs.copyFileSync(authNavbarSrc, authNavbarDest);
+        }
+    }
+    // Copy example pages (only if they don't exist)
+    const appDir = detectAppDirectory(target);
+    const dashboardPageSrc = path.join(BOILERPLATE_ROOT, "auth/app/dashboard/page.tsx");
+    const landingPageSrc = path.join(BOILERPLATE_ROOT, "auth/app/page.tsx");
+    const dashboardPageDest = path.join(target, appDir, "dashboard/page.tsx");
+    const landingPageDest = path.join(target, appDir, "page.tsx");
+    // Create dashboard directory if needed
+    const dashboardDir = path.join(target, appDir, "dashboard");
+    if (!fs.existsSync(dashboardDir)) {
+        fs.mkdirSync(dashboardDir, { recursive: true });
+    }
+    // Copy dashboard page (only if it doesn't exist)
+    if (fs.existsSync(dashboardPageSrc) && !fs.existsSync(dashboardPageDest)) {
+        fs.copyFileSync(dashboardPageSrc, dashboardPageDest);
+    }
+    // Copy landing page (only if it doesn't exist or is default)
+    if (fs.existsSync(landingPageSrc)) {
+        // Check if current page is just a default Next.js page
+        if (fs.existsSync(landingPageDest)) {
+            const currentContent = fs.readFileSync(landingPageDest, "utf-8");
+            // Only replace if it's the default Next.js page
+            if (currentContent.includes("Get started by editing") || currentContent.length < 500) {
+                fs.copyFileSync(landingPageSrc, landingPageDest);
+            }
+        }
+        else {
+            fs.copyFileSync(landingPageSrc, landingPageDest);
+        }
+    }
+}
+// Update auth button with OAuth providers
+async function updateAuthButtonWithProviders(target, selectedProviders = ["google", "github", "credentials"]) {
+    const componentsDir = detectComponentsDirectory(target);
+    const authButtonPath = path.join(target, componentsDir, "auth-button.tsx");
+    if (fs.existsSync(authButtonPath)) {
+        // Build OAuth buttons based on selected providers
+        const oauthButtons = [];
+        if (selectedProviders.includes("google")) {
+            oauthButtons.push(`      <button
+        onClick={() => signIn("google")}
+        className="flex items-center gap-2 rounded-md bg-white px-4 py-2 text-sm font-medium text-zinc-900 ring-1 ring-inset ring-zinc-300 hover:bg-zinc-50 dark:bg-zinc-800 dark:text-zinc-50 dark:ring-zinc-700 dark:hover:bg-zinc-700"
+      >
+        <svg className="h-4 w-4" viewBox="0 0 24 24">
+          <path
+            fill="currentColor"
+            d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
+          />
+          <path
+            fill="currentColor"
+            d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
+          />
+          <path
+            fill="currentColor"
+            d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z"
+          />
+          <path
+            fill="currentColor"
+            d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
+          />
+        </svg>
+        Google
+      </button>`);
+        }
+        if (selectedProviders.includes("github")) {
+            oauthButtons.push(`      <button
+        onClick={() => signIn("github")}
+        className="flex items-center gap-2 rounded-md bg-zinc-900 px-4 py-2 text-sm font-medium text-white hover:bg-zinc-700 dark:bg-zinc-50 dark:text-zinc-900 dark:hover:bg-zinc-200"
+      >
+        <svg className="h-4 w-4" fill="currentColor" viewBox="0 0 24 24">
+          <path
+            fillRule="evenodd"
+            d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482C19.138 20.197 22 16.425 22 12.017 22 6.484 17.522 2 12 2z"
+            clipRule="evenodd"
+          />
+        </svg>
+        GitHub
+      </button>`);
+        }
+        const authButtonContent = `"use client";
+
+import { signIn, signOut, useSession } from "next-auth/react";
+
+export function AuthButton() {
+  const { data: session, status } = useSession();
+
+  if (status === "loading") {
+    return (
+      <button
+        disabled
+        className="rounded-md bg-zinc-100 px-4 py-2 text-sm font-medium text-zinc-900 dark:bg-zinc-800 dark:text-zinc-50"
+      >
+        Loading...
+      </button>
+    );
+  }
+
+  if (session) {
+    return (
+      <div className="flex items-center gap-4">
+        <span className="text-sm text-zinc-600 dark:text-zinc-400">
+          {session.user?.email}
+        </span>
+        <button
+          onClick={() => signOut()}
+          className="rounded-md bg-zinc-900 px-4 py-2 text-sm font-medium text-white hover:bg-zinc-700 dark:bg-zinc-50 dark:text-zinc-900 dark:hover:bg-zinc-200"
+        >
+          Sign out
+        </button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex items-center gap-2">
+${oauthButtons.join("\n")}
+    </div>
+  );
+}
+`;
+        fs.writeFileSync(authButtonPath, authButtonContent, "utf-8");
+    }
+}
+// Show welcome screen with ASCII art
+async function showWelcome() {
+    showLogo();
+}
+// Create a new project from template
+async function createProject(projectName, showWelcomeScreen = true, forceOverwrite = false) {
+    const templatePath = path.join(BOILERPLATE_ROOT, "template");
+    const targetPath = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(targetPath)) {
+        if (!forceOverwrite) {
+            console.log(chalk.yellow(`⚠️  Directory "${projectName}" already exists!`));
+            const { overwrite } = await inquirer.prompt([
+                {
+                    type: "confirm",
+                    name: "overwrite",
+                    message: chalk.white("Do you want to overwrite it? (This will delete existing files)"),
+                    default: false,
+                },
+            ]);
+            if (!overwrite) {
+                console.log(chalk.gray("Cancelled. Choose a different name."));
+                process.exit(0);
+            }
+        }
+        // Remove existing directory if overwriting
+        console.log(chalk.yellow(`Removing existing directory "${projectName}"...`));
+        fs.rmSync(targetPath, { recursive: true, force: true });
+    }
+    if (showWelcomeScreen) {
+        showLogo();
+    }
+    console.log(chalk.blue.bold(`🚀 Creating new StackPatch project: ${chalk.white(projectName)}\n`));
+    const tracker = new ProgressTracker();
+    tracker.addStep("Copying project template");
+    tracker.addStep("Processing project files");
+    tracker.addStep("Installing dependencies");
+    // Step 1: Copy template
+    tracker.startStep(0);
+    await fse.copy(templatePath, targetPath);
+    tracker.completeStep(0);
+    // Step 2: Replace placeholders in files
+    tracker.startStep(1);
+    // Detect app directory for template processing
+    const appDir = detectAppDirectory(targetPath);
+    const filesToProcess = [
+        "package.json",
+        `${appDir}/layout.tsx`,
+        `${appDir}/page.tsx`,
+        "README.md",
+    ];
+    for (const file of filesToProcess) {
+        const filePath = path.join(targetPath, file);
+        if (fs.existsSync(filePath)) {
+            let content = fs.readFileSync(filePath, "utf-8");
+            content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+            fs.writeFileSync(filePath, content, "utf-8");
+        }
+    }
+    tracker.completeStep(1);
+    // Step 3: Install dependencies
+    tracker.startStep(2);
+    const installResult = child_process.spawnSync("pnpm", ["install"], {
+        cwd: targetPath,
+        stdio: "pipe",
+    });
+    if (installResult.status !== 0) {
+        tracker.failStep(2);
+        console.log(chalk.yellow("\n⚠️  Dependency installation had issues. You can run 'pnpm install' manually."));
+    }
+    else {
+        tracker.completeStep(2);
+    }
+    console.log(chalk.green(`\n✅ Project "${projectName}" created successfully!`));
+    // Automatically add auth-ui after creating the project
+    console.log(chalk.blue.bold(`\n🔐 Adding authentication to your project...\n`));
+    const authSrc = path.join(BOILERPLATE_ROOT, PATCHES["auth-ui"].path);
+    const authCopyResult = await copyFiles(authSrc, targetPath);
+    if (authCopyResult.success) {
+        const addedFiles = authCopyResult.addedFiles;
+        const modifiedFiles = [];
+        // Install auth dependencies (only if missing)
+        installDependencies(targetPath, PATCHES["auth-ui"].dependencies);
+        // Ask which OAuth providers to configure
+        const selectedProviders = await askOAuthProviders();
+        // Setup authentication with selected providers
+        const success = await setupAuth(targetPath, selectedProviders);
+        if (success) {
+            await withSpinner("Updating layout with AuthSessionProvider", () => {
+                const result = updateLayoutForAuth(targetPath);
+                if (result.modified && result.originalContent) {
+                    modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                }
+                return true;
+            });
+            await withSpinner("Adding Toaster component", () => {
+                const result = updateLayoutForToaster(targetPath);
+                if (result.modified && result.originalContent) {
+                    modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                }
+                return true;
+            });
+            await withSpinner("Setting up protected routes", () => {
+                copyProtectedRouteFiles(targetPath);
+                return true;
+            });
+            // Show OAuth setup instructions
+            await showOAuthSetupInstructions(targetPath, selectedProviders);
+            // Create manifest
+            const manifest = {
+                version: MANIFEST_VERSION,
+                patchName: "auth-ui",
+                target: targetPath,
+                timestamp: new Date().toISOString(),
+                files: {
+                    added: addedFiles,
+                    modified: modifiedFiles,
+                    backedUp: [],
+                },
+                dependencies: PATCHES["auth-ui"].dependencies,
+                oauthProviders: selectedProviders,
+            };
+            writeManifest(targetPath, manifest);
+            console.log(chalk.green("\n✅ Authentication added successfully!"));
+        }
+        else {
+            console.log(chalk.yellow("\n⚠️  Authentication setup had some issues. You can run 'npx stackpatch add auth-ui' manually."));
+        }
+    }
+    else {
+        console.log(chalk.yellow("\n⚠️  Could not add authentication. You can run 'npx stackpatch add auth-ui' manually."));
+    }
+    console.log(chalk.blue("\n📦 Next steps:"));
+    console.log(chalk.white(`  ${chalk.cyan("cd")} ${chalk.yellow(projectName)}`));
+    console.log(chalk.white(`  ${chalk.cyan("pnpm")} ${chalk.yellow("dev")}`));
+    console.log(chalk.white(`  Test authentication at: ${chalk.cyan("http://localhost:3000/auth/login")}`));
+    console.log(chalk.gray("\n📚 See README.md for OAuth setup and protected routes\n"));
+}
+// ---------------- Main CLI ----------------
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const projectName = args[1];
+    const skipPrompts = args.includes("--yes") || args.includes("-y");
+    // Show logo on startup
+    showLogo();
+    // Handle: bun create stackpatch@latest (no project name)
+    // Show welcome and prompt for project name
+    if (!command || command.startsWith("-")) {
+        const { name } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "name",
+                message: chalk.white("Enter your project name or path (relative to current directory)"),
+                default: "my-stackpatch-app",
+                validate: (input) => {
+                    if (!input.trim()) {
+                        return "Project name cannot be empty";
+                    }
+                    return true;
+                },
+            },
+        ]);
+        await createProject(name.trim(), false, skipPrompts); // Don't show welcome again
+        return;
+    }
+    // Handle: npx stackpatch revert
+    if (command === "revert") {
+        let target = process.cwd();
+        // Auto-detect target directory
+        const hasAppDir = fs.existsSync(path.join(target, "app")) || fs.existsSync(path.join(target, "src", "app"));
+        const hasPagesDir = fs.existsSync(path.join(target, "pages")) || fs.existsSync(path.join(target, "src", "pages"));
+        if (!hasAppDir && !hasPagesDir) {
+            const parent = path.resolve(target, "..");
+            if (fs.existsSync(path.join(parent, "app")) ||
+                fs.existsSync(path.join(parent, "src", "app")) ||
+                fs.existsSync(path.join(parent, "pages")) ||
+                fs.existsSync(path.join(parent, "src", "pages"))) {
+                target = parent;
+            }
+        }
+        const manifest = readManifest(target);
+        if (!manifest) {
+            console.log(chalk.red("❌ No StackPatch installation found to revert."));
+            console.log(chalk.yellow("   Make sure you're in the correct directory where you ran 'stackpatch add'."));
+            process.exit(1);
+        }
+        console.log(chalk.blue.bold("\n🔄 Reverting StackPatch installation\n"));
+        console.log(chalk.white(`   Patch: ${chalk.cyan(manifest.patchName)}`));
+        console.log(chalk.white(`   Installed: ${chalk.gray(new Date(manifest.timestamp).toLocaleString())}\n`));
+        // Show what will be reverted
+        console.log(chalk.white("   Files to remove: ") + chalk.cyan(`${manifest.files.added.length}`));
+        console.log(chalk.white("   Files to restore: ") + chalk.cyan(`${manifest.files.modified.length}`));
+        if (manifest.dependencies.length > 0) {
+            console.log(chalk.white("   Dependencies to remove: ") + chalk.cyan(`${manifest.dependencies.join(", ")}`));
+        }
+        console.log();
+        const { confirm } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "confirm",
+                message: "Are you sure you want to revert this installation? This will remove all added files, restore modified files, and remove dependencies.",
+                default: false,
+            },
+        ]);
+        if (!confirm) {
+            console.log(chalk.yellow("\n← Revert cancelled"));
+            return;
+        }
+        console.log(chalk.blue("\n🔄 Starting revert process...\n"));
+        let removedCount = 0;
+        let restoredCount = 0;
+        let failedRemovals = [];
+        let failedRestorations = [];
+        const directoriesToCheck = new Set();
+        // Step 1: Get list of valid StackPatch files from boilerplate
+        // This ensures we only remove files that are actually from StackPatch
+        const boilerplatePath = path.join(BOILERPLATE_ROOT, manifest.patchName === "auth-ui" ? "auth" : manifest.patchName);
+        const validStackPatchFiles = new Set();
+        function collectBoilerplateFiles(srcDir, baseDir, targetBase) {
+            if (!fs.existsSync(srcDir))
+                return;
+            const files = fs.readdirSync(srcDir, { withFileTypes: true });
+            for (const file of files) {
+                const srcFilePath = path.join(srcDir, file.name);
+                if (file.isDirectory()) {
+                    collectBoilerplateFiles(srcFilePath, baseDir, targetBase);
+                }
+                else {
+                    const relativePath = path.relative(baseDir, srcFilePath);
+                    const targetPath = targetBase
+                        ? path.join(targetBase, relativePath).replace(/\\/g, "/")
+                        : relativePath.replace(/\\/g, "/");
+                    validStackPatchFiles.add(targetPath);
+                }
+            }
+        }
+        // Collect files from boilerplate app directory
+        const appDir = detectAppDirectory(target);
+        const componentsDir = detectComponentsDirectory(target);
+        const boilerplateAppPath = path.join(boilerplatePath, "app");
+        const boilerplateComponentsPath = path.join(boilerplatePath, "components");
+        if (fs.existsSync(boilerplateAppPath)) {
+            collectBoilerplateFiles(boilerplateAppPath, boilerplateAppPath, appDir);
+        }
+        if (fs.existsSync(boilerplateComponentsPath)) {
+            collectBoilerplateFiles(boilerplateComponentsPath, boilerplateComponentsPath, componentsDir);
+        }
+        // Collect root-level files
+        if (fs.existsSync(boilerplatePath)) {
+            const entries = fs.readdirSync(boilerplatePath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name !== "app" && entry.name !== "components") {
+                    const srcPath = path.join(boilerplatePath, entry.name);
+                    if (entry.isDirectory()) {
+                        collectBoilerplateFiles(srcPath, srcPath, "");
+                    }
+                    else {
+                        validStackPatchFiles.add(entry.name);
+                    }
+                }
+            }
+        }
+        // Step 1: Remove added files (only if they're actually from StackPatch boilerplate)
+        console.log(chalk.white("📁 Removing added files..."));
+        for (const filePath of manifest.files.added) {
+            // Only remove if this file is actually in the boilerplate
+            if (!validStackPatchFiles.has(filePath)) {
+                console.log(chalk.gray(`   ⊘ Skipped (not in boilerplate): ${filePath}`));
+                continue;
+            }
+            const fullPath = path.join(target, filePath);
+            if (fs.existsSync(fullPath)) {
+                try {
+                    fs.unlinkSync(fullPath);
+                    console.log(chalk.green(`   ✓ Removed: ${filePath}`));
+                    removedCount++;
+                    // Track parent directories for cleanup
+                    const parentDirs = getParentDirectories(fullPath, target);
+                    parentDirs.forEach(dir => directoriesToCheck.add(dir));
+                }
+                catch (error) {
+                    console.log(chalk.yellow(`   ⚠ Could not remove: ${filePath}`));
+                    failedRemovals.push(filePath);
+                }
+            }
+            else {
+                console.log(chalk.gray(`   ⊘ Already removed: ${filePath}`));
+            }
+        }
+        // Step 2: Remove .env.local and .env.example if they were created by StackPatch
+        console.log(chalk.white("\n🔐 Removing environment files..."));
+        const envFilesToRemove = manifest.files.envFiles || [];
+        // Fallback: check for common env files if not tracked in manifest (for older manifests)
+        if (envFilesToRemove.length === 0) {
+            const commonEnvFiles = [".env.local", ".env.example"];
+            for (const envFile of commonEnvFiles) {
+                const envPath = path.join(target, envFile);
+                if (fs.existsSync(envPath)) {
+                    try {
+                        // Check if this file was created by StackPatch (contains NEXTAUTH_SECRET)
+                        const content = fs.readFileSync(envPath, "utf-8");
+                        if (content.includes("NEXTAUTH_SECRET") || content.includes("NEXTAUTH_URL")) {
+                            envFilesToRemove.push(envFile);
+                        }
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+            }
+        }
+        for (const envFile of envFilesToRemove) {
+            const envPath = path.join(target, envFile);
+            if (fs.existsSync(envPath)) {
+                try {
+                    fs.unlinkSync(envPath);
+                    console.log(chalk.green(`   ✓ Removed: ${envFile}`));
+                    removedCount++;
+                }
+                catch (error) {
+                    console.log(chalk.yellow(`   ⚠ Could not remove: ${envFile}`));
+                    failedRemovals.push(envFile);
+                }
+            }
+            else {
+                console.log(chalk.gray(`   ⊘ Already removed: ${envFile}`));
+            }
+        }
+        // Step 3: Restore modified files from originalContent in manifest
+        // This is more reliable than backups since it contains the true original content
+        console.log(chalk.white("\n📝 Restoring modified files..."));
+        for (const modified of manifest.files.modified) {
+            const originalPath = path.join(target, modified.path);
+            if (modified.originalContent !== undefined) {
+                try {
+                    // Restore from originalContent in manifest (most reliable)
+                    const originalDir = path.dirname(originalPath);
+                    if (!fs.existsSync(originalDir)) {
+                        fs.mkdirSync(originalDir, { recursive: true });
+                    }
+                    fs.writeFileSync(originalPath, modified.originalContent, "utf-8");
+                    console.log(chalk.green(`   ✓ Restored: ${modified.path}`));
+                    restoredCount++;
+                }
+                catch (error) {
+                    // Fallback to backup file if originalContent restore fails
+                    const backupPath = path.join(target, ".stackpatch", "backups", modified.path.replace(/\//g, "_").replace(/\\/g, "_"));
+                    if (fs.existsSync(backupPath)) {
+                        try {
+                            restoreFile(backupPath, originalPath);
+                            console.log(chalk.green(`   ✓ Restored (from backup): ${modified.path}`));
+                            restoredCount++;
+                        }
+                        catch (backupError) {
+                            console.log(chalk.yellow(`   ⚠ Could not restore: ${modified.path}`));
+                            failedRestorations.push(modified.path);
+                        }
+                    }
+                    else {
+                        console.log(chalk.yellow(`   ⚠ Could not restore: ${modified.path} (no backup found)`));
+                        failedRestorations.push(modified.path);
+                    }
+                }
+            }
+            else {
+                // Fallback: try to restore from backup file
+                const backupPath = path.join(target, ".stackpatch", "backups", modified.path.replace(/\//g, "_").replace(/\\/g, "_"));
+                if (fs.existsSync(backupPath)) {
+                    try {
+                        restoreFile(backupPath, originalPath);
+                        console.log(chalk.green(`   ✓ Restored (from backup): ${modified.path}`));
+                        restoredCount++;
+                    }
+                    catch (error) {
+                        console.log(chalk.yellow(`   ⚠ Could not restore: ${modified.path}`));
+                        failedRestorations.push(modified.path);
+                    }
+                }
+                else {
+                    console.log(chalk.yellow(`   ⚠ Backup not found and no originalContent: ${modified.path}`));
+                    failedRestorations.push(modified.path);
+                }
+            }
+            // Safety check: If file still contains StackPatch components after restore, manually remove them
+            if (fs.existsSync(originalPath) && modified.path.includes("layout.tsx")) {
+                try {
+                    let content = fs.readFileSync(originalPath, "utf-8");
+                    let needsUpdate = false;
+                    // Remove AuthSessionProvider import
+                    if (content.includes("AuthSessionProvider") && content.includes("session-provider")) {
+                        content = content.replace(/import\s*{\s*AuthSessionProvider\s*}\s*from\s*["'][^"']*session-provider[^"']*["'];\s*\n?/g, "");
+                        needsUpdate = true;
+                    }
+                    // Remove Toaster import
+                    if (content.includes("Toaster") && content.includes("toaster")) {
+                        content = content.replace(/import\s*{\s*Toaster\s*}\s*from\s*["'][^"']*toaster[^"']*["'];\s*\n?/g, "");
+                        needsUpdate = true;
+                    }
+                    // Remove AuthSessionProvider wrapper
+                    if (content.includes("<AuthSessionProvider>") && content.includes("</AuthSessionProvider>")) {
+                        content = content.replace(/<AuthSessionProvider>\s*/g, "");
+                        content = content.replace(/\s*<\/AuthSessionProvider>/g, "");
+                        needsUpdate = true;
+                    }
+                    // Remove Toaster component
+                    if (content.includes("<Toaster")) {
+                        content = content.replace(/<Toaster\s*\/?>\s*\n?\s*/g, "");
+                        needsUpdate = true;
+                    }
+                    if (needsUpdate) {
+                        fs.writeFileSync(originalPath, content, "utf-8");
+                        console.log(chalk.green(`   ✓ Cleaned up StackPatch components from: ${modified.path}`));
+                    }
+                }
+                catch (error) {
+                    // Ignore errors in cleanup
+                }
+            }
+        }
+        // Step 4: Remove dependencies from package.json
+        if (manifest.dependencies.length > 0) {
+            console.log(chalk.white("\n📦 Removing dependencies from package.json..."));
+            const removed = removeDependencies(target, manifest.dependencies);
+            if (removed) {
+                console.log(chalk.green(`   ✓ Removed dependencies: ${manifest.dependencies.join(", ")}`));
+                console.log(chalk.yellow("   ⚠ Run 'pnpm install' to update node_modules"));
+            }
+            else {
+                console.log(chalk.gray("   ⊘ Dependencies not found in package.json"));
+            }
+        }
+        // Step 5: Clean up empty directories (only if they only contained StackPatch files)
+        console.log(chalk.white("\n🧹 Cleaning up empty directories..."));
+        const sortedDirs = Array.from(directoriesToCheck).sort((a, b) => b.length - a.length); // Sort by depth (deepest first)
+        let removedDirCount = 0;
+        for (const dir of sortedDirs) {
+            if (fs.existsSync(dir)) {
+                try {
+                    const entries = fs.readdirSync(dir);
+                    if (entries.length === 0) {
+                        // Only remove if directory is empty
+                        // We know it was created by StackPatch because we're tracking it
+                        fs.rmdirSync(dir);
+                        removedDirCount++;
+                        console.log(chalk.green(`   ✓ Removed empty directory: ${path.relative(target, dir)}`));
+                    }
+                    // If directory has other files, we don't remove it (silently skip)
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+        }
+        if (removedDirCount === 0) {
+            console.log(chalk.gray("   ⊘ No empty directories to remove"));
+        }
+        // Step 6: Remove manifest and backups
+        console.log(chalk.white("\n🗑️  Removing StackPatch tracking files..."));
+        const stackpatchDir = path.join(target, ".stackpatch");
+        if (fs.existsSync(stackpatchDir)) {
+            try {
+                fs.rmSync(stackpatchDir, { recursive: true, force: true });
+                console.log(chalk.green("   ✓ Removed .stackpatch directory"));
+            }
+            catch (error) {
+                console.log(chalk.yellow("   ⚠ Could not remove .stackpatch directory"));
+            }
+        }
+        // Step 7: Verification
+        console.log(chalk.white("\n✅ Verification..."));
+        const remainingManifest = readManifest(target);
+        if (remainingManifest) {
+            console.log(chalk.red("   ❌ Warning: Manifest still exists. Revert may be incomplete."));
+        }
+        else {
+            console.log(chalk.green("   ✓ Manifest removed successfully"));
+        }
+        // Summary
+        console.log(chalk.blue.bold("\n📊 Revert Summary:"));
+        console.log(chalk.white(`   Files removed: ${chalk.green(removedCount)}`));
+        console.log(chalk.white(`   Files restored: ${chalk.green(restoredCount)}`));
+        if (failedRemovals.length > 0) {
+            console.log(chalk.yellow(`   Failed removals: ${failedRemovals.length}`));
+            failedRemovals.forEach(file => console.log(chalk.gray(`      - ${file}`)));
+        }
+        if (failedRestorations.length > 0) {
+            console.log(chalk.yellow(`   Failed restorations: ${failedRestorations.length}`));
+            failedRestorations.forEach(file => console.log(chalk.gray(`      - ${file}`)));
+        }
+        if (failedRemovals.length === 0 && failedRestorations.length === 0 && !remainingManifest) {
+            console.log(chalk.green("\n✅ Revert complete! Your project has been fully restored to its original state."));
+            if (manifest.dependencies.length > 0) {
+                console.log(chalk.yellow("\n⚠️  Remember to run 'pnpm install' to update your node_modules."));
+            }
+        }
+        else {
+            console.log(chalk.yellow("\n⚠️  Revert completed with some warnings. Please review the output above."));
+        }
+        return;
+    }
+    // Handle: bun create stackpatch@latest my-app
+    // When bun runs create, it passes project name as first arg (not "create")
+    // Check if first arg looks like a project name (not a known command)
+    // Always ask for project name first, even if provided
+    if (command && !["add", "create", "revert"].includes(command) && !PATCHES[command] && !command.startsWith("-")) {
+        // Likely called as: bun create stackpatch@latest my-app
+        // But we'll ask for project name anyway to be consistent
+        await showWelcome();
+        const { name } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "name",
+                message: chalk.white("Enter your project name or path (relative to current directory)"),
+                default: command || "my-stackpatch-app", // Use provided name as default
+                validate: (input) => {
+                    if (!input.trim()) {
+                        return "Project name cannot be empty";
+                    }
+                    return true;
+                },
+            },
+        ]);
+        await createProject(name.trim(), false, skipPrompts); // Welcome already shown
+        return;
+    }
+    // Handle: npx stackpatch create my-app
+    if (command === "create") {
+        if (!projectName) {
+            showWelcome();
+            const { name } = await inquirer.prompt([
+                {
+                    type: "input",
+                    name: "name",
+                    message: chalk.white("Enter your project name or path (relative to current directory)"),
+                    default: "my-stackpatch-app",
+                    validate: (input) => {
+                        if (!input.trim()) {
+                            return "Project name cannot be empty";
+                        }
+                        return true;
+                    },
+                },
+            ]);
+            await createProject(name.trim(), false); // Logo already shown
+            return;
+        }
+        await createProject(projectName, false, skipPrompts); // Logo already shown
+        return;
+    }
+    // Handle: npx stackpatch add auth-ui
+    const patchName = args[1];
+    if (command === "add" && patchName) {
+        if (!PATCHES[patchName]) {
+            console.log(chalk.red(`❌ Unknown patch: ${patchName}`));
+            console.log(chalk.yellow(`Available patches: ${Object.keys(PATCHES).join(", ")}`));
+            process.exit(1);
+        }
+        // Auto-detect target directory (current working directory or common locations)
+        let target = process.cwd();
+        // Check if we're in a Next.js app (has app/, src/app/, pages/, or src/pages/ directory)
+        const hasAppDir = fs.existsSync(path.join(target, "app")) || fs.existsSync(path.join(target, "src", "app"));
+        const hasPagesDir = fs.existsSync(path.join(target, "pages")) || fs.existsSync(path.join(target, "src", "pages"));
+        if (!hasAppDir && !hasPagesDir) {
+            // Try parent directory
+            const parent = path.resolve(target, "..");
+            if (fs.existsSync(path.join(parent, "app")) ||
+                fs.existsSync(path.join(parent, "src", "app")) ||
+                fs.existsSync(path.join(parent, "pages")) ||
+                fs.existsSync(path.join(parent, "src", "pages"))) {
+                target = parent;
+            }
+            else {
+                // Try common monorepo locations: apps/, packages/, or root
+                const possiblePaths = [
+                    path.join(target, "apps"),
+                    path.join(parent, "apps"),
+                    path.join(target, "packages"),
+                    path.join(parent, "packages"),
+                ];
+                let foundApp = false;
+                for (const possiblePath of possiblePaths) {
+                    if (fs.existsSync(possiblePath)) {
+                        // Look for Next.js apps in this directory
+                        const entries = fs.readdirSync(possiblePath, { withFileTypes: true });
+                        for (const entry of entries) {
+                            if (entry.isDirectory()) {
+                                const appPath = path.join(possiblePath, entry.name);
+                                if (fs.existsSync(path.join(appPath, "app")) ||
+                                    fs.existsSync(path.join(appPath, "src", "app")) ||
+                                    fs.existsSync(path.join(appPath, "pages")) ||
+                                    fs.existsSync(path.join(appPath, "src", "pages"))) {
+                                    target = appPath;
+                                    foundApp = true;
+                                    break;
+                                }
+                            }
+                        }
+                        if (foundApp)
+                            break;
+                    }
+                }
+                if (!foundApp) {
+                    console.log(chalk.yellow("⚠️  Could not auto-detect Next.js app directory."));
+                    const { target: userTarget } = await inquirer.prompt([
+                        {
+                            type: "input",
+                            name: "target",
+                            message: "Enter the path to your Next.js app folder:",
+                            default: target,
+                        },
+                    ]);
+                    target = path.resolve(userTarget);
+                }
+            }
+        }
+        const src = path.join(BOILERPLATE_ROOT, PATCHES[patchName].path);
+        console.log(chalk.blue.bold("\n🚀 StackPatch CLI\n"));
+        console.log(chalk.blue(`Copying ${patchName} patch to ${target}...\n`));
+        const copyResult = await copyFiles(src, target);
+        if (!copyResult.success)
+            process.exit(1);
+        const addedFiles = copyResult.addedFiles;
+        const modifiedFiles = [];
+        let selectedProviders = [];
+        // Install dependencies (only if missing)
+        installDependencies(target, PATCHES[patchName].dependencies);
+        // For auth patches, ask for OAuth providers and setup
+        if (patchName === "auth" || patchName === "auth-ui") {
+            showLogo();
+            console.log(chalk.blue.bold(`\n🔐 Setting up authentication\n`));
+            // Ask which OAuth providers to configure
+            selectedProviders = await askOAuthProviders();
+            const success = await setupAuth(target, selectedProviders);
+            if (success) {
+                await withSpinner("Updating layout with AuthSessionProvider", () => {
+                    const result = updateLayoutForAuth(target);
+                    if (result.modified && result.originalContent) {
+                        modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                    }
+                    return true;
+                });
+                await withSpinner("Adding Toaster component", () => {
+                    const result = updateLayoutForToaster(target);
+                    if (result.modified && result.originalContent) {
+                        modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                    }
+                    return true;
+                });
+                await withSpinner("Setting up protected routes", () => {
+                    copyProtectedRouteFiles(target);
+                    return true;
+                });
+                // OAuth instructions are shown in setupAuth function
+            }
+        }
+        // Create manifest for tracking
+        const manifest = {
+            version: MANIFEST_VERSION,
+            patchName,
+            target,
+            timestamp: new Date().toISOString(),
+            files: {
+                added: addedFiles,
+                modified: modifiedFiles,
+                backedUp: [],
+            },
+            dependencies: PATCHES[patchName].dependencies,
+            oauthProviders: selectedProviders,
+        };
+        writeManifest(target, manifest);
+        // Final next steps
+        console.log(chalk.blue("\n🎉 Patch setup complete!"));
+        console.log(chalk.green("\n📝 Next Steps:"));
+        console.log(chalk.white("   1. Configure OAuth providers (see instructions above)"));
+        console.log(chalk.white("   2. Set up database for email/password auth (see comments in code)"));
+        console.log(chalk.white("   3. Check out the auth navbar demo in ") + chalk.cyan("components/auth-navbar.tsx"));
+        console.log(chalk.white("   4. Protect your routes (see README.md)"));
+        console.log(chalk.white("   5. Run your Next.js dev server: ") + chalk.cyan("pnpm dev"));
+        console.log(chalk.white("   6. Test authentication at: ") + chalk.cyan("http://localhost:3000/auth/login\n"));
+        console.log(chalk.blue.bold("📚 Documentation:"));
+        console.log(chalk.white("   - See ") + chalk.cyan("README.md") + chalk.white(" for complete setup guide\n"));
+        console.log(chalk.yellow("⚠️  Important:"));
+        console.log(chalk.white("   - Email/password auth is in DEMO mode"));
+        console.log(chalk.white("   - Demo credentials: ") + chalk.gray("demo@example.com / demo123"));
+        console.log(chalk.white("   - See code comments in ") + chalk.cyan("app/api/auth/[...nextauth]/route.ts") + chalk.white(" to implement real auth\n"));
+        return;
+    }
+    // If no command, show help or interactive mode
+    if (!command) {
+        await showWelcome();
+        console.log(chalk.yellow("Usage:"));
+        console.log(chalk.white("  ") + chalk.cyan("npm create stackpatch@latest") + chalk.gray(" [project-name]"));
+        console.log(chalk.white("  ") + chalk.cyan("npx create-stackpatch@latest") + chalk.gray(" [project-name]"));
+        console.log(chalk.white("  ") + chalk.cyan("bunx create-stackpatch@latest") + chalk.gray(" [project-name]"));
+        console.log(chalk.white("  ") + chalk.cyan("npx stackpatch create") + chalk.gray(" [project-name]"));
+        console.log(chalk.white("  ") + chalk.cyan("npx stackpatch add") + chalk.white(" <patch-name>"));
+        console.log(chalk.white("  ") + chalk.cyan("npx stackpatch revert") + chalk.gray(" - Revert a patch installation"));
+        console.log(chalk.white("\nExamples:"));
+        console.log(chalk.gray("  npm create stackpatch@latest my-app"));
+        console.log(chalk.gray("  npx create-stackpatch@latest my-app"));
+        console.log(chalk.gray("  bunx create-stackpatch@latest my-app"));
+        console.log(chalk.gray("  npx stackpatch create my-app"));
+        console.log(chalk.gray("  npx stackpatch add auth-ui"));
+        console.log(chalk.gray("\n"));
+        process.exit(0);
+    }
+    // Interactive mode (fallback)
+    console.log(chalk.blue.bold("\n🚀 Welcome to StackPatch CLI\n"));
+    let selectedPatch = null;
+    let goBack = false;
+    // 1️⃣ Select patch with back option
+    do {
+        const response = await inquirer.prompt([
+            {
+                type: "list",
+                name: "patch",
+                message: "Which patch do you want to add?",
+                choices: [
+                    ...Object.keys(PATCHES)
+                        .filter(p => p !== "auth-ui") // Don't show duplicate
+                        .map(p => ({ name: p, value: p })),
+                    new inquirer.Separator(),
+                    {
+                        name: chalk.gray("← Go back / Cancel"),
+                        value: "back",
+                    },
+                ],
+            },
+        ]);
+        if (response.patch === "back") {
+            goBack = true;
+            break;
+        }
+        selectedPatch = response.patch;
+    } while (!selectedPatch);
+    if (goBack || !selectedPatch) {
+        console.log(chalk.yellow("\n← Cancelled"));
+        return;
+    }
+    const patch = selectedPatch;
+    // 2️⃣ Enter target Next.js app folder
+    const { target } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "target",
+            message: "Enter the relative path to your Next.js app folder (e.g., ../../apps/stackpatch-frontend):",
+            default: process.cwd(),
+        },
+    ]);
+    const src = path.join(BOILERPLATE_ROOT, PATCHES[patch].path);
+    const dest = path.resolve(target);
+    console.log(chalk.blue(`\nCopying ${patch} boilerplate to ${dest}...\n`));
+    const copyResult = await copyFiles(src, dest);
+    if (!copyResult.success)
+        return;
+    const addedFiles = copyResult.addedFiles;
+    const modifiedFiles = [];
+    // 3️⃣ Install dependencies (only if missing)
+    installDependencies(dest, PATCHES[patch].dependencies);
+    // 4️⃣ For auth patches, ask for OAuth providers and setup
+    if (patch === "auth" || patch === "auth-ui") {
+        console.log(chalk.blue.bold(`\n🔐 Setting up authentication\n`));
+        // Ask which OAuth providers to configure
+        const selectedProviders = await askOAuthProviders();
+        const success = await setupAuth(dest, selectedProviders);
+        if (success) {
+            await withSpinner("Updating layout with AuthSessionProvider", () => {
+                const result = updateLayoutForAuth(dest);
+                if (result.modified && result.originalContent) {
+                    modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                }
+                return true;
+            });
+            await withSpinner("Adding Toaster component", () => {
+                const result = updateLayoutForToaster(dest);
+                if (result.modified && result.originalContent) {
+                    modifiedFiles.push({ path: result.filePath, originalContent: result.originalContent });
+                }
+                return true;
+            });
+        }
+        // Create manifest
+        const manifest = {
+            version: MANIFEST_VERSION,
+            patchName: patch,
+            target: dest,
+            timestamp: new Date().toISOString(),
+            files: {
+                added: addedFiles,
+                modified: modifiedFiles,
+                backedUp: [],
+            },
+            dependencies: PATCHES[patch].dependencies,
+            oauthProviders: selectedProviders,
+        };
+        writeManifest(dest, manifest);
+    }
+    // 5️⃣ Final next steps
+    console.log(chalk.blue("\n🎉 Patch setup complete!"));
+    console.log(chalk.green("- Run your Next.js dev server: pnpm dev"));
+    console.log(chalk.green("- Start building your features!\n"));
+}
+main().catch((error) => {
+    console.error(chalk.red("❌ Error:"), error);
+    process.exit(1);
+});