create-tina-app 2.1.5 → 2.1.7

package/dist/index.js

@@ -9,6 +9,19 @@ import path from "path";
 
 // src/util/textstyles.ts
 import chalk from "chalk";
+var stripAnsi = (str) => str.replace(/\]8;;[^]*/g, "").replace(/\[[0-9;]*m/g, "");
+var box = (lines, color = chalk.hex("#EC4816")) => {
+  const pad = 1;
+  const width = Math.max(...lines.map((l) => stripAnsi(l).length));
+  const rule = color("\u2500".repeat(width + pad * 2));
+  const top = `${color("\u250C")}${rule}${color("\u2510")}`;
+  const bottom = `${color("\u2514")}${rule}${color("\u2518")}`;
+  const body = lines.map((line) => {
+    const trailing = " ".repeat(width - stripAnsi(line).length);
+    return `${color("\u2502")}${" ".repeat(pad)}${line}${trailing}${" ".repeat(pad)}${color("\u2502")}`;
+  });
+  return [top, ...body, bottom].join("\n");
+};
 var TextStyles = {
   tinaOrange: chalk.hex("#EC4816"),
   link: (url) => `\x1B]8;;${url}\x07${chalk.cyan.underline(url)}\x1B]8;;\x07`,
@@ -143,18 +156,36 @@ async function updateTelemetryConfig(dir, mode) {
 
 // src/util/install.ts
 import spawn from "cross-spawn";
+var MAX_OUTPUT_CHARS = 4e3;
 function install(packageManager, verboseOutput) {
+  const command = `${packageManager} install`;
   return new Promise((resolve, reject) => {
     const child = spawn(packageManager, ["install"], {
-      stdio: verboseOutput ? "inherit" : "ignore",
+      stdio: verboseOutput ? "inherit" : ["ignore", "ignore", "pipe"],
       env: { ...process.env, ADBLOCK: "1", DISABLE_OPENCOLLECTIVE: "1" }
     });
+    let captured = "";
+    child.stderr?.on("data", (chunk) => {
+      captured = (captured + chunk.toString()).slice(-MAX_OUTPUT_CHARS);
+    });
+    child.on("error", (err) => {
+      reject(
+        new Error(`Failed to run "${command}": ${err.message}`)
+      );
+    });
     child.on("close", (code) => {
-      if (code !== 0) {
-        reject({ command: `${packageManager} install` });
+      if (code === 0) {
+        resolve();
         return;
       }
-      resolve();
+      const details = captured.trim();
+      let message = `"${command}" exited with code ${code ?? "unknown"}.`;
+      if (details) {
+        message += `
+
+${details}`;
+      }
+      reject(new Error(message));
     });
   });
 }
@@ -422,18 +453,31 @@ async function downloadTemplate(template, root, spinner) {
 }
 
 // src/util/preRunChecks.ts
-var SUPPORTED_NODE_VERSION_BOUNDS = { oldest: 20, latest: 22 };
-var SUPPORTED_NODE_VERSION_RANGE = [
-  ...Array(SUPPORTED_NODE_VERSION_BOUNDS.latest).keys()
-].map((i) => i + SUPPORTED_NODE_VERSION_BOUNDS.oldest);
-var isSupported = SUPPORTED_NODE_VERSION_RANGE.some(
-  (version2) => process.version.startsWith(`v${version2}`)
-);
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function getSupportedMajors() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  try {
+    const { engines } = JSON.parse(
+      readFileSync(join(here, "../package.json"), "utf8")
+    );
+    return [...String(engines?.node ?? "").matchAll(/(\d+)\.x/g)].map(
+      (m) => Number(m[1])
+    );
+  } catch {
+    return [];
+  }
+}
 function preRunChecks(spinner) {
   spinner.start("Running pre-run checks...");
+  const supported = getSupportedMajors();
+  const currentMajor = Number(process.versions.node.split(".")[0]);
+  const isSupported = supported.includes(currentMajor);
   if (!isSupported) {
+    const range = supported.length ? supported.map((v) => `v${v}`).join(" or ") : "a supported LTS version";
     spinner.warn(
-      `Node ${process.version} is not supported by create-tina-app. Please update to be within v${SUPPORTED_NODE_VERSION_BOUNDS.oldest}-v${SUPPORTED_NODE_VERSION_BOUNDS.latest}. See https://nodejs.org/en/download/ for more details.`
+      `Node ${process.version} is not supported by create-tina-app. Please use ${range}. See https://nodejs.org/en/download/ for more details.`
     );
   } else {
     spinner.succeed(`Node ${process.version} is supported.`);
@@ -466,7 +510,7 @@ import { Command } from "commander";
 
 // package.json
 var name = "create-tina-app";
-var version = "2.1.5";
+var version = "2.1.7";
 
 // src/util/packageManagers.ts
 var PKG_MANAGERS = ["npm", "yarn", "pnpm", "bun"];
@@ -689,6 +733,7 @@ var ERROR_CODES = {
   ERR_VAL_INVALID_TEMPLATE: "ERR_VAL_INVALID_TEMPLATE",
   ERR_VAL_INVALID_PKG_MANAGER: "ERR_VAL_INVALID_PKG_MANAGER",
   ERR_VAL_INVALID_PROJECT_NAME: "ERR_VAL_INVALID_PROJECT_NAME",
+  ERR_VAL_INVALID_THEME: "ERR_VAL_INVALID_THEME",
   ERR_VAL_UNSUPPORTED_NODE: "ERR_VAL_UNSUPPORTED_NODE",
   ERR_VAL_NO_PKG_MANAGERS: "ERR_VAL_NO_PKG_MANAGERS",
   // File System Errors (FS_*)
@@ -879,6 +924,8 @@ async function fetchPostHogConfig(endpointUrl) {
 
 // src/index.ts
 import { osInfo as getOsSystemInfo } from "systeminformation";
+var DISCORD_SUPPORT_URL = "https://discord.com/invite/zumN63Ybpf";
+var FAQ_URL = "https://tina.io/docs/faq";
 var posthogClient = null;
 async function initializePostHog(configEndpoint, disableGeoip) {
   let apiKey;
@@ -963,6 +1010,18 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
   }
   const spinner = ora();
   preRunChecks(spinner);
+  const fatalExit = async (message, error, context) => {
+    spinner.fail(
+      `${message}
+
+Need more help? Reach out to the TinaCMS community at ${TextStyles.link(
+        DISCORD_SUPPORT_URL
+      )}`
+    );
+    postHogCaptureError(posthogClient, userId, sessionId, error, context);
+    if (posthogClient) await posthogClient.shutdown();
+    exit(1);
+  };
   postHogCapture(
     posthogClient,
     userId,
@@ -974,15 +1033,10 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
   if (opts.template) {
     template = TEMPLATES.find((_template) => _template.value === opts.template);
     if (!template) {
-      spinner.fail(
+      await fatalExit(
         `The provided template '${opts.template}' is invalid. Please provide one of the following: ${TEMPLATES.map(
           (x2) => x2.value
-        )}`
-      );
-      postHogCaptureError(
-        posthogClient,
-        userId,
-        sessionId,
+        )}`,
         new Error(`Invalid template: ${opts.template}`),
         {
           errorCode: ERROR_CODES.ERR_VAL_INVALID_TEMPLATE,
@@ -992,17 +1046,13 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
           additionalProperties: { ...telemetryData }
         }
       );
-      if (posthogClient) await posthogClient.shutdown();
-      exit(1);
     }
   }
   let pkgManager = opts.pkgManager;
   if (pkgManager) {
     if (!PKG_MANAGERS.find((_pkgManager) => _pkgManager === pkgManager)) {
-      postHogCaptureError(
-        posthogClient,
-        userId,
-        sessionId,
+      await fatalExit(
+        `The provided package manager '${opts.pkgManager}' is not supported. Please provide one of the following: ${PKG_MANAGERS}`,
         new Error(`Invalid package manager: ${opts.pkgManager}`),
         {
           errorCode: ERROR_CODES.ERR_VAL_INVALID_PKG_MANAGER,
@@ -1012,22 +1062,12 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
           additionalProperties: { ...telemetryData }
         }
       );
-      if (posthogClient) await posthogClient.shutdown();
-      spinner.fail(
-        `The provided package manager '${opts.pkgManager}' is not supported. Please provide one of the following: ${PKG_MANAGERS}`
-      );
-      exit(1);
     }
   }
   if (!pkgManager) {
     if (installedPkgManagers.length === 0) {
-      spinner.fail(
-        `You have no supported package managers installed. Please install one of the following: ${PKG_MANAGERS}`
-      );
-      postHogCaptureError(
-        posthogClient,
-        userId,
-        sessionId,
+      await fatalExit(
+        `You have no supported package managers installed. Please install one of the following: ${PKG_MANAGERS}`,
         new Error("No supported package managers installed"),
         {
           errorCode: ERROR_CODES.ERR_VAL_NO_PKG_MANAGERS,
@@ -1037,8 +1077,6 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
           additionalProperties: telemetryData
         }
       );
-      if (posthogClient) await posthogClient.shutdown();
-      exit(1);
     }
     const res = await prompts({
       message: "Which package manager would you like to use?",
@@ -1134,10 +1172,20 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
     if (opts.theme) {
       const validThemes = THEMES.map((t) => t.value);
       if (!validThemes.includes(opts.theme)) {
-        console.error(
-          `Invalid theme "${opts.theme}". Valid options are: ${validThemes.join(", ")}`
+        await fatalExit(
+          `Invalid theme "${opts.theme}". Valid options are: ${validThemes.join(", ")}`,
+          new Error(`Invalid theme: ${opts.theme}`),
+          {
+            errorCode: ERROR_CODES.ERR_VAL_INVALID_THEME,
+            errorCategory: "validation",
+            step: TRACKING_STEPS.THEME_SELECT,
+            fatal: true,
+            additionalProperties: {
+              ...telemetryData,
+              template: template.value
+            }
+          }
         );
-        exit(1);
       }
       themeChoice = opts.theme;
     } else {
@@ -1172,13 +1220,8 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
   }
   const rootDir = path3.join(process.cwd(), projectName);
   if (!await isWriteable(path3.dirname(rootDir))) {
-    spinner.fail(
-      "The application path is not writable, please check folder permissions and try again. It is likely you do not have write permissions for this folder."
-    );
-    postHogCaptureError(
-      posthogClient,
-      userId,
-      sessionId,
+    await fatalExit(
+      "The application path is not writable, please check folder permissions and try again. It is likely you do not have write permissions for this folder.",
       new Error("Directory not writable"),
       {
         errorCode: ERROR_CODES.ERR_FS_NOT_WRITABLE,
@@ -1188,8 +1231,6 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
         additionalProperties: { ...telemetryData }
       }
     );
-    if (posthogClient) await posthogClient.shutdown();
-    process.exit(1);
   }
   let appName;
   try {
@@ -1197,16 +1238,13 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
     telemetryData["app-name"] = appName;
   } catch (err) {
     const error = err;
-    spinner.fail(error.message);
-    postHogCaptureError(posthogClient, userId, sessionId, error, {
+    await fatalExit(error.message, error, {
       errorCode: ERROR_CODES.ERR_FS_MKDIR_FAILED,
       errorCategory: "filesystem",
       step: TRACKING_STEPS.DIRECTORY_SETUP,
       fatal: true,
       additionalProperties: { ...telemetryData }
     });
-    if (posthogClient) await posthogClient.shutdown();
-    exit(1);
   }
   try {
     if (themeChoice) {
@@ -1225,24 +1263,30 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
     spinner.succeed();
   } catch (err) {
     const error = err;
-    spinner.fail(`Failed to download template: ${error.message}`);
-    postHogCaptureError(posthogClient, userId, sessionId, error, {
+    await fatalExit(`Failed to download template: ${error.message}`, error, {
       errorCode: ERROR_CODES.ERR_TPL_DOWNLOAD_FAILED,
       errorCategory: "template",
       step: TRACKING_STEPS.DOWNLOADING_TEMPLATE,
       fatal: true,
       additionalProperties: { ...telemetryData }
     });
-    if (posthogClient) await posthogClient.shutdown();
-    exit(1);
   }
   spinner.start("Installing packages.");
   try {
     await install(pkgManager, opts.verbose);
     spinner.succeed();
   } catch (err) {
-    const error = err;
-    spinner.fail(`Failed to install packages: ${error.message}`);
+    const error = err instanceof Error ? err : new Error(String(err));
+    const reason = error.message || String(err);
+    spinner.fail(`Failed to install packages: ${reason}`);
+    console.log(
+      `
+${box([
+        `${TextStyles.bold("Stuck?")} Check the TinaCMS FAQ for common install issues:`,
+        TextStyles.link(FAQ_URL)
+      ])}
+`
+    );
     packageManagerInstallationHadError = true;
     postHogCaptureError(posthogClient, userId, sessionId, error, {
       errorCode: ERROR_CODES.ERR_INSTALL_PKG_MANAGER_FAILED,
@@ -1317,12 +1361,21 @@ ${TextStylesBold.bold("Telemetry Notice")}`);
       "https://tina.io/docs/r/what-is-tinacloud"
     )}`
   );
+  console.log(
+    `  \u2022 \u{1F4AC} Reach out for support: ${TextStyles.link(DISCORD_SUPPORT_URL)}`
+  );
 }
 run().catch(async (error) => {
   if (process.stdout.columns >= 60) {
     console.log(TextStyles.tinaOrange(`${errorArt}`));
   }
   console.error("Error running create-tina-app:", error);
+  console.error(
+    `
+\u{1F4AC} Need more help? Reach out to the TinaCMS community at ${TextStyles.link(
+      DISCORD_SUPPORT_URL
+    )}`
+  );
   const sessionId = generateSessionId();
   const userId = await getAnonymousUserId();
   postHogCaptureError(posthogClient, userId, sessionId, error, {

package/dist/util/install.d.ts

@@ -3,5 +3,7 @@ import { PackageManager } from './packageManagers';
  * Spawn a package manager installation.
  *
  * @returns A Promise that resolves once the installation is finished.
+ *   On failure it rejects with an `Error` whose message includes the command,
+ *   the exit code, and the tail of the captured output.
  */
 export declare function install(packageManager: PackageManager, verboseOutput: boolean): Promise<void>;

package/dist/util/posthog.d.ts

@@ -35,6 +35,7 @@ export declare const ERROR_CODES: {
     readonly ERR_VAL_INVALID_TEMPLATE: "ERR_VAL_INVALID_TEMPLATE";
     readonly ERR_VAL_INVALID_PKG_MANAGER: "ERR_VAL_INVALID_PKG_MANAGER";
     readonly ERR_VAL_INVALID_PROJECT_NAME: "ERR_VAL_INVALID_PROJECT_NAME";
+    readonly ERR_VAL_INVALID_THEME: "ERR_VAL_INVALID_THEME";
     readonly ERR_VAL_UNSUPPORTED_NODE: "ERR_VAL_UNSUPPORTED_NODE";
     readonly ERR_VAL_NO_PKG_MANAGERS: "ERR_VAL_NO_PKG_MANAGERS";
     readonly ERR_FS_NOT_WRITABLE: "ERR_FS_NOT_WRITABLE";

package/dist/util/textstyles.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Draw a bordered box around one or more lines so a message stands out from the
+ * surrounding log output.
+ */
+export declare const box: (lines: string[], color?: (s: string) => string) => string;
 export declare const TextStyles: {
     tinaOrange: import("chalk").ChalkInstance;
     link: (url: string) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tina-app",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "type": "module",
   "main": "dist/index.js",
   "files": [
@@ -20,7 +20,7 @@
     ]
   },
   "engines": {
-    "node": ">=18.18.0"
+    "node": "22.x || 24.x"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"