create-prisma-php-app 4.0.0-alpha.30 → 4.0.0-alpha.32

package/dist/index.js

@@ -1,5 +1,857 @@
 #!/usr/bin/env node
-import{execSync,spawnSync}from"child_process";import fs from"fs";import{fileURLToPath}from"url";import path from"path";import chalk from"chalk";import prompts from"prompts";import https from"https";import{randomBytes}from"crypto";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename);let updateAnswer=null;const nonBackendFiles=["favicon.ico","\\src\\app\\index.php","metadata.php","not-found.php","error.php"],dockerFiles=[".dockerignore","docker-compose.yml","Dockerfile","apache.conf"];function bsConfigUrls(e){const s=e.indexOf("\\htdocs\\");if(-1===s)return{bsTarget:"",bsPathRewrite:{}};const t=e.substring(0,s+"\\htdocs\\".length).replace(/\\/g,"\\\\"),n=e.replace(new RegExp(`^${t}`),"").replace(/\\/g,"/");let c=`http://localhost/${n}`;c=c.endsWith("/")?c.slice(0,-1):c;const o=c.replace(/(?<!:)(\/\/+)/g,"/"),i=n.replace(/\/\/+/g,"/");return{bsTarget:`${o}/`,bsPathRewrite:{"^/":`/${i.startsWith("/")?i.substring(1):i}/`}}}async function updatePackageJson(e,s){const t=path.join(e,"package.json");if(checkExcludeFiles(t))return;const n=JSON.parse(fs.readFileSync(t,"utf8"));n.scripts={...n.scripts,projectName:"tsx settings/project-name.ts"};let c=[];if(s.tailwindcss&&(n.scripts={...n.scripts,tailwind:"postcss src/app/css/tailwind.css -o src/app/css/styles.css --watch","tailwind:build":"postcss src/app/css/tailwind.css -o src/app/css/styles.css"},c.push("tailwind")),s.websocket&&(n.scripts={...n.scripts,websocket:"tsx settings/restart-websocket.ts"},c.push("websocket")),s.mcp&&(n.scripts={...n.scripts,mcp:"tsx settings/restart-mcp.ts"},c.push("mcp")),s.docker&&(n.scripts={...n.scripts,docker:"docker-compose up"},c.push("docker")),s.swaggerDocs){const e=s.prisma?"tsx settings/auto-swagger-docs.ts":"tsx settings/swagger-config.ts";n.scripts={...n.scripts,"create-swagger-docs":e}}let o={...n.scripts};o.browserSync="tsx settings/bs-config.ts",o["browserSync:build"]="tsx settings/build.ts",o.dev=`npm-run-all projectName -p browserSync ${c.join(" ")}`,o.build=`npm-run-all${s.tailwindcss?" tailwind:build":""} browserSync:build`,n.scripts=o,n.type="module",fs.writeFileSync(t,JSON.stringify(n,null,2))}async function updateComposerJson(e){checkExcludeFiles(path.join(e,"composer.json"))}async function updateIndexJsForWebSocket(e,s){if(!s.websocket)return;const t=path.join(e,"src","app","js","index.js");if(checkExcludeFiles(t))return;let n=fs.readFileSync(t,"utf8");n+='\n// WebSocket initialization\nvar ws = new WebSocket("ws://localhost:8080");\n',fs.writeFileSync(t,n,"utf8")}function generateAuthSecret(){return randomBytes(33).toString("base64")}function generateHexEncodedKey(e=16){return randomBytes(e).toString("hex")}function copyRecursiveSync(e,s,t){const n=fs.existsSync(e),c=n&&fs.statSync(e);if(n&&c&&c.isDirectory()){const n=s.toLowerCase();if(!t.websocket&&n.includes("src\\lib\\websocket"))return;if(!t.mcp&&n.includes("src\\lib\\mcp"))return;if(t.backendOnly&&n.includes("src\\app\\js")||t.backendOnly&&n.includes("src\\app\\css")||t.backendOnly&&n.includes("src\\app\\assets"))return;if(!t.swaggerDocs&&n.includes("src\\app\\swagger-docs"))return;const c=s.replace(/\\/g,"/");if(updateAnswer?.excludeFilePath?.includes(c))return;fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),fs.readdirSync(e).forEach((n=>{copyRecursiveSync(path.join(e,n),path.join(s,n),t)}))}else{if(checkExcludeFiles(s))return;if(!t.tailwindcss&&(s.includes("tailwind.css")||s.includes("styles.css")))return;if(!t.websocket&&s.includes("restart-websocket.ts"))return;if(!t.mcp&&s.includes("restart-mcp.ts"))return;if(!t.docker&&dockerFiles.some((e=>s.includes(e))))return;if(t.backendOnly&&nonBackendFiles.some((e=>s.includes(e))))return;if(!t.backendOnly&&s.includes("route.php"))return;if(t.backendOnly&&!t.swaggerDocs&&s.includes("layout.php"))return;if(!t.swaggerDocs&&s.includes("swagger-config.ts"))return;if(t.tailwindcss&&s.includes("index.css"))return;if((!t.swaggerDocs||!t.prisma)&&(s.includes("auto-swagger-docs.ts")||s.includes("prisma-schema-config.json")))return;fs.copyFileSync(e,s,0)}}async function executeCopy(e,s,t){s.forEach((({src:s,dest:n})=>{copyRecursiveSync(path.join(__dirname,s),path.join(e,n),t)}))}function modifyPostcssConfig(e){const s=path.join(e,"postcss.config.js");if(checkExcludeFiles(s))return;fs.writeFileSync(s,'export default {\n  plugins: {\n    "@tailwindcss/postcss": {},\n    cssnano: {},\n  },\n};',{flag:"w"})}function modifyLayoutPHP(e,s){const t=path.join(e,"src","app","layout.php");if(!checkExcludeFiles(t))try{let e=fs.readFileSync(t,"utf8"),n="";s.backendOnly||(s.tailwindcss||(n='\n    <link href="<?= Request::baseUrl; ?>/css/index.css" rel="stylesheet" />'),n+='\n    <script src="<?= Request::baseUrl; ?>/js/morphdom-umd.min.js"><\/script>\n    <script src="<?= Request::baseUrl; ?>/js/json5.min.js"><\/script>\n    <script src="<?= Request::baseUrl; ?>/js/index.js"><\/script>');let c="";s.backendOnly||(c=s.tailwindcss?`    <link href="<?= Request::baseUrl; ?>/css/styles.css" rel="stylesheet" /> ${n}`:n),e=e.replace("</head>",`${c}\n</head>`),fs.writeFileSync(t,e,{flag:"w"})}catch(e){}}async function createOrUpdateEnvFile(e,s){const t=path.join(e,".env");checkExcludeFiles(t)||fs.writeFileSync(t,s,{flag:"w"})}function checkExcludeFiles(e){return!!updateAnswer?.isUpdate&&(updateAnswer?.excludeFilePath?.includes(e.replace(/\\/g,"/"))??!1)}async function createDirectoryStructure(e,s){const t=[{src:"/bootstrap.php",dest:"/bootstrap.php"},{src:"/.htaccess",dest:"/.htaccess"},{src:"/tsconfig.json",dest:"/tsconfig.json"},{src:"/app-gitignore",dest:"/.gitignore"}];s.tailwindcss&&t.push({src:"/postcss.config.js",dest:"/postcss.config.js"});const n=[{src:"/settings",dest:"/settings"},{src:"/src",dest:"/src"}];s.docker&&n.push({src:"/.dockerignore",dest:"/.dockerignore"},{src:"/docker-compose.yml",dest:"/docker-compose.yml"},{src:"/Dockerfile",dest:"/Dockerfile"},{src:"/apache.conf",dest:"/apache.conf"}),t.forEach((({src:s,dest:t})=>{const n=path.join(__dirname,s),c=path.join(e,t);if(checkExcludeFiles(c))return;const o=fs.readFileSync(n,"utf8");fs.writeFileSync(c,o,{flag:"w"})})),await executeCopy(e,n,s),await updatePackageJson(e,s),await updateComposerJson(e),s.backendOnly||await updateIndexJsForWebSocket(e,s),s.tailwindcss&&modifyPostcssConfig(e),(s.tailwindcss||!s.backendOnly||s.swaggerDocs)&&modifyLayoutPHP(e,s);const c=generateAuthSecret(),o=generateHexEncodedKey(),i=`# Authentication secret key for JWT or session encryption.\nAUTH_SECRET="${c}"\n# Name of the authentication cookie.\nAUTH_COOKIE_NAME="${generateHexEncodedKey(8)}"\n\n# PHPMailer SMTP configuration (uncomment and set as needed)\n# SMTP_HOST="smtp.gmail.com"           # Your SMTP host\n# SMTP_USERNAME="john.doe@gmail.com"   # Your SMTP username\n# SMTP_PASSWORD="123456"               # Your SMTP password\n# SMTP_PORT="587"                      # 587 for TLS, 465 for SSL, or your SMTP port\n# SMTP_ENCRYPTION="ssl"                # ssl or tls\n# MAIL_FROM="john.doe@gmail.com"       # Sender email address\n# MAIL_FROM_NAME="John Doe"            # Sender name\n\n# Show errors in the browser (development only). Set to false in production.\nSHOW_ERRORS="true"\n\n# Application timezone (default: UTC)\nAPP_TIMEZONE="UTC"\n\n# Application environment (development or production)\nAPP_ENV="development"\n\n# Enable or disable application cache (default: false)\nCACHE_ENABLED="false"\n# Cache time-to-live in seconds (default: 600)\nCACHE_TTL="600"\n\n# Local storage key for browser storage (auto-generated if not set).\n# Spaces will be replaced with underscores and converted to lowercase.\nLOCALSTORE_KEY="${o}"\n\n# Secret key for encrypting function calls.\nFUNCTION_CALL_SECRET="${generateHexEncodedKey(32)}"\n\n# Single or multiple origins (CSV or JSON array)\nCORS_ALLOWED_ORIGINS=[]\n\n# If you need cookies/Authorization across origins, keep this true\nCORS_ALLOW_CREDENTIALS="true"\n\n# Optional tuning\nCORS_ALLOWED_METHODS="GET,POST,PUT,PATCH,DELETE,OPTIONS"\nCORS_ALLOWED_HEADERS="Content-Type,Authorization,X-Requested-With"\nCORS_EXPOSE_HEADERS=""\nCORS_MAX_AGE="86400"`;if(s.prisma){const s=`${'# Environment variables declared in this file are automatically made available to Prisma.\n# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema\n\n# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.\n# See the documentation for all the connection string options: https://pris.ly/d/connection-strings\n\nDATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"'}\n\n${i}`;await createOrUpdateEnvFile(e,s)}else await createOrUpdateEnvFile(e,i)}async function getAnswer(e={}){const s=[];e.projectName||s.push({type:"text",name:"projectName",message:"What is your project named?",initial:"my-app"}),e.backendOnly||updateAnswer?.isUpdate||s.push({type:"toggle",name:"backendOnly",message:`Would you like to create a ${chalk.blue("backend-only project")}?`,initial:!1,active:"Yes",inactive:"No"});const t=()=>{process.exit(0)},n=await prompts(s,{onCancel:t}),c=[];n.backendOnly??e.backendOnly??!1?(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!1,active:"Yes",inactive:"No"}),e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!1,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"})):(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.tailwindcss||c.push({type:"toggle",name:"tailwindcss",message:`Would you like to use ${chalk.blue("Tailwind CSS")}?`,initial:!1,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!1,active:"Yes",inactive:"No"}),e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!1,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"}));const o=await prompts(c,{onCancel:t});return{projectName:n.projectName?String(n.projectName).trim().replace(/ /g,"-"):e.projectName??"my-app",backendOnly:n.backendOnly??e.backendOnly??!1,swaggerDocs:o.swaggerDocs??e.swaggerDocs??!1,tailwindcss:o.tailwindcss??e.tailwindcss??!1,websocket:o.websocket??e.websocket??!1,mcp:o.mcp??e.mcp??!1,prisma:o.prisma??e.prisma??!1,docker:o.docker??e.docker??!1}}async function uninstallNpmDependencies(e,s,t=!1){s.forEach((e=>{}));const n=`npm uninstall ${t?"--save-dev":"--save"} ${s.join(" ")}`;execSync(n,{stdio:"inherit",cwd:e})}async function uninstallComposerDependencies(e,s){s.forEach((e=>{}));const t=`C:\\xampp\\php\\php.exe C:\\ProgramData\\ComposerSetup\\bin\\composer.phar remove ${s.join(" ")}`;execSync(t,{stdio:"inherit",cwd:e})}function fetchPackageVersion(e){return new Promise(((s,t)=>{https.get(`https://registry.npmjs.org/${e}`,(e=>{let n="";e.on("data",(e=>n+=e)),e.on("end",(()=>{try{const e=JSON.parse(n);s(e["dist-tags"].latest)}catch(e){t(new Error("Failed to parse JSON response"))}}))})).on("error",(e=>t(e)))}))}const readJsonFile=e=>{const s=fs.readFileSync(e,"utf8");return JSON.parse(s)};function compareVersions(e,s){const t=e.split(".").map(Number),n=s.split(".").map(Number);for(let e=0;e<t.length;e++){if(t[e]>n[e])return 1;if(t[e]<n[e])return-1}return 0}function getInstalledPackageVersion(e){try{const s=execSync(`npm list -g ${e} --depth=0`).toString().match(new RegExp(`${e}@(\\d+\\.\\d+\\.\\d+)`));return s?s[1]:null}catch(e){return null}}
+import { execSync, spawnSync } from "child_process";
+import fs from "fs";
+import { fileURLToPath } from "url";
+import path from "path";
+import chalk from "chalk";
+import prompts from "prompts";
+import https from "https";
+import { randomBytes } from "crypto";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+let updateAnswer = null;
+const nonBackendFiles = [
+  "favicon.ico",
+  "\\src\\app\\index.php",
+  "metadata.php",
+  "not-found.php",
+  "error.php",
+];
+const dockerFiles = [
+  ".dockerignore",
+  "docker-compose.yml",
+  "Dockerfile",
+  "apache.conf",
+];
+const STARTER_KITS = {
+  basic: {
+    id: "basic",
+    name: "Basic PHP Application",
+    description: "Simple PHP backend with minimal dependencies",
+    features: {
+      backendOnly: true,
+      tailwindcss: false,
+      websocket: false,
+      prisma: false,
+      docker: false,
+      swaggerDocs: false,
+      mcp: false,
+    },
+    requiredFiles: [
+      "bootstrap.php",
+      ".htaccess",
+      "src/app/layout.php",
+      "src/app/index.php",
+    ],
+  },
+  fullstack: {
+    id: "fullstack",
+    name: "Full-Stack Application",
+    description: "Complete web application with frontend and backend",
+    features: {
+      backendOnly: false,
+      tailwindcss: true,
+      websocket: false,
+      prisma: true,
+      docker: false,
+      swaggerDocs: true,
+      mcp: false,
+    },
+    requiredFiles: [
+      "bootstrap.php",
+      ".htaccess",
+      "postcss.config.js",
+      "src/app/layout.php",
+      "src/app/index.php",
+      "src/app/js/index.js",
+      "src/app/css/tailwind.css",
+    ],
+  },
+  api: {
+    id: "api",
+    name: "REST API",
+    description: "Backend API with database and documentation",
+    features: {
+      backendOnly: true,
+      tailwindcss: false,
+      websocket: false,
+      prisma: true,
+      docker: true,
+      swaggerDocs: true,
+      mcp: false,
+    },
+    requiredFiles: [
+      "bootstrap.php",
+      ".htaccess",
+      "docker-compose.yml",
+      "Dockerfile",
+    ],
+  },
+  realtime: {
+    id: "realtime",
+    name: "Real-time Application",
+    description: "Application with WebSocket support and MCP",
+    features: {
+      backendOnly: false,
+      tailwindcss: true,
+      websocket: true,
+      prisma: true,
+      docker: false,
+      swaggerDocs: true,
+      mcp: true,
+    },
+    requiredFiles: [
+      "bootstrap.php",
+      ".htaccess",
+      "postcss.config.js",
+      "src/lib/websocket",
+      "src/lib/mcp",
+    ],
+  },
+  // Custom starter kit examples
+  ecommerce: {
+    id: "ecommerce",
+    name: "E-commerce Starter",
+    description: "Full e-commerce application with cart, payments, and admin",
+    features: {
+      backendOnly: false,
+      tailwindcss: true,
+      websocket: false,
+      prisma: true,
+      docker: true,
+      swaggerDocs: true,
+      mcp: false,
+    },
+    requiredFiles: [],
+    source: {
+      type: "git",
+      url: "https://github.com/your-org/prisma-php-ecommerce-starter",
+      branch: "main",
+    },
+  },
+  blog: {
+    id: "blog",
+    name: "Blog CMS",
+    description: "Blog content management system",
+    features: {
+      backendOnly: false,
+      tailwindcss: true,
+      websocket: false,
+      prisma: true,
+      docker: false,
+      swaggerDocs: false,
+      mcp: false,
+    },
+    requiredFiles: [],
+    source: {
+      type: "git",
+      url: "https://github.com/your-org/prisma-php-blog-starter",
+    },
+  },
+};
+function bsConfigUrls(projectRootPath) {
+  // Identify the base path dynamically up to and including 'htdocs'
+  const htdocsIndex = projectRootPath.indexOf("\\htdocs\\");
+  if (htdocsIndex === -1) {
+    console.error(
+      "Invalid PROJECT_ROOT_PATH. The path does not contain \\htdocs\\"
+    );
+    return {
+      bsTarget: "",
+      bsPathRewrite: {},
+    };
+  }
+  // Extract the path up to and including 'htdocs\\'
+  const basePathToRemove = projectRootPath.substring(
+    0,
+    htdocsIndex + "\\htdocs\\".length
+  );
+  // Escape backslashes for the regex pattern
+  const escapedBasePathToRemove = basePathToRemove.replace(/\\/g, "\\\\");
+  // Remove the base path and replace backslashes with forward slashes for URL compatibility
+  const relativeWebPath = projectRootPath
+    .replace(new RegExp(`^${escapedBasePathToRemove}`), "")
+    .replace(/\\/g, "/");
+  // Construct the Browser Sync command with the correct proxy URL, being careful not to affect the protocol part
+  let proxyUrl = `http://localhost/${relativeWebPath}`;
+  // Ensure the proxy URL does not end with a slash before appending '/public'
+  proxyUrl = proxyUrl.endsWith("/") ? proxyUrl.slice(0, -1) : proxyUrl;
+  // Clean the URL by replacing "//" with "/" but not affecting "http://"
+  // We replace instances of "//" that are not preceded by ":"
+  const cleanUrl = proxyUrl.replace(/(?<!:)(\/\/+)/g, "/");
+  const cleanRelativeWebPath = relativeWebPath.replace(/\/\/+/g, "/");
+  // Correct the relativeWebPath to ensure it does not start with a "/"
+  const adjustedRelativeWebPath = cleanRelativeWebPath.startsWith("/")
+    ? cleanRelativeWebPath.substring(1)
+    : cleanRelativeWebPath;
+  return {
+    bsTarget: `${cleanUrl}/`,
+    bsPathRewrite: {
+      "^/": `/${adjustedRelativeWebPath}/`,
+    },
+  };
+}
+async function updatePackageJson(baseDir, answer) {
+  const packageJsonPath = path.join(baseDir, "package.json");
+  if (checkExcludeFiles(packageJsonPath)) return;
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+  packageJson.scripts = {
+    ...packageJson.scripts,
+    projectName: "tsx settings/project-name.ts",
+  };
+  let answersToInclude = [];
+  if (answer.tailwindcss) {
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      tailwind:
+        "postcss src/app/css/tailwind.css -o src/app/css/styles.css --watch",
+      "tailwind:build":
+        "postcss src/app/css/tailwind.css -o src/app/css/styles.css",
+    };
+    answersToInclude.push("tailwind");
+  }
+  if (answer.websocket) {
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      websocket: "tsx settings/restart-websocket.ts",
+    };
+    answersToInclude.push("websocket");
+  }
+  if (answer.mcp) {
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      mcp: "tsx settings/restart-mcp.ts",
+    };
+    answersToInclude.push("mcp");
+  }
+  if (answer.docker) {
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      docker: "docker-compose up",
+    };
+    answersToInclude.push("docker");
+  }
+  if (answer.swaggerDocs) {
+    const swaggerDocsExecuteScript = answer.prisma
+      ? "tsx settings/auto-swagger-docs.ts"
+      : "tsx settings/swagger-config.ts";
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      "create-swagger-docs": swaggerDocsExecuteScript,
+    };
+  }
+  // Initialize with existing scripts
+  let updatedScripts = {
+    ...packageJson.scripts,
+  };
+  updatedScripts.browserSync = "tsx settings/bs-config.ts";
+  updatedScripts["browserSync:build"] = "tsx settings/build.ts";
+  updatedScripts.dev = `npm-run-all projectName -p browserSync ${answersToInclude.join(
+    " "
+  )}`;
+  updatedScripts.build = `npm-run-all${
+    answer.tailwindcss ? " tailwind:build" : ""
+  } browserSync:build`;
+  // Finally, assign the updated scripts back to packageJson
+  packageJson.scripts = updatedScripts;
+  packageJson.type = "module";
+  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+}
+async function updateComposerJson(baseDir) {
+  const composerJsonPath = path.join(baseDir, "composer.json");
+  if (checkExcludeFiles(composerJsonPath)) return;
+}
+async function updateIndexJsForWebSocket(baseDir, answer) {
+  if (!answer.websocket) {
+    return;
+  }
+  const indexPath = path.join(baseDir, "src", "app", "js", "index.js");
+  if (checkExcludeFiles(indexPath)) return;
+  let indexContent = fs.readFileSync(indexPath, "utf8");
+  // WebSocket initialization code to be appended
+  const webSocketCode = `
+// WebSocket initialization
+var ws = new WebSocket("ws://localhost:8080");
+`;
+  // Append WebSocket code if user chose to use WebSocket
+  indexContent += webSocketCode;
+  fs.writeFileSync(indexPath, indexContent, "utf8");
+  console.log("WebSocket code added to index.js successfully.");
+}
+function generateAuthSecret() {
+  // Generate 33 random bytes and encode them as a base64 string
+  return randomBytes(33).toString("base64");
+}
+function generateHexEncodedKey(size = 16) {
+  return randomBytes(size).toString("hex"); // Hex encoding ensures safe session keys
+}
+// Recursive copy function
+function copyRecursiveSync(src, dest, answer) {
+  const exists = fs.existsSync(src);
+  const stats = exists && fs.statSync(src);
+  const isDirectory = exists && stats && stats.isDirectory();
+  if (isDirectory) {
+    const destLower = dest.toLowerCase();
+    if (!answer.websocket && destLower.includes("src\\lib\\websocket")) return;
+    if (!answer.mcp && destLower.includes("src\\lib\\mcp")) return;
+    if (
+      (answer.backendOnly && destLower.includes("src\\app\\js")) ||
+      (answer.backendOnly && destLower.includes("src\\app\\css")) ||
+      (answer.backendOnly && destLower.includes("src\\app\\assets"))
+    )
+      return;
+    if (!answer.swaggerDocs && destLower.includes("src\\app\\swagger-docs"))
+      return;
+    const destModified = dest.replace(/\\/g, "/");
+    if (updateAnswer?.excludeFilePath?.includes(destModified)) return;
+    if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+    fs.readdirSync(src).forEach((childItemName) => {
+      copyRecursiveSync(
+        path.join(src, childItemName),
+        path.join(dest, childItemName),
+        answer
+      );
+    });
+  } else {
+    if (checkExcludeFiles(dest)) return;
+    if (
+      !answer.tailwindcss &&
+      (dest.includes("tailwind.css") || dest.includes("styles.css"))
+    )
+      return;
+    if (!answer.websocket && dest.includes("restart-websocket.ts")) return;
+    if (!answer.mcp && dest.includes("restart-mcp.ts")) return;
+    if (!answer.docker && dockerFiles.some((file) => dest.includes(file)))
+      return;
+    if (
+      answer.backendOnly &&
+      nonBackendFiles.some((file) => dest.includes(file))
+    )
+      return;
+    if (!answer.backendOnly && dest.includes("route.php")) return;
+    if (
+      answer.backendOnly &&
+      !answer.swaggerDocs &&
+      dest.includes("layout.php")
+    )
+      return;
+    if (!answer.swaggerDocs && dest.includes("swagger-config.ts")) return;
+    if (answer.tailwindcss && dest.includes("index.css")) return;
+    if (
+      (!answer.swaggerDocs || !answer.prisma) &&
+      (dest.includes("auto-swagger-docs.ts") ||
+        dest.includes("prisma-schema-config.json"))
+    )
+      return;
+    fs.copyFileSync(src, dest, 0);
+  }
+}
+// Function to execute the recursive copy for entire directories
+async function executeCopy(baseDir, directoriesToCopy, answer) {
+  directoriesToCopy.forEach(({ src: srcDir, dest: destDir }) => {
+    const sourcePath = path.join(__dirname, srcDir);
+    const destPath = path.join(baseDir, destDir);
+    copyRecursiveSync(sourcePath, destPath, answer);
+  });
+}
+function modifyPostcssConfig(baseDir) {
+  const filePath = path.join(baseDir, "postcss.config.js");
+  if (checkExcludeFiles(filePath)) return;
+  const newContent = `export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+    cssnano: {},
+  },
+};`;
+  fs.writeFileSync(filePath, newContent, { flag: "w" });
+  console.log(chalk.green("postcss.config.js updated successfully."));
+}
+function modifyLayoutPHP(baseDir, answer) {
+  const layoutPath = path.join(baseDir, "src", "app", "layout.php");
+  if (checkExcludeFiles(layoutPath)) return;
+  try {
+    let indexContent = fs.readFileSync(layoutPath, "utf8");
+    let stylesAndLinks = "";
+    if (!answer.backendOnly) {
+      if (!answer.tailwindcss) {
+        stylesAndLinks = `\n    <link href="<?= Request::baseUrl; ?>/css/index.css" rel="stylesheet" />`;
+      }
+      stylesAndLinks += `\n    <script src="<?= Request::baseUrl; ?>/js/morphdom-umd.min.js"></script>\n    <script src="<?= Request::baseUrl; ?>/js/json5.min.js"></script>\n    <script src="<?= Request::baseUrl; ?>/js/index.js"></script>`;
+    }
+    // Tailwind CSS link or CDN script
+    let tailwindLink = "";
+    if (!answer.backendOnly) {
+      tailwindLink = answer.tailwindcss
+        ? `    <link href="<?= Request::baseUrl; ?>/css/styles.css" rel="stylesheet" /> ${stylesAndLinks}`
+        : stylesAndLinks;
+    }
+    // Insert before the closing </head> tag
+    indexContent = indexContent.replace(
+      "</head>",
+      `${tailwindLink}
+</head>`
+    );
+    fs.writeFileSync(layoutPath, indexContent, { flag: "w" });
+    console.log(
+      chalk.green(
+        `layout.php modified successfully for ${
+          answer.tailwindcss ? "local Tailwind CSS" : "Tailwind CSS CDN"
+        }.`
+      )
+    );
+  } catch (error) {
+    console.error(chalk.red("Error modifying layout.php:"), error);
+  }
+}
+// This function updates or creates the .env file
+async function createOrUpdateEnvFile(baseDir, content) {
+  const envPath = path.join(baseDir, ".env");
+  if (checkExcludeFiles(envPath)) return;
+  console.log("🚀 ~ content:", content);
+  fs.writeFileSync(envPath, content, { flag: "w" });
+}
+function checkExcludeFiles(destPath) {
+  if (!updateAnswer?.isUpdate) return false;
+  return (
+    updateAnswer?.excludeFilePath?.includes(destPath.replace(/\\/g, "/")) ??
+    false
+  );
+}
+async function createDirectoryStructure(baseDir, answer) {
+  console.log("🚀 ~ baseDir:", baseDir);
+  console.log("🚀 ~ answer:", answer);
+  const filesToCopy = [
+    { src: "/bootstrap.php", dest: "/bootstrap.php" },
+    { src: "/.htaccess", dest: "/.htaccess" },
+    { src: "/tsconfig.json", dest: "/tsconfig.json" },
+    { src: "/app-gitignore", dest: "/.gitignore" },
+  ];
+  if (answer.tailwindcss) {
+    filesToCopy.push({ src: "/postcss.config.js", dest: "/postcss.config.js" });
+  }
+  const directoriesToCopy = [
+    {
+      src: "/settings",
+      dest: "/settings",
+    },
+    {
+      src: "/src",
+      dest: "/src",
+    },
+  ];
+  if (answer.docker) {
+    directoriesToCopy.push(
+      { src: "/.dockerignore", dest: "/.dockerignore" },
+      { src: "/docker-compose.yml", dest: "/docker-compose.yml" },
+      { src: "/Dockerfile", dest: "/Dockerfile" },
+      { src: "/apache.conf", dest: "/apache.conf" }
+    );
+  }
+  console.log("🚀 ~ directoriesToCopy:", directoriesToCopy);
+  filesToCopy.forEach(({ src, dest }) => {
+    const sourcePath = path.join(__dirname, src);
+    const destPath = path.join(baseDir, dest);
+    if (checkExcludeFiles(destPath)) return;
+    const code = fs.readFileSync(sourcePath, "utf8");
+    fs.writeFileSync(destPath, code, { flag: "w" });
+  });
+  await executeCopy(baseDir, directoriesToCopy, answer);
+  await updatePackageJson(baseDir, answer);
+  await updateComposerJson(baseDir);
+  if (!answer.backendOnly) {
+    await updateIndexJsForWebSocket(baseDir, answer);
+  }
+  if (answer.tailwindcss) {
+    modifyPostcssConfig(baseDir);
+  }
+  if (answer.tailwindcss || !answer.backendOnly || answer.swaggerDocs) {
+    modifyLayoutPHP(baseDir, answer);
+  }
+  const authSecret = generateAuthSecret();
+  const localStoreKey = generateHexEncodedKey();
+  const authCookieName = generateHexEncodedKey(8);
+  const functionCallSecret = generateHexEncodedKey(32);
+  const prismaPHPEnvContent = `# Authentication secret key for JWT or session encryption.
+AUTH_SECRET="${authSecret}"
+# Name of the authentication cookie.
+AUTH_COOKIE_NAME="${authCookieName}"
+
+# PHPMailer SMTP configuration (uncomment and set as needed)
+# SMTP_HOST="smtp.gmail.com"           # Your SMTP host
+# SMTP_USERNAME="john.doe@gmail.com"   # Your SMTP username
+# SMTP_PASSWORD="123456"               # Your SMTP password
+# SMTP_PORT="587"                      # 587 for TLS, 465 for SSL, or your SMTP port
+# SMTP_ENCRYPTION="ssl"                # ssl or tls
+# MAIL_FROM="john.doe@gmail.com"       # Sender email address
+# MAIL_FROM_NAME="John Doe"            # Sender name
+
+# Show errors in the browser (development only). Set to false in production.
+SHOW_ERRORS="true"
+
+# Application timezone (default: UTC)
+APP_TIMEZONE="UTC"
+
+# Application environment (development or production)
+APP_ENV="development"
+
+# Enable or disable application cache (default: false)
+CACHE_ENABLED="false"
+# Cache time-to-live in seconds (default: 600)
+CACHE_TTL="600"
+
+# Local storage key for browser storage (auto-generated if not set).
+# Spaces will be replaced with underscores and converted to lowercase.
+LOCALSTORE_KEY="${localStoreKey}"
+
+# Secret key for encrypting function calls.
+FUNCTION_CALL_SECRET="${functionCallSecret}"
+
+# Single or multiple origins (CSV or JSON array)
+CORS_ALLOWED_ORIGINS=[]
+
+# If you need cookies/Authorization across origins, keep this true
+CORS_ALLOW_CREDENTIALS="true"
+
+# Optional tuning
+CORS_ALLOWED_METHODS="GET,POST,PUT,PATCH,DELETE,OPTIONS"
+CORS_ALLOWED_HEADERS="Content-Type,Authorization,X-Requested-With"
+CORS_EXPOSE_HEADERS=""
+CORS_MAX_AGE="86400"`;
+  if (answer.prisma) {
+    const prismaEnvContent = `# Environment variables declared in this file are automatically made available to Prisma.
+# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema
+
+# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.
+# See the documentation for all the connection string options: https://pris.ly/d/connection-strings
+
+DATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"`;
+    const envContent = `${prismaEnvContent}\n\n${prismaPHPEnvContent}`;
+    await createOrUpdateEnvFile(baseDir, envContent);
+  } else {
+    await createOrUpdateEnvFile(baseDir, prismaPHPEnvContent);
+  }
+}
+async function getAnswer(predefinedAnswers = {}) {
+  console.log("🚀 ~ predefinedAnswers:", predefinedAnswers);
+  // If starter kit is specified, use non-interactive mode
+  if (predefinedAnswers.starterKit) {
+    const selectedKit = predefinedAnswers.starterKit;
+    let starterKit = null;
+    // Check built-in starter kits
+    if (STARTER_KITS[selectedKit]) {
+      starterKit = STARTER_KITS[selectedKit];
+    }
+    if (starterKit) {
+      console.log(chalk.blue(`Using starter kit: ${starterKit.name}`));
+      console.log(chalk.gray(starterKit.description));
+      const answer = {
+        projectName: predefinedAnswers.projectName ?? "my-app",
+        starterKit: selectedKit,
+        starterKitSource: predefinedAnswers.starterKitSource,
+        backendOnly: starterKit.features.backendOnly ?? false,
+        tailwindcss: starterKit.features.tailwindcss ?? false,
+        websocket: starterKit.features.websocket ?? false,
+        prisma: starterKit.features.prisma ?? false,
+        docker: starterKit.features.docker ?? false,
+        swaggerDocs: starterKit.features.swaggerDocs ?? false,
+        mcp: starterKit.features.mcp ?? false,
+      };
+      // Allow CLI overrides
+      const args = process.argv.slice(2);
+      if (args.includes("--backend-only")) answer.backendOnly = true;
+      if (args.includes("--swagger-docs")) answer.swaggerDocs = true;
+      if (args.includes("--tailwindcss")) answer.tailwindcss = true;
+      if (args.includes("--websocket")) answer.websocket = true;
+      if (args.includes("--mcp")) answer.mcp = true;
+      if (args.includes("--prisma")) answer.prisma = true;
+      if (args.includes("--docker")) answer.docker = true;
+      return answer; // ✅ Return immediately - no interactive prompts
+    }
+    // Handle custom starter kit
+    else if (predefinedAnswers.starterKitSource) {
+      console.log(
+        chalk.blue(
+          `Using custom starter kit from: ${predefinedAnswers.starterKitSource}`
+        )
+      );
+      const answer = {
+        projectName: predefinedAnswers.projectName ?? "my-app",
+        starterKit: selectedKit,
+        starterKitSource: predefinedAnswers.starterKitSource,
+        // Default features - will be overridden by starter kit config
+        backendOnly: false,
+        tailwindcss: true,
+        websocket: false,
+        prisma: true,
+        docker: false,
+        swaggerDocs: true,
+        mcp: false,
+      };
+      // Allow CLI overrides
+      const args = process.argv.slice(2);
+      if (args.includes("--backend-only")) answer.backendOnly = true;
+      if (args.includes("--swagger-docs")) answer.swaggerDocs = true;
+      if (args.includes("--tailwindcss")) answer.tailwindcss = true;
+      if (args.includes("--websocket")) answer.websocket = true;
+      if (args.includes("--mcp")) answer.mcp = true;
+      if (args.includes("--prisma")) answer.prisma = true;
+      if (args.includes("--docker")) answer.docker = true;
+      return answer; // ✅ Return immediately - no interactive prompts
+    }
+  }
+  const questionsArray = [];
+  // Ask for project name if not provided
+  if (!predefinedAnswers.projectName) {
+    questionsArray.push({
+      type: "text",
+      name: "projectName",
+      message: "What is your project named?",
+      initial: "my-app",
+    });
+  }
+  // IMPORTANT: skip asking backendOnly if updateAnswer.isUpdate is true
+  if (!predefinedAnswers.backendOnly && !updateAnswer?.isUpdate) {
+    questionsArray.push({
+      type: "toggle",
+      name: "backendOnly",
+      message: `Would you like to create a ${chalk.blue(
+        "backend-only project"
+      )}?`,
+      initial: false,
+      active: "Yes",
+      inactive: "No",
+    });
+  }
+  const onCancel = () => {
+    console.log(chalk.red("Operation cancelled by the user."));
+    process.exit(0);
+  };
+  const initialResponse = await prompts(questionsArray, { onCancel });
+  console.log("🚀 ~ initialResponse:", initialResponse);
+  const nonBackendOnlyQuestionsArray = [];
+  const isBackendOnly =
+    initialResponse.backendOnly ?? predefinedAnswers.backendOnly ?? false;
+  if (isBackendOnly) {
+    // For backend-only project (skip Tailwind), but still ask other features
+    if (!predefinedAnswers.swaggerDocs) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "swaggerDocs",
+        message: `Would you like to use ${chalk.blue("Swagger Docs")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.websocket) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "websocket",
+        message: `Would you like to use ${chalk.blue("Websocket")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.mcp) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "mcp",
+        message: `Would you like to use ${chalk.blue(
+          "MCP (Model Context Protocol)"
+        )}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.prisma) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "prisma",
+        message: `Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.docker) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "docker",
+        message: `Would you like to use ${chalk.blue("Docker")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+  } else {
+    // For full-stack project, include Tailwind
+    if (!predefinedAnswers.swaggerDocs) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "swaggerDocs",
+        message: `Would you like to use ${chalk.blue("Swagger Docs")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.tailwindcss) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "tailwindcss",
+        message: `Would you like to use ${chalk.blue("Tailwind CSS")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.websocket) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "websocket",
+        message: `Would you like to use ${chalk.blue("Websocket")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.mcp) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "mcp",
+        message: `Would you like to use ${chalk.blue(
+          "MCP (Model Context Protocol)"
+        )}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.prisma) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "prisma",
+        message: `Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+    if (!predefinedAnswers.docker) {
+      nonBackendOnlyQuestionsArray.push({
+        type: "toggle",
+        name: "docker",
+        message: `Would you like to use ${chalk.blue("Docker")}?`,
+        initial: false,
+        active: "Yes",
+        inactive: "No",
+      });
+    }
+  }
+  const nonBackendOnlyResponse = await prompts(nonBackendOnlyQuestionsArray, {
+    onCancel,
+  });
+  console.log("🚀 ~ nonBackendOnlyResponse:", nonBackendOnlyResponse);
+  return {
+    projectName: initialResponse.projectName
+      ? String(initialResponse.projectName).trim().replace(/ /g, "-")
+      : predefinedAnswers.projectName ?? "my-app",
+    backendOnly:
+      initialResponse.backendOnly ?? predefinedAnswers.backendOnly ?? false,
+    swaggerDocs:
+      nonBackendOnlyResponse.swaggerDocs ??
+      predefinedAnswers.swaggerDocs ??
+      false,
+    tailwindcss:
+      nonBackendOnlyResponse.tailwindcss ??
+      predefinedAnswers.tailwindcss ??
+      false,
+    websocket:
+      nonBackendOnlyResponse.websocket ?? predefinedAnswers.websocket ?? false,
+    mcp: nonBackendOnlyResponse.mcp ?? predefinedAnswers.mcp ?? false,
+    prisma: nonBackendOnlyResponse.prisma ?? predefinedAnswers.prisma ?? false,
+    docker: nonBackendOnlyResponse.docker ?? predefinedAnswers.docker ?? false,
+  };
+}
+async function uninstallNpmDependencies(baseDir, dependencies, isDev = false) {
+  console.log("Uninstalling dependencies:");
+  dependencies.forEach((dep) => console.log(`- ${chalk.blue(dep)}`));
+  // Prepare the npm uninstall command with the appropriate flag for dev dependencies
+  const npmUninstallCommand = `npm uninstall ${
+    isDev ? "--save-dev" : "--save"
+  } ${dependencies.join(" ")}`;
+  // Execute the npm uninstall command
+  execSync(npmUninstallCommand, {
+    stdio: "inherit",
+    cwd: baseDir,
+  });
+}
+async function uninstallComposerDependencies(baseDir, dependencies) {
+  console.log("Uninstalling Composer dependencies:");
+  dependencies.forEach((dep) => console.log(`- ${chalk.blue(dep)}`));
+  // Prepare the composer remove command
+  const composerRemoveCommand = `C:\\xampp\\php\\php.exe C:\\ProgramData\\ComposerSetup\\bin\\composer.phar remove ${dependencies.join(
+    " "
+  )}`;
+  // Execute the composer remove command
+  execSync(composerRemoveCommand, {
+    stdio: "inherit",
+    cwd: baseDir,
+  });
+}
+function fetchPackageVersion(packageName) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(`https://registry.npmjs.org/${packageName}`, (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          try {
+            const parsed = JSON.parse(data);
+            resolve(parsed["dist-tags"].latest);
+          } catch (error) {
+            reject(new Error("Failed to parse JSON response"));
+          }
+        });
+      })
+      .on("error", (err) => reject(err));
+  });
+}
+const readJsonFile = (filePath) => {
+  const jsonData = fs.readFileSync(filePath, "utf8");
+  return JSON.parse(jsonData);
+};
+function compareVersions(installedVersion, currentVersion) {
+  const installedVersionArray = installedVersion.split(".").map(Number);
+  const currentVersionArray = currentVersion.split(".").map(Number);
+  for (let i = 0; i < installedVersionArray.length; i++) {
+    if (installedVersionArray[i] > currentVersionArray[i]) {
+      return 1;
+    } else if (installedVersionArray[i] < currentVersionArray[i]) {
+      return -1;
+    }
+  }
+  return 0;
+}
+function getInstalledPackageVersion(packageName) {
+  try {
+    const output = execSync(`npm list -g ${packageName} --depth=0`).toString();
+    const versionMatch = output.match(
+      new RegExp(`${packageName}@(\\d+\\.\\d+\\.\\d+)`)
+    );
+    if (versionMatch) {
+      return versionMatch[1];
+    } else {
+      console.error(`Package ${packageName} is not installed`);
+      return null;
+    }
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return null;
+  }
+}
 /**
  * Install dependencies in the specified directory.
  * @param {string} baseDir - The base directory where to install the dependencies.
@@ -171,13 +1023,185 @@ function composerPkg(name) {
     ? `${name}:${composerPinnedVersions[name]}`
     : name;
 }
+async function downloadStarterKit(starterKit, tempDir) {
+  if (!starterKit.source) {
+    throw new Error("No source defined for starter kit");
+  }
+  const { type, url, branch = "main", subfolder } = starterKit.source;
+  switch (type) {
+    case "git":
+      console.log(chalk.blue(`Cloning ${starterKit.name} from ${url}...`));
+      const cloneCommand = branch
+        ? `git clone -b ${branch} --depth 1 ${url} ${tempDir}`
+        : `git clone --depth 1 ${url} ${tempDir}`;
+      execSync(cloneCommand, { stdio: "inherit" });
+      // Remove .git directory
+      const gitDir = path.join(tempDir, ".git");
+      if (fs.existsSync(gitDir)) {
+        fs.rmSync(gitDir, { recursive: true, force: true });
+      }
+      // Return the subfolder if specified
+      return subfolder ? path.join(tempDir, subfolder) : tempDir;
+    case "npm":
+      console.log(chalk.blue(`Downloading ${starterKit.name} from npm...`));
+      execSync(`npm pack ${url}`, { cwd: tempDir, stdio: "inherit" });
+      // Extract the tarball
+      const tarball = fs.readdirSync(tempDir).find((f) => f.endsWith(".tgz"));
+      if (tarball) {
+        execSync(`tar -xzf ${tarball}`, { cwd: tempDir });
+        fs.unlinkSync(path.join(tempDir, tarball));
+        return path.join(tempDir, "package");
+      }
+      throw new Error("Failed to extract npm package");
+    case "url":
+      throw new Error("URL download not implemented yet");
+    default:
+      throw new Error(`Unsupported source type: ${type}`);
+  }
+}
+async function mergeStarterKitFiles(starterKitPath, projectPath, answer) {
+  console.log(chalk.blue("Merging starter kit files..."));
+  // Copy all files from starter kit, but don't overwrite base files
+  copyRecursiveSync(starterKitPath, projectPath, answer);
+  // Look for starter kit specific configuration
+  const starterKitConfig = path.join(starterKitPath, "starter-kit.json");
+  if (fs.existsSync(starterKitConfig)) {
+    const config = JSON.parse(fs.readFileSync(starterKitConfig, "utf8"));
+    // Handle post-install scripts
+    if (config.postInstall) {
+      console.log(chalk.blue("Running post-install scripts..."));
+      for (const script of config.postInstall) {
+        console.log(chalk.gray(`Running: ${script}`));
+        execSync(script, { cwd: projectPath, stdio: "inherit" });
+      }
+    }
+    // Handle additional dependencies
+    if (config.additionalNpmDependencies) {
+      await installNpmDependencies(
+        projectPath,
+        config.additionalNpmDependencies.map(npmPkg),
+        true
+      );
+    }
+    if (config.additionalComposerDependencies) {
+      await installComposerDependencies(
+        projectPath,
+        config.additionalComposerDependencies.map(composerPkg)
+      );
+    }
+  }
+}
+async function setupStarterKit(baseDir, answer) {
+  if (!answer.starterKit) return;
+  let starterKit = null;
+  // Check if it's a built-in starter kit
+  if (STARTER_KITS[answer.starterKit]) {
+    starterKit = STARTER_KITS[answer.starterKit];
+  }
+  // Handle custom starter kit URL
+  else if (answer.starterKitSource) {
+    starterKit = {
+      id: answer.starterKit,
+      name: `Custom Starter Kit (${answer.starterKit})`,
+      description: "Custom starter kit from external source",
+      features: {}, // Will be determined from the downloaded kit
+      requiredFiles: [],
+      source: {
+        type: "git", // Assume git for now, could be enhanced
+        url: answer.starterKitSource,
+      },
+    };
+  }
+  if (!starterKit) {
+    console.warn(
+      chalk.yellow(`Starter kit '${answer.starterKit}' not found. Skipping...`)
+    );
+    return;
+  }
+  console.log(chalk.green(`Setting up ${starterKit.name}...`));
+  // If it's a custom starter kit with source, download it
+  if (starterKit.source) {
+    const tempDir = path.join(baseDir, ".temp-starter-kit");
+    try {
+      // Create temp directory
+      if (fs.existsSync(tempDir)) {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+      }
+      fs.mkdirSync(tempDir, { recursive: true });
+      // Download the starter kit
+      const kitPath = await downloadStarterKit(starterKit, tempDir);
+      // Merge files from starter kit
+      await mergeStarterKitFiles(kitPath, baseDir, answer);
+      // Check if starter kit has its own configuration
+      const kitConfigPath = path.join(kitPath, "prisma-php-starter.json");
+      if (fs.existsSync(kitConfigPath)) {
+        const kitConfig = JSON.parse(fs.readFileSync(kitConfigPath, "utf8"));
+        // Override features with starter kit configuration
+        Object.assign(answer, kitConfig.features || {});
+        console.log(chalk.green(`Applied starter kit configuration`));
+      }
+      // Clean up temp directory
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    } catch (error) {
+      console.error(chalk.red(`Failed to setup starter kit: ${error}`));
+      // Clean up temp directory on error
+      if (fs.existsSync(tempDir)) {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+      }
+      throw error;
+    }
+  }
+  // Run custom setup if defined
+  if (starterKit.customSetup) {
+    await starterKit.customSetup(baseDir, answer);
+  }
+  console.log(chalk.green(`✓ ${starterKit.name} setup complete!`));
+}
+function showStarterKits() {
+  console.log(chalk.blue("\n🚀 Available Starter Kits:\n"));
+  Object.values(STARTER_KITS).forEach((kit) => {
+    const isCustom = kit.source ? " (Custom)" : " (Built-in)";
+    console.log(chalk.green(`  ${kit.id}${chalk.gray(isCustom)}`));
+    console.log(`    ${kit.name}`);
+    console.log(chalk.gray(`    ${kit.description}`));
+    if (kit.source) {
+      console.log(chalk.cyan(`    Source: ${kit.source.url}`));
+    }
+    const features = Object.entries(kit.features)
+      .filter(([, value]) => value === true)
+      .map(([key]) => key)
+      .join(", ");
+    if (features) {
+      console.log(chalk.magenta(`    Features: ${features}`));
+    }
+    console.log();
+  });
+  console.log(chalk.yellow("Usage:"));
+  console.log(`  npx create-prisma-php-app my-project --starter-kit=basic`);
+  console.log(
+    `  npx create-prisma-php-app my-project --starter-kit=custom --starter-kit-source=https://github.com/user/repo`
+  );
+  console.log();
+}
 async function main() {
   try {
     const args = process.argv.slice(2);
     let projectName = args[0];
+    // Parse starter kit arguments
+    const starterKitArg = args.find((arg) => arg.startsWith("--starter-kit="));
+    const starterKitFromArgs = starterKitArg?.split("=")[1];
+    // Parse custom starter kit source
+    const starterKitSourceArg = args.find((arg) =>
+      arg.startsWith("--starter-kit-source=")
+    );
+    const starterKitSource = starterKitSourceArg?.split("=")[1];
+    // Show help
+    if (args.includes("--list-starter-kits")) {
+      showStarterKits();
+      return;
+    }
     let answer = null;
     if (projectName) {
-      // Check if it's an update FIRST
       const currentDir = process.cwd();
       const configPath = path.join(currentDir, "prisma-php.json");
       if (fs.existsSync(configPath)) {
@@ -237,23 +1261,18 @@ async function main() {
           };
         }
       } else {
-        // It's a new project - use CLI arguments
-        let useBackendOnly = args.includes("--backend-only");
-        let useSwaggerDocs = args.includes("--swagger-docs");
-        let useTailwind = args.includes("--tailwindcss");
-        let useWebsocket = args.includes("--websocket");
-        let useMcp = args.includes("--mcp");
-        let usePrisma = args.includes("--prisma");
-        let useDocker = args.includes("--docker");
+        // New project
         const predefinedAnswers = {
           projectName,
-          backendOnly: useBackendOnly,
-          swaggerDocs: useSwaggerDocs,
-          tailwindcss: useTailwind,
-          websocket: useWebsocket,
-          mcp: useMcp,
-          prisma: usePrisma,
-          docker: useDocker,
+          starterKit: starterKitFromArgs,
+          starterKitSource: starterKitSource,
+          backendOnly: args.includes("--backend-only"),
+          swaggerDocs: args.includes("--swagger-docs"),
+          tailwindcss: args.includes("--tailwindcss"),
+          websocket: args.includes("--websocket"),
+          mcp: args.includes("--mcp"),
+          prisma: args.includes("--prisma"),
+          docker: args.includes("--docker"),
         };
         answer = await getAnswer(predefinedAnswers);
       }
@@ -262,7 +1281,7 @@ async function main() {
         return;
       }
     } else {
-      // No project name provided - interactive mode
+      // Interactive mode
       answer = await getAnswer();
     }
     if (answer === null) {
@@ -293,12 +1312,40 @@ async function main() {
       execSync("npm install -g create-prisma-php-app", { stdio: "inherit" });
     }
     // Create the project directory
-    if (!projectName) fs.mkdirSync(answer.projectName);
     const currentDir = process.cwd();
-    let projectPath = projectName
-      ? currentDir
-      : path.join(currentDir, answer.projectName);
-    if (!projectName) process.chdir(answer.projectName);
+    let projectPath;
+    if (projectName) {
+      // Check if we're in an existing project (has prisma-php.json) or creating a new one
+      const configPath = path.join(currentDir, "prisma-php.json");
+      const projectNamePath = path.join(currentDir, projectName);
+      const projectNameConfigPath = path.join(
+        projectNamePath,
+        "prisma-php.json"
+      );
+      if (fs.existsSync(configPath)) {
+        // We're updating an existing project in current directory
+        projectPath = currentDir;
+      } else if (
+        fs.existsSync(projectNamePath) &&
+        fs.existsSync(projectNameConfigPath)
+      ) {
+        // We're updating an existing project in the named directory
+        projectPath = projectNamePath;
+        process.chdir(projectNamePath);
+      } else {
+        // We're creating a new project with the given name
+        if (!fs.existsSync(projectNamePath)) {
+          fs.mkdirSync(projectNamePath, { recursive: true });
+        }
+        projectPath = projectNamePath;
+        process.chdir(projectNamePath);
+      }
+    } else {
+      // Interactive mode - create directory with answer.projectName
+      fs.mkdirSync(answer.projectName, { recursive: true });
+      projectPath = path.join(currentDir, answer.projectName);
+      process.chdir(answer.projectName);
+    }
     let npmDependencies = [
       npmPkg("typescript"),
       npmPkg("@types/node"),
@@ -347,6 +1394,10 @@ async function main() {
     if (answer.prisma) {
       execSync("npm install -g prisma-client-php", { stdio: "inherit" });
     }
+    // Add starter kit setup before npm/composer installation
+    if (answer.starterKit) {
+      await setupStarterKit(projectPath, answer);
+    }
     await installNpmDependencies(projectPath, npmDependencies, true);
     await installComposerDependencies(projectPath, composerDependencies);
     if (!projectName) {
@@ -624,7 +1675,7 @@ async function main() {
       `${chalk.green(
         "Success!"
       )} Prisma PHP project successfully created in ${chalk.green(
-        `${currentDir.replace(/\\/g, "/")}/${answer.projectName}`
+        projectPath.replace(/\\/g, "/")
       )}!`
     );
     console.log("\n=========================");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-prisma-php-app",
-  "version": "4.0.0-alpha.30",
+  "version": "4.0.0-alpha.32",
   "description": "Prisma-PHP: A Revolutionary Library Bridging PHP with Prisma ORM",
   "main": "dist/index.js",
   "type": "module",