@dotcms/create-app 1.2.5-next.7 → 1.2.6-next.1

package/index.js

@@ -0,0 +1,1522 @@
+#!/usr/bin/env node
+
+// libs/sdk/create-app/src/index.ts
+import cfonts from "cfonts";
+import chalk4 from "chalk";
+import { Command } from "commander";
+import { execa as execa3 } from "execa";
+import fs4 from "fs-extra";
+import ora from "ora";
+import path5 from "path";
+
+// libs/sdk/create-app/src/api/index.ts
+import axios from "axios";
+import chalk from "chalk";
+
+// libs/sdk/create-app/src/constants/index.ts
+var DOTCMS_HOST = "http://localhost:8082";
+var DOTCMS_USER = {
+  username: "admin@dotcms.com",
+  password: "admin"
+};
+var DOTCMS_HEALTH_API = `${DOTCMS_HOST}/api/v1/appconfiguration`;
+var DOTCMS_TOKEN_API = `${DOTCMS_HOST}/api/v1/authentication/api-token`;
+var DOTCMS_EMA_CONFIG_API = `${DOTCMS_HOST}/api/v1/apps/dotema-config-v2/`;
+var DOTCMS_SITE_API = `${DOTCMS_HOST}/api/v1/site/`;
+var CLOUD_HEALTH_CHECK_RETRIES = 5;
+var LOCAL_HEALTH_CHECK_RETRIES = 60;
+var FRAMEWORKS = [
+  "nextjs",
+  "astro",
+  "angular",
+  "angular-ssr"
+];
+var FRAMEWORKS_CHOICES = [
+  { name: "Next.js", value: "nextjs" },
+  { name: "Astro", value: "astro" },
+  { name: "Angular", value: "angular" },
+  { name: "Angular (SSR)", value: "angular-ssr" }
+];
+var NEXTJS_DEPENDENCIES = [
+  "@dotcms/client",
+  "@dotcms/experiments",
+  "@dotcms/react",
+  "@dotcms/types",
+  "@dotcms/uve",
+  "@tinymce/tinymce-react",
+  "next",
+  "react",
+  "react-dom"
+];
+var NEXTJS_DEPENDENCIES_DEV = [
+  "@tailwindcss/postcss",
+  "@tailwindcss/typography",
+  "eslint",
+  "eslint-config-next",
+  "postcss",
+  "prettier",
+  "tailwindcss"
+];
+var ASTRO_DEPENDENCIES = [
+  "@astrojs/check",
+  "@astrojs/react",
+  "@astrojs/ts-plugin",
+  "@astrojs/vercel",
+  "@dotcms/client",
+  "@dotcms/react",
+  "@dotcms/types",
+  "@dotcms/uve",
+  "@tailwindcss/typography",
+  "@tailwindcss/vite",
+  "@tinymce/tinymce-react",
+  "@types/react",
+  "@types/react-dom",
+  "astro",
+  "dotenv",
+  "react",
+  "react-dom",
+  "tailwindcss",
+  "typescript"
+];
+var ASTRO_DEPENDENCIES_DEV = [
+  "@types/node",
+  "prettier",
+  "prettier-plugin-astro"
+];
+var ANGULAR_DEPENDENCIES = [
+  "@angular/animations",
+  "@angular/common",
+  "@angular/compiler",
+  "@angular/core",
+  "@angular/forms",
+  "@angular/platform-browser",
+  "@angular/platform-browser-dynamic",
+  "@angular/router",
+  "@dotcms/angular",
+  "@dotcms/client",
+  "@dotcms/types",
+  "@dotcms/uve",
+  "rxjs",
+  "tslib",
+  "zone.js"
+];
+var ANGULAR_DEPENDENCIES_DEV = [
+  "@angular/build",
+  "@angular/cli",
+  "@angular/compiler-cli",
+  "@tailwindcss/typography",
+  "@types/jasmine",
+  "autoprefixer",
+  "jasmine-core",
+  "karma",
+  "karma-chrome-launcher",
+  "karma-coverage",
+  "karma-jasmine",
+  "karma-jasmine-html-reporter",
+  "postcss",
+  "tailwindcss",
+  "typescript"
+];
+var ANGULAR_SSR_DEPENDENCIES = [
+  "@angular/common",
+  "@angular/compiler",
+  "@angular/core",
+  "@angular/forms",
+  "@angular/platform-browser",
+  "@angular/platform-server",
+  "@angular/router",
+  "@angular/ssr",
+  "@dotcms/angular",
+  "@dotcms/client",
+  "@dotcms/types",
+  "@dotcms/uve",
+  "@tailwindcss/postcss",
+  "@types/dotenv",
+  "dotenv",
+  "express",
+  "postcss",
+  "rxjs",
+  "tailwindcss",
+  "tslib",
+  "zone.js"
+];
+var ANGULAR_SSR_DEPENDENCIES_DEV = [
+  "@angular/build",
+  "@angular/cli",
+  "@angular/compiler-cli",
+  "@tailwindcss/typography",
+  "@types/express",
+  "@types/jasmine",
+  "@types/node",
+  "jasmine-core",
+  "karma",
+  "karma-chrome-launcher",
+  "karma-coverage",
+  "karma-jasmine",
+  "karma-jasmine-html-reporter",
+  "typescript"
+];
+
+// libs/sdk/create-app/src/errors/index.ts
+var FailedToCreateFrontendProjectError = class extends Error {
+  constructor(framework) {
+    super(
+      `Failed to create frontend project for framework: ${framework}. Please check if you have git installed and an active internet connection.`
+    );
+  }
+};
+var FailedToDownloadDockerComposeError = class extends Error {
+  constructor() {
+    super(`Failed to download the docker compose file`);
+  }
+};
+var FailedToSetUpUVEConfig = class extends Error {
+  constructor() {
+    super(`Failed to set up UVE configuration in DotCMS.`);
+  }
+};
+var FailedToGetDefaultSiteError = class extends Error {
+  constructor() {
+    super(`Failed to get default site identifier from DotCMS.`);
+  }
+};
+
+// libs/sdk/create-app/src/result.ts
+function Ok(val) {
+  return { ok: true, val };
+}
+function Err(val) {
+  return { ok: false, val };
+}
+
+// libs/sdk/create-app/src/api/index.ts
+function getSafeErrorDetails(err) {
+  if (axios.isAxiosError(err)) {
+    const details = [
+      err.response?.status ? `status=${err.response.status}` : null,
+      err.response?.statusText ? `statusText=${err.response.statusText}` : null,
+      err.code ? `code=${err.code}` : null,
+      err.message ? `message=${err.message}` : null
+    ].filter(Boolean);
+    return details.length > 0 ? details.join(", ") : "Axios request failed";
+  }
+  if (err instanceof Error) {
+    return err.message;
+  }
+  return String(err);
+}
+var DotCMSApi = class {
+  static {
+    this.defaultTokenApi = DOTCMS_TOKEN_API;
+  }
+  static {
+    this.defaultSiteApi = DOTCMS_SITE_API;
+  }
+  static {
+    this.defaultUveConfigApi = DOTCMS_EMA_CONFIG_API;
+  }
+  /** Get authentication token */
+  static async getAuthToken({
+    payload,
+    url
+  }) {
+    const endpoint = url || this.defaultTokenApi;
+    try {
+      const res = await axios.post(endpoint, payload);
+      return Ok(res.data.entity.token);
+    } catch (err) {
+      if (axios.isAxiosError(err)) {
+        if (err.response?.status === 401) {
+          return Err(
+            chalk.red("\n\u274C Authentication failed\n\n") + chalk.white("Invalid username or password.\n\n") + chalk.yellow("Please check your credentials and try again:\n") + chalk.white("  \u2022 Verify your username is correct\n") + chalk.white("  \u2022 Ensure your password is correct\n") + chalk.white("  \u2022 Check if your account is active\n")
+          );
+        } else if (err.code === "ECONNREFUSED") {
+          return Err(
+            chalk.red("\n\u274C Connection refused\n\n") + chalk.white(`Could not connect to dotCMS at: ${endpoint}
+
+`) + chalk.yellow("Please verify:\n") + chalk.white("  \u2022 The URL is correct\n") + chalk.white("  \u2022 The dotCMS instance is running\n") + chalk.white("  \u2022 There are no firewall issues\n")
+          );
+        } else if (err.response) {
+          return Err(
+            chalk.red(`
+\u274C Server error (${err.response.status})
+
+`) + chalk.white("The dotCMS server returned an error.\n") + chalk.gray(`Details: ${err.response.statusText || "Unknown error"}
+`)
+          );
+        }
+      }
+      return Err(
+        chalk.red("\n\u274C Failed to get authentication token\n\n") + chalk.gray(err instanceof Error ? err.message : String(err))
+      );
+    }
+  }
+  /** Get default site */
+  static async getDefaultSite({
+    authenticationToken,
+    url
+  }) {
+    try {
+      const endpoint = (url || this.defaultSiteApi) + "defaultSite";
+      const res = await axios.get(endpoint, {
+        headers: { Authorization: `Bearer ${authenticationToken}` }
+      });
+      return Ok(res.data);
+    } catch (err) {
+      console.error(`failed to get default site identifier: ${getSafeErrorDetails(err)}`);
+      return Err(new FailedToGetDefaultSiteError());
+    }
+  }
+  /** Setup UVE Config */
+  static async setupUVEConfig({
+    payload,
+    siteId,
+    authenticationToken,
+    url
+  }) {
+    try {
+      const endpoint = (url || this.defaultUveConfigApi) + siteId;
+      const res = await axios.post(endpoint, payload, {
+        headers: { Authorization: `Bearer ${authenticationToken}` }
+      });
+      return Ok(res.data.entity);
+    } catch (err) {
+      console.error(`failed to setup UVE config: ${getSafeErrorDetails(err)}`);
+      return Err(new FailedToSetUpUVEConfig());
+    }
+  }
+};
+
+// libs/sdk/create-app/src/asks.ts
+import fs from "fs-extra";
+import inquirer from "inquirer";
+import path2 from "path";
+
+// libs/sdk/create-app/src/utils/validation.ts
+import chalk2 from "chalk";
+import path from "path";
+var MAX_PROJECT_NAME_LENGTH = 255;
+var FRAMEWORK_ALIASES = {
+  next: "nextjs",
+  "next.js": "nextjs",
+  ng: "angular",
+  "angular-server": "angular-ssr"
+};
+function validateAndNormalizeFramework(framework) {
+  if (!framework)
+    return void 0;
+  const normalized = framework.toLowerCase().replace(/\s+/g, "");
+  if (normalized in FRAMEWORK_ALIASES) {
+    return FRAMEWORK_ALIASES[normalized];
+  }
+  if (FRAMEWORKS.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(
+    chalk2.red(`\u274C Invalid framework: "${framework}"`) + "\n\n" + chalk2.white("Supported frameworks:\n") + FRAMEWORKS.map((f) => chalk2.cyan(`  \u2022 ${f}`)).join("\n") + "\n\n" + chalk2.gray("\u{1F4A1} Tip: Framework names are case-insensitive\n") + chalk2.gray("   Aliases: next \u2192 nextjs, ng \u2192 angular")
+  );
+}
+function normalizeUrl(url) {
+  return url.replace(/\/+$/, "");
+}
+function validateUrl(url) {
+  if (!url || url.trim() === "")
+    return;
+  const normalizedUrl = normalizeUrl(url);
+  if (!normalizedUrl.includes("://")) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid URL format: "${normalizedUrl}"`) + "\n\n" + chalk2.white("URLs must include the protocol (http:// or https://)\n\n") + chalk2.cyan("Example:\n  https://demo.dotcms.com\n\n") + chalk2.gray("Need help?\n") + chalk2.gray("  \u2022 Use --local flag to run dotCMS in Docker\n") + chalk2.gray("  \u2022 Check our docs: https://dev.dotcms.com")
+    );
+  }
+  let parsed;
+  try {
+    parsed = new URL(normalizedUrl);
+  } catch (error) {
+    if (error instanceof TypeError) {
+      throw new Error(
+        chalk2.red(`\u274C Invalid URL format: "${normalizedUrl}"`) + "\n\n" + chalk2.white("Please provide a valid HTTP/HTTPS URL\n\n") + chalk2.cyan("Example:\n  https://demo.dotcms.com")
+      );
+    }
+    throw error;
+  }
+  if (!["http:", "https:"].includes(parsed.protocol)) {
+    throw new Error(
+      chalk2.red(`\u274C Unsupported protocol: ${parsed.protocol}`) + "\n\n" + chalk2.white("Only HTTP and HTTPS are supported")
+    );
+  }
+  if (!parsed.hostname) {
+    throw new Error(chalk2.red("\u274C URL missing hostname"));
+  }
+  if (parsed.hostname === "localhost" && parsed.port !== "8082") {
+    console.log(
+      chalk2.yellow("\u26A0\uFE0F  Warning: ") + chalk2.white("Using localhost but port is not 8082 (default dotCMS port)")
+    );
+  }
+}
+function validateProjectName(projectName) {
+  if (projectName === void 0 || projectName === null) {
+    return void 0;
+  }
+  const trimmed = projectName.trim();
+  if (trimmed.length === 0) {
+    throw new Error(
+      chalk2.red("\u274C Invalid project name: cannot be empty") + "\n\n" + chalk2.white("Project name must contain at least one character\n\n") + chalk2.cyan("Valid examples:\n") + chalk2.gray("  \u2022 my-dotcms-app\n") + chalk2.gray("  \u2022 my_project\n") + chalk2.gray("  \u2022 MyProject123")
+    );
+  }
+  if (trimmed === "." || trimmed === ".." || trimmed.includes("../") || trimmed.includes("..\\")) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid project name: "${projectName}"`) + "\n\n" + chalk2.white("Project name cannot contain path traversal patterns (..)\n\n") + chalk2.gray("Use the --directory flag to specify the parent directory")
+    );
+  }
+  if (path.isAbsolute(trimmed)) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid project name: "${projectName}"`) + "\n\n" + chalk2.white("Project name cannot be an absolute path\n\n") + chalk2.gray("Use the --directory flag to specify the location")
+    );
+  }
+  if (trimmed.startsWith("-")) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid project name: "${projectName}"`) + "\n\n" + chalk2.white("Project name cannot start with a hyphen (-)\n\n") + chalk2.gray("This can be confused with command-line flags\n\n") + chalk2.cyan("Try:\n") + chalk2.gray(`  \u2022 ${trimmed.slice(1)} (remove leading hyphen)
+`) + chalk2.gray(`  \u2022 my${trimmed} (add prefix)`)
+    );
+  }
+  if (trimmed.startsWith(".")) {
+    console.warn(
+      chalk2.yellow("\n\u26A0\uFE0F  Warning: Project name starts with a dot\n") + chalk2.gray("This will create a hidden directory on Unix systems\n")
+    );
+  }
+  const validPattern = /^[a-zA-Z0-9._-]+$/;
+  if (!validPattern.test(trimmed)) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid project name: "${projectName}"`) + "\n\n" + chalk2.white("Project names can only contain:\n") + chalk2.white("  \u2022 Letters (a-z, A-Z)\n") + chalk2.white("  \u2022 Numbers (0-9)\n") + chalk2.white("  \u2022 Hyphens (-)\n") + chalk2.white("  \u2022 Underscores (_)\n") + chalk2.white("  \u2022 Dots (.)\n\n") + chalk2.cyan("Valid examples:\n") + chalk2.gray("  \u2022 my-dotcms-app\n") + chalk2.gray("  \u2022 my_project\n") + chalk2.gray("  \u2022 MyProject.v2\n") + chalk2.gray("  \u2022 project-123\n\n") + chalk2.yellow("Invalid examples:\n") + chalk2.gray("  \u2022 test@#$%project (special characters)\n") + chalk2.gray("  \u2022 my project (spaces)\n") + chalk2.gray("  \u2022 project! (exclamation marks)")
+    );
+  }
+  const reservedNames = [
+    "CON",
+    "PRN",
+    "AUX",
+    "NUL",
+    "COM1",
+    "COM2",
+    "COM3",
+    "COM4",
+    "COM5",
+    "COM6",
+    "COM7",
+    "COM8",
+    "COM9",
+    "LPT1",
+    "LPT2",
+    "LPT3",
+    "LPT4",
+    "LPT5",
+    "LPT6",
+    "LPT7",
+    "LPT8",
+    "LPT9"
+  ];
+  if (reservedNames.includes(trimmed.toUpperCase())) {
+    throw new Error(
+      chalk2.red(`\u274C Invalid project name: "${projectName}"`) + "\n\n" + chalk2.white("This is a reserved system name on Windows\n\n") + chalk2.gray("Please choose a different name")
+    );
+  }
+  if (trimmed.length > MAX_PROJECT_NAME_LENGTH) {
+    throw new Error(
+      chalk2.red("\u274C Project name too long") + "\n\n" + chalk2.white(
+        `Maximum: ${MAX_PROJECT_NAME_LENGTH} characters (you provided: ${trimmed.length})
+
+`
+      ) + chalk2.gray("Please use a shorter name")
+    );
+  }
+  return projectName;
+}
+function escapeShellPath(filePath) {
+  if (!filePath)
+    return '""';
+  if (filePath.startsWith('"') && filePath.endsWith('"') || filePath.startsWith("'") && filePath.endsWith("'")) {
+    return filePath;
+  }
+  const needsEscaping = process.platform === "win32" ? /[\s'"`$!&*(){};<>?|\n\r\t[\]]/.test(filePath) : /[\s'"`$!&*(){};<>?|\\\n\r\t[\]]/.test(filePath);
+  if (needsEscaping) {
+    const escaped = process.platform === "win32" ? filePath.replace(/"/g, '\\"') : filePath.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `"${escaped}"`;
+  }
+  return filePath;
+}
+function validateConflictingParameters(options) {
+  const isLocalSet = options.local === true || Boolean(options.starter);
+  if (!isLocalSet)
+    return;
+  const localModeSource = options.local ? "--local" : "--starter";
+  const cloudParams = [];
+  if (options.url)
+    cloudParams.push("--url");
+  if (options.username)
+    cloudParams.push("--username");
+  if (options.password)
+    cloudParams.push("--password");
+  if (cloudParams.length > 0) {
+    console.warn(
+      chalk2.yellow("\n\u26A0\uFE0F  Warning: Conflicting parameters detected\n") + chalk2.white("You enabled local mode using ") + chalk2.cyan(localModeSource) + chalk2.white(" along with cloud parameters: ") + chalk2.cyan(cloudParams.join(", ")) + "\n\n" + chalk2.gray("Local mode selection will be used (Docker deployment)") + "\n" + chalk2.gray("Cloud parameters will be ignored\n")
+    );
+  }
+}
+
+// libs/sdk/create-app/src/asks.ts
+async function askFramework() {
+  const ans = await inquirer.prompt([
+    {
+      type: "select",
+      name: "frameworks",
+      message: "Select your frontend framework:",
+      choices: FRAMEWORKS_CHOICES
+    }
+  ]);
+  return ans.frameworks;
+}
+async function askProjectName() {
+  const ans = await inquirer.prompt([
+    {
+      type: "input",
+      name: "projectName",
+      message: "What is your project name ?",
+      default: `my-dotcms-app`,
+      validate: (input) => {
+        try {
+          validateProjectName(input);
+          return true;
+        } catch (error) {
+          return error instanceof Error ? error.message : String(error);
+        }
+      }
+    }
+  ]);
+  return ans.projectName;
+}
+async function askDirectory() {
+  const ans = await inquirer.prompt([
+    {
+      type: "input",
+      name: "directory",
+      message: "Where should we create your project?",
+      default: `.`
+    }
+  ]);
+  return ans.directory;
+}
+async function askDotcmsCloudUrl() {
+  const ans = await inquirer.prompt([
+    {
+      type: "input",
+      name: "url",
+      message: "dotCMS instance URL:",
+      default: `https://demo.dotcms.com`,
+      validate: (input) => {
+        try {
+          validateUrl(input);
+          return true;
+        } catch (error) {
+          return error instanceof Error ? error.message : String(error);
+        }
+      }
+    }
+  ]);
+  return ans.url;
+}
+async function askUserNameForDotcmsCloud() {
+  const ans = await inquirer.prompt([
+    {
+      type: "input",
+      name: "username",
+      message: "Username:",
+      default: `admin@dotcms.com`,
+      validate: (input) => {
+        if (!input || input.trim() === "") {
+          return "Username cannot be empty";
+        }
+        return true;
+      }
+    }
+  ]);
+  return ans.username;
+}
+async function askPasswordForDotcmsCloud() {
+  const ans = await inquirer.prompt([
+    {
+      type: "password",
+      name: "password",
+      mask: "\u2022",
+      message: "Password:",
+      default: `admin`,
+      validate: (input) => {
+        if (!input || input.trim() === "") {
+          return "Password cannot be empty";
+        }
+        return true;
+      }
+    }
+  ]);
+  return ans.password;
+}
+async function askCloudOrLocalInstance() {
+  const ans = await inquirer.prompt([
+    {
+      type: "select",
+      name: "isCloud",
+      message: "Do you have an existing dotCMS instance?",
+      choices: [
+        { name: "Yes - I have a dotCMS instance URL", value: true },
+        { name: "No - Spin up dotCMS locally with Docker", value: false }
+      ]
+    }
+  ]);
+  return ans.isCloud;
+}
+async function prepareDirectory(basePath, projectName) {
+  const resolvedBasePath = path2.resolve(basePath);
+  const basePathDirName = path2.basename(resolvedBasePath);
+  let targetPath;
+  if (basePathDirName === projectName) {
+    targetPath = resolvedBasePath;
+  } else {
+    targetPath = path2.resolve(resolvedBasePath, projectName);
+  }
+  if (!fs.existsSync(targetPath)) {
+    fs.mkdirSync(targetPath, { recursive: true });
+    return targetPath;
+  }
+  const files = fs.readdirSync(targetPath);
+  if (files.length === 0) {
+    return targetPath;
+  }
+  const ans = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "confirm",
+      message: `\u26A0\uFE0F  Directory "${targetPath}" is not empty. All files inside will be deleted. Continue?`,
+      default: false
+    }
+  ]);
+  if (!ans.confirm) {
+    console.log("\u274C Operation cancelled.");
+    process.exit(1);
+  }
+  await fs.emptyDir(targetPath);
+  return targetPath;
+}
+
+// libs/sdk/create-app/src/git/index.ts
+import { execa as execa2 } from "execa";
+import fs3 from "fs-extra";
+import path4 from "path";
+
+// libs/sdk/create-app/src/utils/index.ts
+import axios2 from "axios";
+import chalk3 from "chalk";
+import { execa } from "execa";
+import fs2 from "fs-extra";
+import https from "https";
+import net from "net";
+import path3 from "path";
+async function fetchWithRetry(url, retries = 5, delay = 5e3, requestTimeout = 1e4) {
+  const errors = [];
+  let lastError;
+  for (let i = 0; i < retries; i++) {
+    try {
+      return await axios2.get(url, {
+        timeout: requestTimeout,
+        // Accept any 2xx status code as success (health endpoints may return 200, 201, 204, etc.)
+        validateStatus: (status) => status >= 200 && status < 300
+      });
+    } catch (err) {
+      lastError = err;
+      let errorMsg = "";
+      if (axios2.isAxiosError(err)) {
+        if (err.code === "ECONNREFUSED") {
+          errorMsg = "Connection refused - service not accepting connections";
+        } else if (err.code === "ETIMEDOUT" || err.code === "ECONNABORTED") {
+          errorMsg = "Connection timeout - service too slow or not responding";
+        } else if (err.response) {
+          errorMsg = `HTTP ${err.response.status}: ${err.response.statusText}`;
+        } else {
+          errorMsg = err.code || err.message;
+        }
+      } else {
+        errorMsg = String(err);
+      }
+      errors.push(`Attempt ${i + 1}: ${errorMsg}`);
+      if (i === retries - 1) {
+        const errorType = axios2.isAxiosError(lastError) && lastError.code === "ECONNREFUSED" ? "Connection Refused" : axios2.isAxiosError(lastError) && (lastError.code === "ETIMEDOUT" || lastError.code === "ECONNABORTED") ? "Timeout" : "Connection Failed";
+        throw new Error(
+          chalk3.red(
+            `
+\u274C Failed to connect to dotCMS after ${retries} attempts (${errorType})
+
+`
+          ) + chalk3.white(`URL: ${url}
+`) + chalk3.gray(`Request timeout: ${requestTimeout}ms per attempt
+`) + chalk3.gray(
+            `Total retry window: ~${retries * (delay + requestTimeout) / 1e3}s
+
+`
+          ) + chalk3.yellow("Common causes:\n") + chalk3.white("  \u2022 dotCMS is still starting up (may need more time)\n") + chalk3.white("  \u2022 Container crashed or failed to start\n") + chalk3.white("  \u2022 Port conflict (8082 already in use)\n") + chalk3.white("  \u2022 Network/firewall blocking connection\n") + chalk3.white(
+            `  \u2022 Request timeout too short (current: ${requestTimeout}ms)
+
+`
+          ) + chalk3.gray(
+            "Detailed error history:\n" + errors.map((e) => `  \u2022 ${e}`).join("\n")
+          )
+        );
+      }
+      console.log(
+        chalk3.yellow(`\u23F3 dotCMS not ready (attempt ${i + 1}/${retries})`) + chalk3.gray(` - ${errorMsg}`) + chalk3.gray(` - Retrying in ${delay / 1e3}s...`)
+      );
+      await new Promise((r) => setTimeout(r, delay));
+    }
+  }
+}
+function getUVEConfigValue(frontEndUrl) {
+  return JSON.stringify({
+    config: [
+      {
+        pattern: ".*",
+        url: frontEndUrl
+      }
+    ]
+  });
+}
+function getPortByFramework(framework) {
+  switch (framework) {
+    case "angular":
+      return "4200";
+    case "angular-ssr":
+      return "4200";
+    case "nextjs":
+      return "3000";
+    case "astro":
+      return "4321";
+    default:
+      throw new Error(`Unsupported framework: ${framework}`);
+  }
+}
+function getDotcmsApisByBaseUrl(baseUrl) {
+  return {
+    // Note: Using /appconfiguration instead of /probes/alive because the probe endpoints
+    // have IP ACL restrictions that block requests from Docker host.
+    // See: https://github.com/dotCMS/core/issues/34509
+    DOTCMS_HEALTH_API: `${baseUrl}/api/v1/appconfiguration`,
+    DOTCMS_TOKEN_API: `${baseUrl}/api/v1/authentication/api-token`,
+    DOTCMS_EMA_CONFIG_API: `${baseUrl}/api/v1/apps/dotema-config-v2/`,
+    DOTCMS_SITE_API: `${baseUrl}/api/v1/site/`
+  };
+}
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs2.createWriteStream(dest);
+    https.get(url, (response) => {
+      if (response.statusCode !== 200) {
+        return reject(new Error(`Failed to download file: ${response.statusCode}`));
+      }
+      response.pipe(file);
+      file.on("finish", () => file.close(() => resolve()));
+    }).on("error", (err) => {
+      fs2.unlink(dest);
+      reject(err);
+    });
+  });
+}
+function finalStepsForNextjs({
+  projectPath,
+  urlDotCMSInstance,
+  siteId,
+  token
+}) {
+  console.log("\n");
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.greenBright("\u{1F4CB} Next Steps:\n"));
+  console.log(
+    chalk3.white("1. Navigate to your project:\n") + chalk3.gray(`   $ cd ${escapeShellPath(projectPath)}
+`)
+  );
+  console.log(
+    chalk3.white("2. Create your environment file:\n") + chalk3.gray("   $ touch .env\n")
+  );
+  console.log(chalk3.white("3. Add your dotCMS configuration to ") + chalk3.green(".env") + ":\n");
+  console.log(chalk3.white("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(chalk3.white(getEnvVariablesForNextJS(urlDotCMSInstance, siteId, token)));
+  console.log(chalk3.white("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(chalk3.gray("   \u{1F4A1} Tip: Copy the block above and paste into your .env file\n"));
+  console.log(
+    chalk3.white("4. Start your development server:\n") + chalk3.gray("   $ npm run dev\n")
+  );
+  console.log(
+    chalk3.white("5. Open your browser:\n") + chalk3.gray("   \u2192 http://localhost:3000\n")
+  );
+  console.log(
+    chalk3.white("6. Edit your page content in dotCMS:\n") + chalk3.gray(`   \u2192 ${urlDotCMSInstance}/dotAdmin/#/edit-page?url=/index
+`)
+  );
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.blueBright("\u{1F4D6} Documentation: ") + chalk3.white("https://dev.dotcms.com"));
+  console.log(chalk3.blueBright("\u{1F4AC} Community: ") + chalk3.white("https://community.dotcms.com\n"));
+}
+function finalStepsForAstro({
+  projectPath,
+  urlDotCMSInstance,
+  siteId,
+  token
+}) {
+  console.log("\n");
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.greenBright("\u{1F4CB} Next Steps:\n"));
+  console.log(
+    chalk3.white("1. Navigate to your project:\n") + chalk3.gray(`   $ cd ${escapeShellPath(projectPath)}
+`)
+  );
+  console.log(
+    chalk3.white("2. Create your environment file:\n") + chalk3.gray("   $ touch .env\n")
+  );
+  console.log(chalk3.white("3. Add your dotCMS configuration to ") + chalk3.green(".env") + ":\n");
+  console.log(chalk3.white("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(chalk3.white(getEnvVariablesForAstro(urlDotCMSInstance, siteId, token)));
+  console.log(chalk3.white("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(chalk3.gray("   \u{1F4A1} Tip: Copy the block above and paste into your .env file\n"));
+  console.log(
+    chalk3.white("4. Start your development server:\n") + chalk3.gray("   $ npm run dev\n")
+  );
+  console.log(
+    chalk3.white("5. Open your browser:\n") + chalk3.gray("   \u2192 http://localhost:3000\n")
+  );
+  console.log(
+    chalk3.white("6. Edit your page content in dotCMS:\n") + chalk3.gray(`   \u2192 ${urlDotCMSInstance}/dotAdmin/#/edit-page?url=/index
+`)
+  );
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.blueBright("\u{1F4D6} Documentation: ") + chalk3.white("https://dev.dotcms.com"));
+  console.log(chalk3.blueBright("\u{1F4AC} Community: ") + chalk3.white("https://community.dotcms.com\n"));
+}
+function finalStepsForAngularAndAngularSSR({
+  projectPath,
+  urlDotCMSInstance,
+  siteId,
+  token
+}) {
+  console.log("\n");
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.greenBright("\u{1F4CB} Next Steps:\n"));
+  console.log(
+    chalk3.white("1. Navigate to your environments directory:\n") + chalk3.gray(`   $ cd ${escapeShellPath(projectPath)}/src/environments
+`)
+  );
+  console.log(
+    chalk3.white("2. Update the environment files:\n") + chalk3.gray(
+      "   Replace the contents of the following files:\n   \u2022 environment.ts\n   \u2022 environment.development.ts\n\n"
+    )
+  );
+  console.log(chalk3.white("3. Add your dotCMS configuration:\n"));
+  console.log(chalk3.white("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(chalk3.white(getEnvVariablesForAngular(urlDotCMSInstance, siteId, token)));
+  console.log(chalk3.white("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(
+    chalk3.gray("   \u{1F4A1} Tip: Copy the block above and paste it into both environment files\n")
+  );
+  console.log(chalk3.white("4. Start your development server:\n") + chalk3.gray("   $ ng serve\n"));
+  console.log(
+    chalk3.white("5. Open your browser:\n") + chalk3.gray("   \u2192 http://localhost:4200\n")
+  );
+  console.log(
+    chalk3.white("6. Edit your page content in dotCMS:\n") + chalk3.gray(`   \u2192 ${urlDotCMSInstance}/dotAdmin/#/edit-page?url=/index
+`)
+  );
+  console.log(chalk3.white("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.blueBright("\u{1F4D6} Documentation: ") + chalk3.white("https://dev.dotcms.com"));
+  console.log(chalk3.blueBright("\u{1F4AC} Community: ") + chalk3.white("https://community.dotcms.com\n"));
+}
+function getEnvVariablesForNextJS(host, siteId, token) {
+  return `
+        NEXT_PUBLIC_DOTCMS_AUTH_TOKEN=${token}
+        NEXT_PUBLIC_DOTCMS_HOST=${host}
+        NEXT_PUBLIC_DOTCMS_SITE_ID=${siteId}
+        NEXT_PUBLIC_DOTCMS_MODE='production'
+    `;
+}
+function getEnvVariablesForAstro(host, siteId, token) {
+  return `
+        PUBLIC_DOTCMS_AUTH_TOKEN=${token}
+        PUBLIC_DOTCMS_HOST=${host}
+        PUBLIC_DOTCMS_SITE_ID=${siteId}
+        PUBLIC_EXPERIMENTS_API_KEY=analytic-api-key-from-dotcms-portlet
+        PUBLIC_EXPERIMENTS_DEBUG=true
+    `;
+}
+function getEnvVariablesForAngular(host, siteId, token) {
+  return `
+    export const environment = {
+        dotcmsUrl: '${host}',
+        authToken: '${token}',
+        siteId: '${siteId}',
+    };
+    `;
+}
+async function installDependenciesForProject(projectPath) {
+  try {
+    await execa("npm", ["install"], {
+      cwd: projectPath
+      // stdio: 'inherit', // optional: shows npm output in terminal
+    });
+    return Ok(true);
+  } catch {
+    return Err("Failed to install dependencies. Please make sure npm is installed");
+  }
+}
+function displayDependencies(selectedFrameWork) {
+  switch (selectedFrameWork) {
+    case "nextjs":
+      return formatDependencies(NEXTJS_DEPENDENCIES, NEXTJS_DEPENDENCIES_DEV);
+    case "astro":
+      return formatDependencies(ASTRO_DEPENDENCIES, ASTRO_DEPENDENCIES_DEV);
+    case "angular":
+      return formatDependencies(ANGULAR_DEPENDENCIES, ANGULAR_DEPENDENCIES_DEV);
+    case "angular-ssr":
+      return formatDependencies(ANGULAR_SSR_DEPENDENCIES, ANGULAR_SSR_DEPENDENCIES_DEV);
+    default:
+      return "";
+  }
+}
+function formatDependencies(dependencies, devDependencies) {
+  const lines = [];
+  lines.push(chalk3.white("Dependencies:"));
+  dependencies.forEach((item) => lines.push(chalk3.grey(`- ${item}`)));
+  lines.push("");
+  lines.push(chalk3.white("Dev Dependencies:"));
+  devDependencies.forEach((item) => lines.push(chalk3.grey(`- ${item}`)));
+  return lines.join("\n");
+}
+async function checkDockerAvailability() {
+  try {
+    await execa("docker", ["info"]);
+    return Ok(true);
+  } catch {
+    const errorMsg = chalk3.red("\n\u274C Docker is not available\n\n") + chalk3.white("Docker is required to run dotCMS locally.\n\n") + chalk3.yellow("How to fix:\n") + chalk3.white("  1. Install Docker Desktop:\n") + chalk3.cyan("     \u2192 https://www.docker.com/products/docker-desktop\n\n") + chalk3.white("  2. Start Docker Desktop\n") + chalk3.white(
+      "  3. Wait for Docker to be running (check the Docker icon in your system tray)\n"
+    ) + chalk3.white("  4. Run this command again\n\n") + chalk3.gray("Alternative: Use --url flag to connect to an existing dotCMS instance");
+    return Err(errorMsg);
+  }
+}
+function isPortAvailable(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        resolve(false);
+      } else {
+        console.warn(
+          chalk3.yellow(
+            `Warning: Unexpected error while checking port ${port}: ${err.message}`
+          )
+        );
+        resolve(false);
+      }
+    });
+    server.once("listening", () => {
+      server.close();
+      resolve(true);
+    });
+    server.listen(port, "0.0.0.0");
+  });
+}
+async function checkPortsAvailability() {
+  const requiredPorts = [
+    { port: 8082, service: "dotCMS HTTP" },
+    { port: 8443, service: "dotCMS HTTPS" },
+    { port: 9200, service: "Elasticsearch HTTP" },
+    { port: 9600, service: "Elasticsearch Transport" }
+  ];
+  const busyPorts = [];
+  for (const { port, service } of requiredPorts) {
+    const available = await isPortAvailable(port);
+    if (!available) {
+      busyPorts.push({ port, service });
+    }
+  }
+  if (busyPorts.length > 0) {
+    const errorMsg = chalk3.red("\n\u274C Required ports are already in use\n\n") + chalk3.white("The following ports are busy:\n") + busyPorts.map(
+      ({ port, service }) => chalk3.yellow(`  \u2022 Port ${port}`) + chalk3.gray(` (${service})`)
+    ).join("\n") + "\n\n" + chalk3.yellow("How to fix:\n") + chalk3.white("  1. Stop services using these ports:\n") + chalk3.gray("     \u2022 Check what's using the ports: ") + chalk3.cyan(
+      process.platform === "win32" ? `netstat -ano | findstr ":<port>"` : `lsof -i :<port>`
+    ) + "\n" + chalk3.gray("     \u2022 Stop the conflicting service\n\n") + chalk3.white("  2. Or stop existing dotCMS containers:\n") + chalk3.cyan("     $ docker compose down\n\n") + chalk3.white("  3. Run this command again\n\n") + chalk3.gray("Alternative: Use --url flag to connect to an existing dotCMS instance");
+    return Err(errorMsg);
+  }
+  return Ok(true);
+}
+async function getDockerDiagnostics(directory) {
+  const diagnostics = [];
+  const dockerAvailable = await checkDockerAvailability();
+  if (!dockerAvailable.ok) {
+    return dockerAvailable.val;
+  }
+  try {
+    const { stdout: psOutput } = await execa(
+      "docker",
+      ["ps", "-a", "--format", "{{.Names}}	{{.Status}}	{{.Ports}}"],
+      { cwd: directory }
+    );
+    if (!psOutput.trim()) {
+      diagnostics.push(chalk3.yellow("\n\u26A0\uFE0F  No Docker containers found"));
+      diagnostics.push(
+        chalk3.white("The docker-compose.yml may not have been started correctly\n")
+      );
+      return diagnostics.join("\n");
+    }
+    diagnostics.push(chalk3.cyan("\n\u{1F4CB} Container Status:"));
+    const containers = psOutput.trim().split("\n");
+    for (const container of containers) {
+      const [name, status, ports] = container.split("	");
+      const isHealthy = status.includes("Up") && !status.includes("unhealthy");
+      const icon = isHealthy ? "\u2705" : "\u274C";
+      diagnostics.push(`  ${icon} ${chalk3.white(name)}: ${chalk3.gray(status)}`);
+      if (ports) {
+        diagnostics.push(`     ${chalk3.gray("Ports:")} ${chalk3.white(ports)}`);
+      }
+    }
+    const unhealthyContainers = containers.filter(
+      (c) => !c.includes("Up") || c.includes("unhealthy") || c.includes("Exited")
+    );
+    if (unhealthyContainers.length > 0) {
+      diagnostics.push(chalk3.yellow("\n\u{1F50D} Recent logs from problematic containers:\n"));
+      for (const container of unhealthyContainers) {
+        const name = container.split("	")[0];
+        try {
+          const { stdout: logs } = await execa("docker", ["logs", "--tail", "20", name], {
+            cwd: directory,
+            reject: false
+          });
+          diagnostics.push(chalk3.white(`
+--- ${name} ---`));
+          diagnostics.push(chalk3.gray(logs.split("\n").slice(-10).join("\n")));
+        } catch {
+          diagnostics.push(chalk3.gray(`  Unable to fetch logs for ${name}`));
+        }
+      }
+    }
+  } catch (error) {
+    diagnostics.push(chalk3.red("\n\u274C Failed to get Docker diagnostics"));
+    diagnostics.push(chalk3.gray(String(error)));
+  }
+  diagnostics.push(chalk3.yellow("\n\u{1F4A1} Troubleshooting steps:"));
+  diagnostics.push(chalk3.white("  1. Check if all containers are running:"));
+  diagnostics.push(chalk3.gray("     docker ps"));
+  diagnostics.push(chalk3.white("  2. View logs for a specific container:"));
+  diagnostics.push(chalk3.gray("     docker logs <container-name>"));
+  diagnostics.push(chalk3.white("  3. Restart the containers:"));
+  diagnostics.push(chalk3.gray("     docker compose down && docker compose up -d"));
+  diagnostics.push(chalk3.white("  4. Check if ports 8082, 8443, 9200, and 9600 are available\n"));
+  return diagnostics.join("\n");
+}
+function getDisplayPath(targetPath, cwd) {
+  const relativePath = path3.relative(cwd, targetPath);
+  const parentDirCount = (relativePath.match(/\.\.\//g) || []).length;
+  if (parentDirCount >= 3) {
+    return targetPath;
+  }
+  return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+}
+
+// libs/sdk/create-app/src/git/index.ts
+var cloneFrontEndSample = async ({
+  framework,
+  directory
+}) => {
+  await execa2(
+    "git",
+    ["clone", "--filter=blob:none", "--sparse", "https://github.com/dotCMS/core.git", "."],
+    { cwd: directory }
+  );
+  await execa2("git", ["sparse-checkout", "set", `examples/${framework}`], {
+    cwd: directory
+  });
+  await execa2("git", ["checkout", "main"], {
+    cwd: directory
+    // stdio: 'inherit'
+  });
+  const src = path4.join(directory, "examples", `${framework}`);
+  const dest = directory;
+  const items = await fs3.readdir(directory);
+  for (const item of items) {
+    if (item !== "examples") {
+      await fs3.remove(path4.join(directory, item));
+    }
+  }
+  await fs3.copy(src, dest, { overwrite: true });
+  const allItems = await fs3.readdir(directory);
+  for (const item of allItems) {
+    if (item === "examples") {
+      await fs3.remove(path4.join(directory, item));
+    }
+  }
+};
+async function downloadDockerCompose(directory) {
+  const dockerUrl = "https://raw.githubusercontent.com/dotCMS/core/main/docker/docker-compose-examples/single-node-demo-site/docker-compose.yml";
+  const dockerComposePath = path4.join(directory, "docker-compose.yml");
+  await downloadFile(dockerUrl, dockerComposePath);
+}
+async function moveDockerComposeOneLevelUp(directory) {
+  const sourcePath = path4.join(directory, "docker-compose.yml");
+  const targetPath = path4.join(directory, "..", "docker-compose.yml");
+  await fs3.rename(sourcePath, targetPath);
+}
+async function moveDockerComposeBack(directory) {
+  const sourcePath = path4.join(directory, "..", "docker-compose.yml");
+  const targetPath = path4.join(directory, "docker-compose.yml");
+  await fs3.rename(sourcePath, targetPath);
+}
+
+// libs/sdk/create-app/src/index.ts
+var program = new Command();
+program.name("create-dotcms-app").description("dotCMS CLI for creating applications").version("0.1.0-beta");
+program.argument("[projectName]", "Name of the project").option("-f, --framework <framework>", "Framework to use [nextjs,astro,angular,angular-ssr]").option("-d, --directory <path>", "Project directory").option("--local", "Use local dotCMS instance using docker").option("--url <url>", "DotCMS instance url (skip in case of local)").option("-u, --username <username>", "DotCMS instance username (skip in case of local)").option("-p, --password <password>", "DotCMS instance password (skip in case of local)").option(
+  "--starter <url>",
+  "Custom starter URL for the local dotCMS Docker instance (sets CUSTOM_STARTER_URL)"
+).action(async (projectName, options) => {
+  printWelcomeScreen();
+  try {
+    const validatedFramework = validateAndNormalizeFramework(options.framework);
+    validateUrl(options.starter);
+    validateUrl(options.url);
+    validateConflictingParameters(options);
+    validateProjectName(projectName);
+    const starterOnlyMode = Boolean(options.starter);
+    const isLocalModeRequested = options.local === true || starterOnlyMode;
+    const isCloudExplicit = Boolean(options.url) && !isLocalModeRequested;
+    const projectNameFinal = projectName ?? await askProjectName();
+    const directoryInput = options.directory ?? await askDirectory();
+    const finalDirectory = await prepareDirectory(directoryInput, projectNameFinal);
+    const isCloudInstanceSelected = isLocalModeRequested ? false : isCloudExplicit || await askCloudOrLocalInstance();
+    if (isCloudInstanceSelected) {
+      const urlInput = options.url ?? await askDotcmsCloudUrl();
+      validateUrl(urlInput);
+      const urlDotcmsInstance = normalizeUrl(urlInput);
+      const healthApiURL = getDotcmsApisByBaseUrl(urlDotcmsInstance).DOTCMS_HEALTH_API;
+      const emaConfigApiURL = getDotcmsApisByBaseUrl(urlDotcmsInstance).DOTCMS_EMA_CONFIG_API;
+      const siteApiURL = getDotcmsApisByBaseUrl(urlDotcmsInstance).DOTCMS_SITE_API;
+      const tokenApiUrl = getDotcmsApisByBaseUrl(urlDotcmsInstance).DOTCMS_TOKEN_API;
+      const spinner2 = ora(`\u23F3 Connecting to dotCMS...`).start();
+      const healthCheckResult2 = await isDotcmsRunning(
+        healthApiURL,
+        CLOUD_HEALTH_CHECK_RETRIES
+      );
+      if (!healthCheckResult2.ok) {
+        spinner2.fail(
+          "dotCMS is not running on the following url " + urlDotcmsInstance + ". Please check the url and try again."
+        );
+        console.error(healthCheckResult2.val);
+        process.exit(1);
+      }
+      spinner2.succeed("Connected to dotCMS successfully");
+      let dotcmsToken2;
+      let authAttempts = 0;
+      const MAX_AUTH_ATTEMPTS = 3;
+      while (authAttempts < MAX_AUTH_ATTEMPTS) {
+        authAttempts++;
+        const userNameDotCmsInstance = options.username ?? await askUserNameForDotcmsCloud();
+        const passwordDotCmsInstance = options.password ?? await askPasswordForDotcmsCloud();
+        dotcmsToken2 = await DotCMSApi.getAuthToken({
+          payload: {
+            user: userNameDotCmsInstance,
+            password: passwordDotCmsInstance,
+            expirationDays: "30",
+            label: "token for frontend app"
+          },
+          url: tokenApiUrl
+        });
+        if (dotcmsToken2.ok) {
+          spinner2.succeed("Generated API authentication token");
+          break;
+        } else {
+          spinner2.fail("Authentication failed");
+          console.error(dotcmsToken2.val);
+          if (authAttempts < MAX_AUTH_ATTEMPTS) {
+            console.log(
+              chalk4.yellow(
+                `
+Attempt ${authAttempts}/${MAX_AUTH_ATTEMPTS} - Please try again
+`
+              )
+            );
+          } else {
+            console.log(
+              chalk4.red(
+                `
+Maximum authentication attempts (${MAX_AUTH_ATTEMPTS}) reached. Exiting.
+`
+              )
+            );
+            process.exit(1);
+          }
+        }
+      }
+      if (!dotcmsToken2 || !dotcmsToken2.ok) {
+        process.exit(1);
+      }
+      const defaultSite2 = await DotCMSApi.getDefaultSite({
+        authenticationToken: dotcmsToken2.val,
+        url: siteApiURL
+      });
+      if (!defaultSite2.ok) {
+        spinner2.fail("Failed to get default site identifier from Dotcms.");
+        process.exit(1);
+      } else {
+        spinner2.succeed(
+          `Retrieved default site (${defaultSite2.val.entity.identifier})`
+        );
+      }
+      const selectedFramework2 = validatedFramework ?? await askFramework();
+      const setUpUVE2 = await DotCMSApi.setupUVEConfig({
+        payload: {
+          configuration: {
+            hidden: false,
+            value: getUVEConfigValue(
+              `http://localhost:${getPortByFramework(selectedFramework2)}`
+            )
+          }
+        },
+        siteId: defaultSite2.val.entity.identifier,
+        authenticationToken: dotcmsToken2.val,
+        url: emaConfigApiURL
+      });
+      if (!setUpUVE2.ok) {
+        spinner2.fail("Failed to setup UVE configuration in Dotcms.");
+        process.exit(1);
+      } else {
+        spinner2.succeed(`Configured the Universal Visual Editor`);
+      }
+      await startScaffoldingFrontEnd({ spinner: spinner2, selectedFramework: selectedFramework2, finalDirectory });
+      console.log(chalk4.white(`\u2705 Project setup complete!`));
+      const relativePath2 = getDisplayPath(finalDirectory, process.cwd());
+      displayFinalSteps({
+        host: urlDotcmsInstance,
+        relativePath: relativePath2,
+        token: dotcmsToken2.val,
+        siteId: defaultSite2.val.entity.identifier,
+        selectedFramework: selectedFramework2
+      });
+      return;
+    }
+    const spinner = ora(`Checking Docker availability...`).start();
+    const dockerAvailable = await checkDockerAvailability();
+    if (!dockerAvailable.ok) {
+      spinner.fail("Docker is not available");
+      console.error(dockerAvailable.val);
+      process.exit(1);
+    }
+    spinner.succeed("Docker is available");
+    spinner.start("Checking port availability...");
+    const portsAvailable = await checkPortsAvailability();
+    if (!portsAvailable.ok) {
+      spinner.fail("Required ports are busy");
+      console.error(portsAvailable.val);
+      process.exit(1);
+    }
+    spinner.succeed("All required ports are available");
+    spinner.start("Downloading Docker Compose configuration...");
+    const downloaded = await downloadTheDockerCompose({
+      directory: finalDirectory
+    });
+    if (!downloaded.ok) {
+      spinner.fail("Failed to download Docker Compose file.");
+      process.exit(1);
+    }
+    spinner.succeed("Docker Compose configuration downloaded");
+    spinner.start("Starting dotCMS containers...");
+    const ran = await runDockerCompose({
+      directory: finalDirectory,
+      starterUrl: options.starter
+    });
+    if (!ran.ok) {
+      spinner.fail("Failed to start Docker containers");
+      const errorMessage = ran.val instanceof Error ? ran.val.message : String(ran.val);
+      console.error(
+        chalk4.red("\n\u274C Docker Compose failed to start\n\n") + chalk4.white("Error details:\n") + chalk4.gray(errorMessage) + "\n\n" + chalk4.yellow("Common solutions:\n") + chalk4.white("  \u2022 Ensure Docker Desktop is running\n") + chalk4.white("  \u2022 Try: ") + chalk4.cyan("docker compose down") + chalk4.white(" then run this command again\n") + chalk4.white("  \u2022 Check Docker logs for more details\n")
+      );
+      process.exit(1);
+    }
+    spinner.succeed("dotCMS containers started successfully.");
+    spinner.start("Verifying if dotCMS is running...");
+    const healthCheckResult = await isDotcmsRunning(
+      DOTCMS_HEALTH_API,
+      LOCAL_HEALTH_CHECK_RETRIES
+    );
+    if (!healthCheckResult.ok) {
+      spinner.fail("dotCMS failed to start properly");
+      console.error(healthCheckResult.val);
+      console.error(await getDockerDiagnostics(finalDirectory));
+      process.exit(1);
+    }
+    spinner.succeed("dotCMS is running locally at http://localhost:8082");
+    spinner.succeed("Default credentials: admin@dotcms.com / admin");
+    if (starterOnlyMode) {
+      console.log(chalk4.white(`\u2705 Project setup complete!`));
+      console.log(
+        chalk4.gray(
+          "Skipped frontend scaffolding and dotCMS UVE setup because --starter was provided."
+        )
+      );
+      return;
+    }
+    const selectedFramework = validatedFramework ?? await askFramework();
+    const dotcmsToken = await DotCMSApi.getAuthToken({
+      payload: {
+        user: DOTCMS_USER.username,
+        password: DOTCMS_USER.password,
+        expirationDays: "30",
+        label: "token for frontend app"
+      }
+    });
+    if (!dotcmsToken.ok) {
+      spinner.fail("Failed to get authentication token from Dotcms.");
+      process.exit(1);
+    } else {
+      spinner.succeed("Generated API authentication token");
+    }
+    const defaultSite = await DotCMSApi.getDefaultSite({
+      authenticationToken: dotcmsToken.val
+    });
+    if (!defaultSite.ok) {
+      spinner.fail("Failed to get default site identifier from Dotcms.");
+      process.exit(1);
+    } else {
+      spinner.succeed(`Retrieved default site (${defaultSite.val.entity.identifier})`);
+    }
+    const setUpUVE = await DotCMSApi.setupUVEConfig({
+      payload: {
+        configuration: {
+          hidden: false,
+          value: getUVEConfigValue(
+            `http://localhost:${getPortByFramework(selectedFramework)}`
+          )
+        }
+      },
+      siteId: defaultSite.val.entity.identifier,
+      authenticationToken: dotcmsToken.val
+    });
+    if (!setUpUVE.ok) {
+      spinner.fail("Failed to setup UVE configuration in Dotcms.");
+      process.exit(1);
+    } else {
+      spinner.succeed(`Configured the Universal Visual Editor`);
+    }
+    moveDockerComposeOneLevelUp(finalDirectory);
+    await startScaffoldingFrontEnd({ spinner, selectedFramework, finalDirectory });
+    moveDockerComposeBack(finalDirectory);
+    console.log(chalk4.white(`\u2705 Project setup complete!`));
+    const relativePath = getDisplayPath(finalDirectory, process.cwd());
+    displayFinalSteps({
+      host: "http://localhost:8082",
+      relativePath,
+      token: dotcmsToken.val,
+      siteId: defaultSite.val.entity.identifier,
+      selectedFramework
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error(error.message);
+      if (process.env.DEBUG) {
+        console.error("\n" + chalk4.gray("Stack trace:"));
+        console.error(chalk4.gray(error.stack || "No stack trace available"));
+      }
+    } else {
+      console.error(chalk4.red("\u274C An unexpected error occurred"));
+      console.error(String(error));
+    }
+    process.exit(1);
+  }
+});
+async function createApp() {
+  program.parse();
+}
+async function scaffoldFrontendProject({
+  framework,
+  directory
+}) {
+  try {
+    await cloneFrontEndSample({ directory, framework });
+    return Ok(void 0);
+  } catch (err) {
+    console.log(
+      chalk4.red(
+        `\u274C Failed to create ${framework} project. Please check git installation and network connection.` + JSON.stringify(err)
+      )
+    );
+    return Err(new FailedToCreateFrontendProjectError(framework));
+  }
+}
+async function downloadTheDockerCompose({
+  directory
+}) {
+  try {
+    await downloadDockerCompose(directory);
+    return Ok(void 0);
+  } catch (err) {
+    console.log(chalk4.red("\u274C Failed to download docker-compose.yml." + JSON.stringify(err)));
+    return Err(new FailedToDownloadDockerComposeError());
+  }
+}
+async function runDockerCompose({
+  directory,
+  starterUrl
+}) {
+  try {
+    if (starterUrl) {
+      await updateDockerComposeStarterUrl({ directory, starterUrl });
+    }
+    const env = starterUrl ? { ...process.env, CUSTOM_STARTER_URL: starterUrl } : process.env;
+    await execa3("docker", ["compose", "up", "-d"], { cwd: directory, env });
+    await execa3("docker", ["ps"], { cwd: directory });
+    return Ok(void 0);
+  } catch (err) {
+    return Err(err);
+  }
+}
+async function updateDockerComposeStarterUrl({
+  directory,
+  starterUrl
+}) {
+  const composePath = path5.join(directory, "docker-compose.yml");
+  const composeContents = await fs4.readFile(composePath, "utf-8");
+  const updatedContents = composeContents.replace(
+    /^(\s*["']?CUSTOM_STARTER_URL["']?\s*:\s*).+$/m,
+    `$1"${starterUrl}"`
+  );
+  if (updatedContents === composeContents) {
+    throw new Error(
+      "CUSTOM_STARTER_URL entry not found in docker-compose.yml. Unable to apply --starter value."
+    );
+  }
+  await fs4.writeFile(composePath, updatedContents);
+}
+async function isDotcmsRunning(url, retries = 60) {
+  try {
+    const res = await fetchWithRetry(url ?? DOTCMS_HEALTH_API, retries, 5e3);
+    if (res && res.status === 200) {
+      return Ok(true);
+    }
+    return Err("dotCMS health check returned non-200 status");
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return Err(errorMessage);
+  }
+}
+function displayFinalSteps({
+  selectedFramework,
+  relativePath,
+  token,
+  siteId,
+  host
+}) {
+  switch (selectedFramework) {
+    case "nextjs": {
+      finalStepsForNextjs({
+        projectPath: relativePath,
+        token,
+        siteId,
+        urlDotCMSInstance: host
+      });
+      break;
+    }
+    case "angular": {
+      finalStepsForAngularAndAngularSSR({
+        projectPath: relativePath,
+        token,
+        siteId,
+        urlDotCMSInstance: host
+      });
+      break;
+    }
+    case "angular-ssr": {
+      finalStepsForAngularAndAngularSSR({
+        projectPath: relativePath,
+        token,
+        siteId,
+        urlDotCMSInstance: host
+      });
+      break;
+    }
+    case "astro": {
+      finalStepsForAstro({
+        projectPath: relativePath,
+        token,
+        siteId,
+        urlDotCMSInstance: host
+      });
+      break;
+    }
+  }
+}
+async function startScaffoldingFrontEnd({
+  spinner,
+  selectedFramework,
+  finalDirectory
+}) {
+  spinner.start(`\u23F3 Scaffolding ${selectedFramework} project...`);
+  const created = await scaffoldFrontendProject({
+    framework: selectedFramework,
+    directory: finalDirectory
+  });
+  if (!created.ok) {
+    spinner.fail(`Failed to scaffold frontend project (${selectedFramework}).`);
+    process.exit(1);
+  }
+  spinner.succeed(`Frontend project (${selectedFramework}) scaffolded successfully.`);
+  spinner.start(
+    `\u{1F4E6} Installing dependencies...
+
+ ${displayDependencies(selectedFramework)}`
+  );
+  const result = await installDependenciesForProject(finalDirectory);
+  if (!result) {
+    spinner.fail(
+      `Failed to install dependencies. Please check if npm is installed in your system`
+    );
+    process.exit(1);
+  } else {
+    spinner.succeed(`Dependencies installed`);
+  }
+  console.log("\n\n");
+  spinner.stop();
+}
+function printWelcomeScreen() {
+  cfonts.say("DOTCMS", {
+    font: "block",
+    // define the font face
+    align: "left",
+    // define text alignment
+    colors: ["system"],
+    // define all colors
+    background: "transparent",
+    // define the background color, you can also use `backgroundColor` here as key
+    letterSpacing: 1,
+    // define letter spacing
+    lineHeight: 1,
+    // define the line height
+    space: true,
+    // define if the output text should have empty lines on top and on the bottom
+    maxLength: "0",
+    // define how many character can be on one line
+    gradient: false,
+    // define your two gradient colors
+    independentGradient: false,
+    // define if you want to recalculate the gradient for each new line
+    transitionGradient: false,
+    // define if this is a transition between colors directly
+    rawMode: false,
+    // define if the line breaks should be CRLF (`\r\n`) over the default LF (`\n`)
+    env: "node"
+    // define the environment cfonts is being executed in
+  });
+  console.log(chalk4.white("\nWelcome to dotCMS CLI"));
+  console.log(chalk4.bgGrey.white("\n \u2139\uFE0F  Beta: Features may change \n"));
+}
+createApp();
+export {
+  createApp
+};