create-tina-app 2.0.0 → 2.1.0

package/dist/index.js

@@ -1,7 +1,6 @@
 // src/index.ts
-import { Telemetry } from "@tinacms/metrics";
 import prompts from "prompts";
-import path4 from "node:path";
+import path3 from "node:path";
 import { createRequire } from "node:module";
 
 // src/util/fileUtil.ts
@@ -20,6 +19,16 @@ var TextStyles = {
   err: chalk.red,
   bold: chalk.bold
 };
+var TextStylesBold = {
+  tinaOrange: chalk.hex("#EC4816").bold,
+  link: (url) => `\x1B]8;;${url}\x07${chalk.cyan.underline(url)}\x1B]8;;\x07`,
+  cmd: chalk.bgBlackBright.bold.white,
+  info: chalk.blue,
+  success: chalk.green,
+  warn: chalk.yellow,
+  err: chalk.red,
+  bold: chalk.bold
+};
 
 // src/util/fileUtil.ts
 async function isWriteable(directory) {
@@ -125,7 +134,6 @@ function install(packageManager, verboseOutput) {
 
 // src/util/git.ts
 import { execSync } from "child_process";
-import path2 from "path";
 import fs2 from "fs-extra";
 function isInGitRepository() {
   try {
@@ -144,16 +152,11 @@ function isInMercurialRepository() {
   return false;
 }
 function makeFirstCommit(root) {
-  try {
-    execSync("git checkout -b main", { stdio: "ignore" });
-    execSync("git add -A", { stdio: "ignore" });
-    execSync('git commit -m "Initial commit from Create Tina App"', {
-      stdio: "ignore"
-    });
-  } catch (err) {
-    fs2.removeSync(path2.join(root, ".git"));
-    throw err;
-  }
+  execSync("git checkout -b main", { stdio: "ignore" });
+  execSync("git add -A", { stdio: "ignore" });
+  execSync('git commit -m "Initial commit from Create Tina App"', {
+    stdio: "ignore"
+  });
 }
 function initializeGit(spinner) {
   execSync("git --version", { stdio: "ignore" });
@@ -236,13 +239,27 @@ async function downloadAndExtractRepo(root, { username, name: name2, branch, fil
 
 // src/templates.ts
 import { copy } from "fs-extra";
-import path3 from "path";
+import path2 from "path";
 var TEMPLATES = [
   {
     title: "\u2B50 NextJS starter",
     description: "Kickstart your project with Next.js \u2013 our top recommendation for a seamless, performant, and versatile web experience.",
     value: "tina-nextjs-starter",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u2705"
+      },
+      {
+        name: "ISR",
+        description: "\u2705"
+      },
+      {
+        name: "SSG",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-nextjs-starter",
     devUrl: "http://localhost:3000"
   },
@@ -251,6 +268,20 @@ var TEMPLATES = [
     description: "Get your documentation site up and running with TinaCMS and Next.js in minutes.",
     value: "tina-docs",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u2705"
+      },
+      {
+        name: "ISR",
+        description: "\u2705"
+      },
+      {
+        name: "SSG",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-docs",
     devUrl: "http://localhost:3000"
   },
@@ -259,6 +290,20 @@ var TEMPLATES = [
     description: "Get started with Astro - a modern static site generator designed for fast, lightweight, and flexible web projects.",
     value: "tina-astro-starter",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u274C"
+      },
+      {
+        name: "ISR",
+        description: "\u274C"
+      },
+      {
+        name: "SSG",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-astro-starter",
     devUrl: "http://localhost:4321"
   },
@@ -267,6 +312,20 @@ var TEMPLATES = [
     description: "With Hugo, you wield the power of lightning-fast site generation, crafting web experiences at the speed of thought.",
     value: "tina-hugo-starter",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u274C"
+      },
+      {
+        name: "ISR",
+        description: "\u274C"
+      },
+      {
+        name: "SSG",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-hugo-starter",
     devUrl: "http://localhost:1313"
   },
@@ -275,6 +334,20 @@ var TEMPLATES = [
     description: "Dive into Remix to orchestrate seamless, interactive user journeys like a maestro of the web.",
     value: "tina-remix-starter",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u274C"
+      },
+      {
+        name: "ISR",
+        description: "\u274C"
+      },
+      {
+        name: "SSG",
+        description: "\u26A0\uFE0F Requires adapter"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-remix-starter",
     devUrl: "http://localhost:3000"
   },
@@ -283,14 +356,42 @@ var TEMPLATES = [
     description: "Docusaurus empowers you to build and evolve documentation like crafting a living, breathing knowledge repository.",
     value: "tinasaurus",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u274C"
+      },
+      {
+        name: "ISR",
+        description: "\u274C"
+      },
+      {
+        name: "SSR",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tinasaurus",
     devUrl: "http://localhost:3000"
   },
   {
     title: "Bare bones starter",
-    description: "Stripped down to essentials, this starter is the canvas for pure, unadulterated code creativity.",
+    description: "Stripped down to essentials, this starter is the canvas for pure, unadulterated code creativity. Built with Next.js.",
     value: "basic",
     isInternal: false,
+    features: [
+      {
+        name: "Visual Editing",
+        description: "\u2705"
+      },
+      {
+        name: "ISR",
+        description: "\u2705"
+      },
+      {
+        name: "SSG",
+        description: "\u2705"
+      }
+    ],
     gitURL: "https://github.com/tinacms/tina-barebones-starter",
     devUrl: "http://localhost:3000"
   }
@@ -307,7 +408,7 @@ async function downloadTemplate(template, root, spinner) {
     )}`;
     await downloadAndExtractRepo(root, repoInfo);
   } else {
-    const templateFile = path3.join(__dirname, "..", "examples", template.value);
+    const templateFile = path2.join(__dirname, "..", "examples", template.value);
     await copy(`${templateFile}/`, "./");
   }
 }
@@ -357,7 +458,7 @@ import { Command } from "commander";
 
 // package.json
 var name = "create-tina-app";
-var version = "2.0.0";
+var version = "2.1.0";
 
 // src/util/packageManagers.ts
 var PKG_MANAGERS = ["npm", "yarn", "pnpm", "bun"];
@@ -391,11 +492,111 @@ function extractOptions(args) {
   return opts;
 }
 
-// src/index.ts
-import validate from "validate-npm-package-name";
+// src/util/isNpm.js
+import { builtinModules as builtins } from "node:module";
+function validate(name2) {
+  if (name2 === null) {
+    return {
+      message: "name cannot be null",
+      isError: true
+    };
+  }
+  if (name2 === void 0) {
+    return {
+      message: "name cannot be undefined",
+      isError: true
+    };
+  }
+  if (typeof name2 !== "string") {
+    return {
+      message: "name must be a string",
+      isError: true
+    };
+  }
+  if (!name2.length) {
+    return {
+      message: "name length must be greater than zero",
+      isError: true
+    };
+  }
+  if (name2.startsWith(".")) {
+    return {
+      message: "name cannot start with a period",
+      isError: true
+    };
+  }
+  if (name2.match(/^_/)) {
+    return {
+      message: "name cannot start with an underscore",
+      isError: true
+    };
+  }
+  if (name2.trim() !== name2) {
+    return {
+      message: "name cannot contain leading or trailing spaces",
+      isError: true
+    };
+  }
+  const exclusionList = ["node_modules", "favicon.ico"];
+  exclusionList.forEach(function(excludedName) {
+    if (name2.toLowerCase() === excludedName) {
+      return {
+        message: excludedName + " is not a valid package name",
+        isError: true
+      };
+    }
+  });
+  if (builtins.includes(name2.toLowerCase())) {
+    return {
+      message: name2 + " is a core module name",
+      isError: true
+    };
+  }
+  if (name2.length > 214) {
+    return {
+      message: "name can no longer contain more than 214 characters",
+      isError: true
+    };
+  }
+  if (name2.toLowerCase() !== name2) {
+    return {
+      message: "name can no longer contain capital letters",
+      isError: true
+    };
+  }
+  if (/[~'!()*]/.test(name2.split("/").slice(-1)[0])) {
+    return {
+      message: `name can no longer contain special characters ("~'!()*")`,
+      isError: true
+    };
+  }
+  if (encodeURIComponent(name2) !== name2) {
+    const scopedPackagePattern = new RegExp("^(?:@([^/]+?)[/])?([^/]+?)$");
+    const nameMatch = name2.match(scopedPackagePattern);
+    if (nameMatch) {
+      const user = nameMatch[1];
+      const pkg = nameMatch[2];
+      if (pkg.startsWith(".")) {
+        return {
+          message: "name cannot start with a period",
+          isError: true
+        };
+      }
+      if (encodeURIComponent(user) === user && encodeURIComponent(pkg) === pkg) {
+        return { message: null, isError: false };
+      }
+    }
+    return {
+      message: "name can only contain URL-friendly characters",
+      isError: true
+    };
+  }
+  return { message: null, isError: false };
+}
 
 // src/util/asciiArt.ts
 var llama = "                                                  :--=:     \n                                                :-===-      \n                                               -=====-      \n                                              -=======.     \n                                             .=========-.   \n                                             :===========--:\n                                             -=============.\n                                            .==========-:.  \n                                            :=========-.    \n                                            -=========-     \n                                           .==========-     \n                                           -==========-     \n                                          :===========-     \n                                         -=============.    \n                                        :==============:    \n                                       :===============-    \n                                    .:-================-    \n                             ..::---====================    \n       ....::::::::::-------============================.   \n   .---=================================================:   \n .-=====================================================-   \n:=======================================================.   \n .-====================================================.    \n   .-=================================================.     \n     :=============================================-        \n     -============================================.         \n    .============-:.                 -==========-           \n    :=========-:  ..                 -==========.           \n    -========:  :-=-                 -=========-            \n   .========. .-====                 :=========:            \n   -=======:  :=====.                 -========:            \n   -======-    -====-                  -=======:            \n    -=====:     -====:                   :======.           \n    .=====.      -====.                   .-====-           \n     :====        -===-                     -====:          \n      -==-         :===-                     :====.         ";
+var errorArt = "                                           ++++++++++++++\u2260                                          \n                                   +++++++++\u2248          \u03C0+++++++++\u2260                                  \n                               ++++                              ++++                               \n                            +++                                      +++\u2248                           \n                         +++                                            +++                         \n                       \u03C0++                                                +++                        \n                      ++                                                    ++                       \n                     +-                                                       +\u03C0                     \n                   ++\xD7        +++++++++      \u2260+++++++++    \u221A+++++++++          ++                    \n                   +          ++     \u2248+++        ++         ++     ++++         +\u221E                   \n                  ++          ++       ++        ++         ++       ++          +                    \n                 ++           ++       ++        ++         ++       ++          ++                  \n                 ++           ++-+++++++-        ++         ++ +++++++-           +                   \n                \u221A+            ++\xF7+++++           ++         ++++++++              ++                 \n                ++            ++    \u221E++          ++         ++                    ++                 \n                ++            ++     +++         ++         ++                    ++                 \n                ++            ++      +++    \u2260+++++++++     ++                    \u2260+                \n                ++            ++        ++    +\u2260\u221E\u221A\u221A\u2260\xD7+\u03C0     ++                    \u2260+                \n                ++                                                                \u2260+                 \n                ++                                                                \u2260+                 \n                ++                                           +++                  \u2260+                 \n                ++                                          ++++                  \u2260+                 \n                ++                                          ++++++++              \u2260+                 \n                ++                                         ++++++++++             =+                 \n                ++                                         ++++++                 =+                 \n                ++                                        \u2248++++++                 =+                 \n                ++                                        +++++++                 \u2260+                 \n                ++                                        +++++++                 \u2260+                 \n                ++                                        +++++++                 =+                 \n                ++                                       ++++++++                 =+                 \n                ++                                  \u221E++++++++++++                 \u2260+                 \n                ++                \u221E++++++++++++++++++++++++++++++-                =+                 \n                ++              +++++++++++++++++++++++++++++++++                 \u2260+                 \n                ++              +++++++++++++++++++++++++++++++++                 \u2260+                 \n                ++                ++++++++++++++++++++++++++++++                  \u2260+                 \n                ++                +++++++++++++++++++++++++++++                   \u2260+                 \n                ++                ++++++++++++++++++++++++++++                    \u2260+                 \n                ++                ++++++++\u2260\u2260++++++=\u221A ++++++++                     \u2260+                 \n                ++               ++++++   +          +++++++                      \u2260+                 \n                ++               +++++ \u221E+++          \xF7++++++                      \u2260+                 \n                ++               ++++   +++           +++++\u221A                      \u2260+                 \n                ++               +++=   +++\u221A           ++++                       \u2260+                 \n                ++                ++\u221E    =++            +++                       \u2260+                 \n                ++                ++\u2248     +++            ++\xF7                      =+                 \n                ++                 +++     +++\u2260           +++                     =+                 \n                ++                                                                \u2260+                 \n                ++                                                                 +                 \n       \u2248+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++       \n       ++                                                                                  +\u2260        \n       ++              +++++++++  ++++++++    +++++++     ++++++    ++++++++               +\u2260        \n       ++              ++         ++     ++   +      ++  ++    ++   ++     ++              +\u2260        \n       ++              ++         ++     ++   +      ++ ++      ++  ++     ++              +\u2260        \n       ++              ++++++++   ++++++++    ++++++++  ++      ++  ++++++++               +\u2260        \n       ++              ++         ++   ++     ++   ++   ++      ++  ++   ++                +\u2260        \n       ++              ++         ++    ++    ++   ++    ++     ++  ++    ++               +\u2260        \n       ++              +++++++++  ++     ++   ++    ++    +++++++   ++     ++              +\u2260        \n       ++                                                                                  +\u2260        \n        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++        \n                                                                                                    \n                                                                                                    ";
 var tinaCms = "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\n   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\n   \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\n   \u255A\u2550\u255D   \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D";
 
 // src/themes.ts
@@ -433,9 +634,279 @@ var THEMES = [
 ];
 
 // src/index.ts
+import { PostHog } from "posthog-node";
+
+// src/util/posthog.ts
+import { createHash, randomUUID } from "node:crypto";
+import { system as getSystemInfo } from "systeminformation";
+var CreateTinaAppStartedEvent = "create-tina-app-started";
+var CreateTinaAppFinishedEvent = "create-tina-app-finished";
+var TRACKING_STEPS = {
+  INIT: "initializing",
+  PRE_RUN_CHECKS: "pre_run_checks",
+  TELEMETRY_SETUP: "telemetry_setup",
+  PKG_MANAGER_SELECT: "package_manager_selection",
+  PROJECT_NAME_INPUT: "project_name_input",
+  TEMPLATE_SELECT: "template_selection",
+  THEME_SELECT: "theme_selection",
+  DIRECTORY_SETUP: "directory_setup",
+  DOWNLOADING_TEMPLATE: "downloading_template",
+  UPDATING_METADATA: "updating_metadata",
+  INSTALLING_PACKAGES: "installing_packages",
+  GIT_INIT: "git_initialization",
+  COMPLETE: "complete"
+};
+function generateSessionId() {
+  return randomUUID();
+}
+async function getAnonymousUserId() {
+  try {
+    const sysInfo = await getSystemInfo();
+    const systemUuid = sysInfo.uuid || "unknown";
+    if (systemUuid === "unknown" || !systemUuid) {
+      return `fallback-${randomUUID()}`;
+    }
+    const hash = createHash("sha256");
+    hash.update(systemUuid);
+    return hash.digest("hex").substring(0, 32);
+  } catch (error) {
+    return `fallback-${randomUUID()}`;
+  }
+}
+var ERROR_CODES = {
+  // Validation Errors (VAL_*)
+  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_UNSUPPORTED_NODE: "ERR_VAL_UNSUPPORTED_NODE",
+  ERR_VAL_NO_PKG_MANAGERS: "ERR_VAL_NO_PKG_MANAGERS",
+  // File System Errors (FS_*)
+  ERR_FS_NOT_WRITABLE: "ERR_FS_NOT_WRITABLE",
+  ERR_FS_HAS_CONFLICTS: "ERR_FS_HAS_CONFLICTS",
+  ERR_FS_MKDIR_FAILED: "ERR_FS_MKDIR_FAILED",
+  ERR_FS_CHDIR_FAILED: "ERR_FS_CHDIR_FAILED",
+  ERR_FS_READ_PACKAGE_JSON: "ERR_FS_READ_PACKAGE_JSON",
+  ERR_FS_WRITE_PACKAGE_JSON: "ERR_FS_WRITE_PACKAGE_JSON",
+  ERR_FS_UPDATE_THEME_FAILED: "ERR_FS_UPDATE_THEME_FAILED",
+  ERR_FS_COPY_TEMPLATE_FAILED: "ERR_FS_COPY_TEMPLATE_FAILED",
+  // Network Errors (NET_*)
+  ERR_NET_POSTHOG_CONFIG_FETCH: "ERR_NET_POSTHOG_CONFIG_FETCH",
+  ERR_NET_TARBALL_DOWNLOAD: "ERR_NET_TARBALL_DOWNLOAD",
+  ERR_NET_GITHUB_API_FAILED: "ERR_NET_GITHUB_API_FAILED",
+  ERR_NET_REPO_INFO_NOT_FOUND: "ERR_NET_REPO_INFO_NOT_FOUND",
+  ERR_NET_REPO_INVALID_URL: "ERR_NET_REPO_INVALID_URL",
+  ERR_NET_TARBALL_EXTRACT: "ERR_NET_TARBALL_EXTRACT",
+  // Installation Errors (INSTALL_*)
+  ERR_INSTALL_PKG_MANAGER_FAILED: "ERR_INSTALL_PKG_MANAGER_FAILED",
+  ERR_INSTALL_PKG_MANAGER_NOT_FOUND: "ERR_INSTALL_PKG_MANAGER_NOT_FOUND",
+  ERR_INSTALL_SPAWN_ERROR: "ERR_INSTALL_SPAWN_ERROR",
+  ERR_INSTALL_TIMEOUT: "ERR_INSTALL_TIMEOUT",
+  // Git Errors (GIT_*)
+  ERR_GIT_NOT_INSTALLED: "ERR_GIT_NOT_INSTALLED",
+  ERR_GIT_INIT_FAILED: "ERR_GIT_INIT_FAILED",
+  ERR_GIT_ADD_FAILED: "ERR_GIT_ADD_FAILED",
+  ERR_GIT_COMMIT_FAILED: "ERR_GIT_COMMIT_FAILED",
+  ERR_GIT_CHECKOUT_FAILED: "ERR_GIT_CHECKOUT_FAILED",
+  ERR_GIT_ALREADY_INITIALIZED: "ERR_GIT_ALREADY_INITIALIZED",
+  // User Cancellation (CANCEL_*)
+  ERR_CANCEL_PKG_MANAGER_PROMPT: "ERR_CANCEL_PKG_MANAGER_PROMPT",
+  ERR_CANCEL_PROJECT_NAME_PROMPT: "ERR_CANCEL_PROJECT_NAME_PROMPT",
+  ERR_CANCEL_TEMPLATE_PROMPT: "ERR_CANCEL_TEMPLATE_PROMPT",
+  ERR_CANCEL_THEME_PROMPT: "ERR_CANCEL_THEME_PROMPT",
+  ERR_CANCEL_SIGINT: "ERR_CANCEL_SIGINT",
+  // Configuration Errors (CFG_*)
+  ERR_CFG_POSTHOG_INIT_FAILED: "ERR_CFG_POSTHOG_INIT_FAILED",
+  ERR_CFG_OSINFO_FETCH_FAILED: "ERR_CFG_OSINFO_FETCH_FAILED",
+  ERR_CFG_TELEMETRY_SETUP_FAILED: "ERR_CFG_TELEMETRY_SETUP_FAILED",
+  // Template Errors (TPL_*)
+  ERR_TPL_DOWNLOAD_FAILED: "ERR_TPL_DOWNLOAD_FAILED",
+  ERR_TPL_EXTRACT_FAILED: "ERR_TPL_EXTRACT_FAILED",
+  ERR_TPL_METADATA_UPDATE_FAILED: "ERR_TPL_METADATA_UPDATE_FAILED",
+  ERR_TPL_INTERNAL_COPY_FAILED: "ERR_TPL_INTERNAL_COPY_FAILED",
+  ERR_TPL_THEME_UPDATE_FAILED: "ERR_TPL_THEME_UPDATE_FAILED",
+  // Uncategorized
+  ERR_UNCAUGHT: "ERR_UNCAUGHT"
+};
+function sanitizeStackTrace(stack) {
+  if (!stack) return "";
+  let sanitized = stack;
+  sanitized = sanitized.replace(/\/Users\/[^\/]+/g, "<user-home>");
+  sanitized = sanitized.replace(/[A-Z]:\\Users\\[^\\]+/gi, "<user-home>");
+  sanitized = sanitized.replace(
+    /.*\/(packages\/create-tina-app)\//g,
+    "<workspace>/$1/"
+  );
+  sanitized = sanitized.replace(
+    /(\/|\\)node_modules(\/|\\)/g,
+    "<node_modules>/"
+  );
+  sanitized = sanitized.replace(/\.npm\/_cacache/g, "<pkg-cache>");
+  sanitized = sanitized.replace(/\.yarn\/cache/g, "<pkg-cache>");
+  sanitized = sanitized.replace(/\.pnpm-store/g, "<pkg-cache>");
+  sanitized = sanitized.replace(/[A-Z]:\\/gi, "<drive>/");
+  return sanitized;
+}
+function truncateStackTrace(stack, maxFrames = 5) {
+  const lines = stack.split("\n");
+  const filtered = lines.filter((line) => {
+    if (!line.trim().startsWith("at ")) return true;
+    return !line.includes("node:internal") && !line.includes("node_modules/prompts") && !line.includes("node_modules/ora");
+  }).slice(0, maxFrames + 1);
+  return filtered.join("\n");
+}
+function createSimpleHash(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(36);
+}
+function sanitizeError(error) {
+  const message = error.message || "Unknown error";
+  const rawStack = error.stack || "";
+  const truncated = truncateStackTrace(rawStack);
+  const sanitizedStack = sanitizeStackTrace(truncated);
+  const stackForHash = rawStack.replace(/:\d+:\d+/g, "").replace(/\/Users\/[^\/]+/g, "").replace(/[A-Z]:\\Users\\[^\\]+/gi, "");
+  const originalStackHash = createSimpleHash(stackForHash);
+  return {
+    message,
+    sanitizedStack,
+    originalStackHash
+  };
+}
+function postHogCapture(client, distinctId, sessionId, event, properties) {
+  if (process.env.TINA_DEV === "true") return;
+  if (!client) {
+    return;
+  }
+  try {
+    client.capture({
+      distinctId,
+      event,
+      properties: {
+        ...properties,
+        sessionId,
+        system: "tinacms/create-tina-app"
+      }
+    });
+  } catch (error) {
+    console.error("Error capturing event:", error);
+  }
+}
+function postHogCaptureError(client, distinctId, sessionId, error, context) {
+  if (process.env.TINA_DEV === "true") return;
+  if (!client) return;
+  const { message, sanitizedStack, originalStackHash } = sanitizeError(error);
+  const {
+    errorCode,
+    errorCategory,
+    step,
+    fatal = true,
+    additionalProperties = {}
+  } = context;
+  let eventName;
+  if (errorCategory === "user-cancellation") {
+    eventName = "create-tina-app-user-cancelled";
+  } else if (errorCategory === "validation") {
+    eventName = "create-tina-app-validation-error";
+  } else {
+    eventName = "create-tina-app-error";
+  }
+  const properties = {
+    error_code: errorCode,
+    error_category: errorCategory,
+    error_message: message.substring(0, 500),
+    // Limit message length
+    sanitized_stack: sanitizedStack,
+    stack_hash: originalStackHash,
+    step,
+    fatal,
+    user_cancelled: errorCategory === "user-cancellation",
+    sessionId,
+    ...additionalProperties
+  };
+  try {
+    client.capture({
+      distinctId,
+      event: eventName,
+      properties: {
+        ...properties,
+        system: "tinacms/create-tina-app"
+      }
+    });
+  } catch (captureError) {
+    console.error("Error capturing error event:", captureError);
+  }
+}
+
+// src/util/fetchPosthogConfig.tsx
+async function fetchPostHogConfig(endpointUrl) {
+  try {
+    const response = await fetch(endpointUrl, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to fetch PostHog config: ${response.statusText}`);
+    }
+    const config = await response.json();
+    return {
+      POSTHOG_API_KEY: config.api_key,
+      POSTHOG_ENDPOINT: config.host
+    };
+  } catch (error) {
+    console.warn(
+      `Failed to fetch PostHog config from endpoint: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+    return {};
+  }
+}
+
+// src/index.ts
+import { osInfo as getOsSystemInfo } from "systeminformation";
+var posthogClient = null;
+async function initializePostHog(configEndpoint) {
+  let apiKey;
+  let endpoint;
+  if (configEndpoint) {
+    const config = await fetchPostHogConfig(configEndpoint);
+    apiKey = config.POSTHOG_API_KEY;
+    endpoint = config.POSTHOG_ENDPOINT;
+  }
+  if (!apiKey) {
+    console.warn(
+      "PostHog API key not found. PostHog tracking will be disabled."
+    );
+    return null;
+  }
+  return new PostHog(apiKey, {
+    host: endpoint
+  });
+}
+function formatTemplateChoice(template) {
+  let description = template.description || "";
+  if (template.features && template.features.length > 0) {
+    const featuresText = template.features.map((feature) => `  \u2022 ${feature.name}: ${feature.description}`).join("\n");
+    description = `${description}
+
+Features:
+${featuresText}`;
+  }
+  return {
+    title: template.title,
+    value: template.value,
+    description
+  };
+}
 async function run() {
   const ora = (await import("ora")).default;
   let packageManagerInstallationHadError = false;
+  const sessionId = generateSessionId();
+  const userId = await getAnonymousUserId();
   if (process.stdout.columns >= 60) {
     console.log(TextStyles.tinaOrange(`${llama}`));
     console.log(TextStyles.tinaOrange(`${tinaCms}`));
@@ -445,10 +916,43 @@ async function run() {
   const require2 = createRequire(import.meta.url);
   const version2 = require2("../package.json").version;
   console.log(`Create Tina App v${version2}`);
+  const opts = extractOptions(process.argv);
+  const installedPkgManagers = [];
+  for (const pkg_manager of PKG_MANAGERS) {
+    if (await checkPackageExists(pkg_manager)) {
+      installedPkgManagers.push(pkg_manager);
+    }
+  }
+  const telemetryData = {};
+  if (!opts.noTelemetry) {
+    console.log(`
+${TextStylesBold.bold("Telemetry Notice")}`);
+    console.log(
+      `To help the TinaCMS team improve the developer experience, create-tina-app collects anonymous usage statistics. This data helps us understand which environments and features are most important to support. Usage analytics may include: Operating system and version, package manager name and version (local only), Node.js version (local only), and the selected TinaCMS starter template.
+No personal or project-specific code is ever collected. You can opt out at any time by passing the --noTelemetry flag.
+`
+    );
+    posthogClient = await initializePostHog(
+      "https://identity-v2.tinajs.io/v2/posthog-token"
+    );
+    const osInfo = await getOsSystemInfo();
+    telemetryData["os-platform"] = osInfo.platform;
+    telemetryData["os-distro"] = osInfo.distro;
+    telemetryData["os-release"] = osInfo.release;
+    telemetryData["node-version"] = process.version;
+    for (const pkgManager2 of PKG_MANAGERS) {
+      telemetryData[`${pkgManager2}-installed`] = installedPkgManagers.includes(pkgManager2);
+    }
+  }
   const spinner = ora();
   preRunChecks(spinner);
-  const opts = extractOptions(process.argv);
-  const telemetry = new Telemetry({ disabled: opts?.noTelemetry });
+  postHogCapture(
+    posthogClient,
+    userId,
+    sessionId,
+    CreateTinaAppStartedEvent,
+    telemetryData
+  );
   let template = null;
   if (opts.template) {
     template = TEMPLATES.find((_template) => _template.value === opts.template);
@@ -458,6 +962,23 @@ async function run() {
           (x2) => x2.value
         )}`
       );
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error(`Invalid template: ${opts.template}`),
+        {
+          errorCode: ERROR_CODES.ERR_VAL_INVALID_TEMPLATE,
+          errorCategory: "validation",
+          step: TRACKING_STEPS.TEMPLATE_SELECT,
+          fatal: true,
+          additionalProperties: {
+            ...telemetryData,
+            provided_template: opts.template
+          }
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
       exit(1);
     }
   }
@@ -467,20 +988,45 @@ async function run() {
       spinner.fail(
         `The provided package manager '${opts.pkgManager}' is not supported. Please provide one of the following: ${PKG_MANAGERS}`
       );
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error(`Invalid package manager: ${opts.pkgManager}`),
+        {
+          errorCode: ERROR_CODES.ERR_VAL_INVALID_PKG_MANAGER,
+          errorCategory: "validation",
+          step: TRACKING_STEPS.PKG_MANAGER_SELECT,
+          fatal: true,
+          additionalProperties: {
+            ...telemetryData,
+            provided_pkg_manager: opts.pkgManager
+          }
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
       exit(1);
     }
   }
   if (!pkgManager) {
-    const installedPkgManagers = [];
-    for (const pkg_manager of PKG_MANAGERS) {
-      if (await checkPackageExists(pkg_manager)) {
-        installedPkgManagers.push(pkg_manager);
-      }
-    }
     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,
+        new Error("No supported package managers installed"),
+        {
+          errorCode: ERROR_CODES.ERR_VAL_NO_PKG_MANAGERS,
+          errorCategory: "validation",
+          step: TRACKING_STEPS.PRE_RUN_CHECKS,
+          fatal: true,
+          additionalProperties: telemetryData
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
       exit(1);
     }
     const res = await prompts({
@@ -491,8 +1037,25 @@ async function run() {
         return { title: manager, value: manager };
       })
     });
-    if (!Object.hasOwn(res, "packageManager")) exit(1);
+    if (!Object.hasOwn(res, "packageManager")) {
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error("User cancelled package manager selection"),
+        {
+          errorCode: ERROR_CODES.ERR_CANCEL_PKG_MANAGER_PROMPT,
+          errorCategory: "user-cancellation",
+          step: TRACKING_STEPS.PKG_MANAGER_SELECT,
+          fatal: true,
+          additionalProperties: telemetryData
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
+      exit(1);
+    }
     pkgManager = res.packageManager;
+    telemetryData["package-manager"] = pkgManager;
   }
   let projectName = opts.projectName;
   if (!projectName) {
@@ -502,14 +1065,30 @@ async function run() {
       message: "What is your project named?",
       initial: "my-tina-app",
       validate: (name2) => {
-        const { validForNewPackages, errors } = validate(
-          path4.basename(path4.resolve(name2))
+        const { message, isError } = validate(
+          path3.basename(path3.resolve(name2))
         );
-        if (validForNewPackages) return true;
-        return `Invalid project name: ${errors[0]}`;
+        if (isError) return `Invalid project name: ${message}`;
+        return true;
       }
     });
-    if (!Object.hasOwn(res, "name")) exit(1);
+    if (!Object.hasOwn(res, "name")) {
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error("User cancelled project name input"),
+        {
+          errorCode: ERROR_CODES.ERR_CANCEL_PROJECT_NAME_PROMPT,
+          errorCategory: "user-cancellation",
+          step: TRACKING_STEPS.PROJECT_NAME_INPUT,
+          fatal: true,
+          additionalProperties: telemetryData
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
+      exit(1);
+    }
     projectName = res.name;
   }
   if (!template) {
@@ -517,11 +1096,28 @@ async function run() {
       name: "template",
       type: "select",
       message: "What starter code would you like to use?",
-      choices: TEMPLATES
+      choices: TEMPLATES.map(formatTemplateChoice)
     });
-    if (!Object.hasOwn(res, "template")) exit(1);
+    if (!Object.hasOwn(res, "template")) {
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error("User cancelled template selection"),
+        {
+          errorCode: ERROR_CODES.ERR_CANCEL_TEMPLATE_PROMPT,
+          errorCategory: "user-cancellation",
+          step: TRACKING_STEPS.TEMPLATE_SELECT,
+          fatal: true,
+          additionalProperties: telemetryData
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
+      exit(1);
+    }
     template = TEMPLATES.find((_template) => _template.value === res.template);
   }
+  telemetryData["template"] = template.value;
   let themeChoice;
   if (template.value === "tina-docs") {
     const res = await prompts({
@@ -530,32 +1126,73 @@ async function run() {
       message: "What theme would you like to use?",
       choices: THEMES
     });
-    if (!Object.hasOwn(res, "theme")) exit(1);
+    if (!Object.hasOwn(res, "theme")) {
+      postHogCaptureError(
+        posthogClient,
+        userId,
+        sessionId,
+        new Error("User cancelled theme selection"),
+        {
+          errorCode: ERROR_CODES.ERR_CANCEL_THEME_PROMPT,
+          errorCategory: "user-cancellation",
+          step: TRACKING_STEPS.THEME_SELECT,
+          fatal: true,
+          additionalProperties: {
+            ...telemetryData,
+            template: template.value
+          }
+        }
+      );
+      if (posthogClient) await posthogClient.shutdown();
+      exit(1);
+    }
     themeChoice = res.theme;
   }
-  await telemetry.submitRecord({
-    event: {
-      name: "create-tina-app:invoke",
-      template: template.value,
-      pkgManager
-    }
-  });
-  const rootDir = path4.join(process.cwd(), projectName);
-  if (!await isWriteable(path4.dirname(rootDir))) {
+  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,
+      new Error("Directory not writable"),
+      {
+        errorCode: ERROR_CODES.ERR_FS_NOT_WRITABLE,
+        errorCategory: "filesystem",
+        step: TRACKING_STEPS.DIRECTORY_SETUP,
+        fatal: true,
+        additionalProperties: {
+          ...telemetryData,
+          template: template.value
+        }
+      }
+    );
+    if (posthogClient) await posthogClient.shutdown();
     process.exit(1);
   }
   let appName;
   try {
     appName = await setupProjectDirectory(rootDir);
+    telemetryData["app-name"] = appName;
   } catch (err) {
-    spinner.fail(err.message);
+    const error = err;
+    spinner.fail(error.message);
+    postHogCaptureError(posthogClient, userId, sessionId, error, {
+      errorCode: ERROR_CODES.ERR_FS_MKDIR_FAILED,
+      errorCategory: "filesystem",
+      step: TRACKING_STEPS.DIRECTORY_SETUP,
+      fatal: true,
+      additionalProperties: {
+        ...telemetryData,
+        template: template.value
+      }
+    });
+    if (posthogClient) await posthogClient.shutdown();
     exit(1);
   }
   try {
-    await downloadTemplate(template, rootDir, spinner);
     if (themeChoice) {
       await updateThemeSettings(rootDir, themeChoice);
     }
@@ -567,7 +1204,20 @@ async function run() {
     updateProjectPackageVersion(rootDir, "0.0.1");
     spinner.succeed();
   } catch (err) {
-    spinner.fail(`Failed to download template: ${err.message}`);
+    const error = err;
+    spinner.fail(`Failed to download template: ${error.message}`);
+    postHogCaptureError(posthogClient, userId, sessionId, error, {
+      errorCode: ERROR_CODES.ERR_TPL_DOWNLOAD_FAILED,
+      errorCategory: "template",
+      step: TRACKING_STEPS.DOWNLOADING_TEMPLATE,
+      fatal: true,
+      additionalProperties: {
+        ...telemetryData,
+        template: template.value,
+        theme: themeChoice
+      }
+    });
+    if (posthogClient) await posthogClient.shutdown();
     exit(1);
   }
   spinner.start("Installing packages.");
@@ -575,8 +1225,20 @@ async function run() {
     await install(pkgManager, opts.verbose);
     spinner.succeed();
   } catch (err) {
-    spinner.fail(`Failed to install packages: ${err.message}`);
+    const error = err;
+    spinner.fail(`Failed to install packages: ${error.message}`);
     packageManagerInstallationHadError = true;
+    postHogCaptureError(posthogClient, userId, sessionId, error, {
+      errorCode: ERROR_CODES.ERR_INSTALL_PKG_MANAGER_FAILED,
+      errorCategory: "installation",
+      step: TRACKING_STEPS.INSTALLING_PACKAGES,
+      fatal: false,
+      additionalProperties: {
+        ...telemetryData,
+        template: template.value,
+        package_manager: pkgManager
+      }
+    });
   }
   spinner.start("Initializing git repository.");
   try {
@@ -585,8 +1247,26 @@ async function run() {
       spinner.succeed();
     }
   } catch (err) {
+    const error = err;
     spinner.fail("Failed to initialize Git repository, skipping.");
+    postHogCaptureError(posthogClient, userId, sessionId, error, {
+      errorCode: ERROR_CODES.ERR_GIT_INIT_FAILED,
+      errorCategory: "git",
+      step: TRACKING_STEPS.GIT_INIT,
+      fatal: false,
+      additionalProperties: {
+        ...telemetryData,
+        template: template.value
+      }
+    });
   }
+  postHogCapture(
+    posthogClient,
+    userId,
+    sessionId,
+    CreateTinaAppFinishedEvent,
+    telemetryData
+  );
   spinner.succeed(`Created ${TextStyles.tinaOrange(appName)}
 `);
   if (template.value === "tina-hugo-starter") {
@@ -629,9 +1309,28 @@ async function run() {
     )}`
   );
 }
-run().catch((error) => {
+run().catch(async (error) => {
+  if (process.stdout.columns >= 60) {
+    console.log(TextStyles.tinaOrange(`${errorArt}`));
+  }
   console.error("Error running create-tina-app:", error);
+  const sessionId = generateSessionId();
+  const userId = await getAnonymousUserId();
+  postHogCaptureError(posthogClient, userId, sessionId, error, {
+    errorCode: ERROR_CODES.ERR_UNCAUGHT,
+    errorCategory: "uncategorized",
+    step: "unknown",
+    fatal: true,
+    additionalProperties: {}
+  });
+  if (posthogClient) {
+    await posthogClient.shutdown();
+  }
   process.exit(1);
+}).then(async () => {
+  if (posthogClient) {
+    await posthogClient.shutdown();
+  }
 });
 export {
   run

package/dist/templates.d.ts

@@ -1,7 +1,12 @@
 import { Ora } from 'ora';
+type Feature = {
+    name: string;
+    description: string;
+};
 export type BaseExample = {
     title: string;
     description?: string;
+    features?: Feature[];
     value: string;
     devUrl: string;
 };
@@ -15,3 +20,4 @@ export type ExternalTemplate = BaseExample & {
 export type Template = InternalTemplate | ExternalTemplate;
 export declare const TEMPLATES: Template[];
 export declare function downloadTemplate(template: Template, root: string, spinner: Ora): Promise<void>;
+export {};

package/dist/util/asciiArt.d.ts

@@ -1,2 +1,3 @@
 export declare const llama: string;
+export declare const errorArt: string;
 export declare const tinaCms: string;

package/dist/util/fetchPosthogConfig.d.ts

@@ -0,0 +1,5 @@
+export interface PostHogConfig {
+    POSTHOG_API_KEY?: string;
+    POSTHOG_ENDPOINT?: string;
+}
+export default function fetchPostHogConfig(endpointUrl: string): Promise<PostHogConfig>;

package/dist/util/isNpm.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @typedef {Object} ValidationResult
+ * @property {string | null} message
+ * @property {boolean} isError
+ */
+/**
+ * Validates whether the provided name is valid on NPM.
+ *
+ * @param {string} name
+ * @returns {ValidationResult}
+ */
+export default function validate(name: string): ValidationResult;
+export type ValidationResult = {
+    message: string | null;
+    isError: boolean;
+};

package/dist/util/posthog.d.ts

@@ -0,0 +1,147 @@
+import { PostHog } from 'posthog-node';
+export declare const CreateTinaAppStartedEvent: string;
+export declare const CreateTinaAppFinishedEvent: string;
+/**
+ * Step names for tracking progress through the create-tina-app process
+ */
+export declare const TRACKING_STEPS: {
+    readonly INIT: "initializing";
+    readonly PRE_RUN_CHECKS: "pre_run_checks";
+    readonly TELEMETRY_SETUP: "telemetry_setup";
+    readonly PKG_MANAGER_SELECT: "package_manager_selection";
+    readonly PROJECT_NAME_INPUT: "project_name_input";
+    readonly TEMPLATE_SELECT: "template_selection";
+    readonly THEME_SELECT: "theme_selection";
+    readonly DIRECTORY_SETUP: "directory_setup";
+    readonly DOWNLOADING_TEMPLATE: "downloading_template";
+    readonly UPDATING_METADATA: "updating_metadata";
+    readonly INSTALLING_PACKAGES: "installing_packages";
+    readonly GIT_INIT: "git_initialization";
+    readonly COMPLETE: "complete";
+};
+/**
+ * Generate a unique session ID for this run
+ */
+export declare function generateSessionId(): string;
+/**
+ * Get a hashed user ID based on system UUID
+ * Returns a consistent anonymous identifier for the machine
+ */
+export declare function getAnonymousUserId(): Promise<string>;
+/**
+ * Structured error codes for categorizing failures
+ */
+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_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";
+    readonly ERR_FS_HAS_CONFLICTS: "ERR_FS_HAS_CONFLICTS";
+    readonly ERR_FS_MKDIR_FAILED: "ERR_FS_MKDIR_FAILED";
+    readonly ERR_FS_CHDIR_FAILED: "ERR_FS_CHDIR_FAILED";
+    readonly ERR_FS_READ_PACKAGE_JSON: "ERR_FS_READ_PACKAGE_JSON";
+    readonly ERR_FS_WRITE_PACKAGE_JSON: "ERR_FS_WRITE_PACKAGE_JSON";
+    readonly ERR_FS_UPDATE_THEME_FAILED: "ERR_FS_UPDATE_THEME_FAILED";
+    readonly ERR_FS_COPY_TEMPLATE_FAILED: "ERR_FS_COPY_TEMPLATE_FAILED";
+    readonly ERR_NET_POSTHOG_CONFIG_FETCH: "ERR_NET_POSTHOG_CONFIG_FETCH";
+    readonly ERR_NET_TARBALL_DOWNLOAD: "ERR_NET_TARBALL_DOWNLOAD";
+    readonly ERR_NET_GITHUB_API_FAILED: "ERR_NET_GITHUB_API_FAILED";
+    readonly ERR_NET_REPO_INFO_NOT_FOUND: "ERR_NET_REPO_INFO_NOT_FOUND";
+    readonly ERR_NET_REPO_INVALID_URL: "ERR_NET_REPO_INVALID_URL";
+    readonly ERR_NET_TARBALL_EXTRACT: "ERR_NET_TARBALL_EXTRACT";
+    readonly ERR_INSTALL_PKG_MANAGER_FAILED: "ERR_INSTALL_PKG_MANAGER_FAILED";
+    readonly ERR_INSTALL_PKG_MANAGER_NOT_FOUND: "ERR_INSTALL_PKG_MANAGER_NOT_FOUND";
+    readonly ERR_INSTALL_SPAWN_ERROR: "ERR_INSTALL_SPAWN_ERROR";
+    readonly ERR_INSTALL_TIMEOUT: "ERR_INSTALL_TIMEOUT";
+    readonly ERR_GIT_NOT_INSTALLED: "ERR_GIT_NOT_INSTALLED";
+    readonly ERR_GIT_INIT_FAILED: "ERR_GIT_INIT_FAILED";
+    readonly ERR_GIT_ADD_FAILED: "ERR_GIT_ADD_FAILED";
+    readonly ERR_GIT_COMMIT_FAILED: "ERR_GIT_COMMIT_FAILED";
+    readonly ERR_GIT_CHECKOUT_FAILED: "ERR_GIT_CHECKOUT_FAILED";
+    readonly ERR_GIT_ALREADY_INITIALIZED: "ERR_GIT_ALREADY_INITIALIZED";
+    readonly ERR_CANCEL_PKG_MANAGER_PROMPT: "ERR_CANCEL_PKG_MANAGER_PROMPT";
+    readonly ERR_CANCEL_PROJECT_NAME_PROMPT: "ERR_CANCEL_PROJECT_NAME_PROMPT";
+    readonly ERR_CANCEL_TEMPLATE_PROMPT: "ERR_CANCEL_TEMPLATE_PROMPT";
+    readonly ERR_CANCEL_THEME_PROMPT: "ERR_CANCEL_THEME_PROMPT";
+    readonly ERR_CANCEL_SIGINT: "ERR_CANCEL_SIGINT";
+    readonly ERR_CFG_POSTHOG_INIT_FAILED: "ERR_CFG_POSTHOG_INIT_FAILED";
+    readonly ERR_CFG_OSINFO_FETCH_FAILED: "ERR_CFG_OSINFO_FETCH_FAILED";
+    readonly ERR_CFG_TELEMETRY_SETUP_FAILED: "ERR_CFG_TELEMETRY_SETUP_FAILED";
+    readonly ERR_TPL_DOWNLOAD_FAILED: "ERR_TPL_DOWNLOAD_FAILED";
+    readonly ERR_TPL_EXTRACT_FAILED: "ERR_TPL_EXTRACT_FAILED";
+    readonly ERR_TPL_METADATA_UPDATE_FAILED: "ERR_TPL_METADATA_UPDATE_FAILED";
+    readonly ERR_TPL_INTERNAL_COPY_FAILED: "ERR_TPL_INTERNAL_COPY_FAILED";
+    readonly ERR_TPL_THEME_UPDATE_FAILED: "ERR_TPL_THEME_UPDATE_FAILED";
+    readonly ERR_UNCAUGHT: "ERR_UNCAUGHT";
+};
+/**
+ * Sends an event to PostHog for analytics tracking.
+ *
+ * @param client - The PostHog client instance used to send the event
+ * @param distinctId - A unique identifier for the user (hashed system UUID)
+ * @param sessionId - A unique identifier for this run/session
+ * @param event - The name of the event to track (e.g., 'create-tina-app-started')
+ * @param properties - Additional properties to include with the event
+ *
+ * @remarks
+ * - Returns early if the PostHog client is not provided
+ * - Skips sending data when `TINA_DEV` environment variable is set to 'true'
+ * - Automatically adds a 'system' property with value 'tinacms/create-tina-app'
+ * - Includes sessionId in properties to track individual runs
+ * - Uses hashed system UUID as distinctId to track unique users anonymously
+ * - Logs errors to console if event capture fails
+ *
+ * @example
+ * ```typescript
+ * const client = new PostHog('api-key');
+ * const userId = await getAnonymousUserId();
+ * const sessionId = generateSessionId();
+ * postHogCapture(client, userId, sessionId, 'create-tina-app-started', {
+ *   template: 'basic',
+ *   typescript: true
+ * });
+ * ```
+ */
+export declare function postHogCapture(client: PostHog, distinctId: string, sessionId: string, event: string, properties: Record<string, any>): void;
+/**
+ * Capture an error event in PostHog with categorized tracking and sanitized stack traces
+ *
+ * @param client - The PostHog client instance
+ * @param distinctId - A unique identifier for the user (hashed system UUID)
+ * @param sessionId - A unique identifier for this run/session
+ * @param error - The error object that was thrown
+ * @param context - Context about the error including code, category, step, and additional properties
+ *
+ * @remarks
+ * - Sanitizes stack traces to remove local file paths
+ * - Maps error categories to three event types:
+ *   - 'create-tina-app-error' for technical failures (filesystem, network, installation, git, etc.)
+ *   - 'create-tina-app-validation-error' for user input validation issues
+ *   - 'create-tina-app-user-cancelled' for user cancellations (Ctrl+C)
+ * - Includes error code, sanitized stack, step name, and telemetry data in properties
+ * - Non-fatal errors are tracked but allow the process to continue
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await downloadTemplate();
+ * } catch (err) {
+ *   postHogCaptureError(client, userId, sessionId, err as Error, {
+ *     errorCode: ERROR_CODES.ERR_TPL_DOWNLOAD_FAILED,
+ *     errorCategory: 'template',
+ *     step: TRACKING_STEPS.DOWNLOADING_TEMPLATE,
+ *     fatal: true,
+ *     additionalProperties: { template: 'basic' }
+ *   });
+ * }
+ * ```
+ */
+export declare function postHogCaptureError(client: PostHog | null, distinctId: string, sessionId: string, error: Error, context: {
+    errorCode: string;
+    errorCategory: string;
+    step: string;
+    fatal?: boolean;
+    additionalProperties?: Record<string, any>;
+}): void;

package/dist/util/textstyles.d.ts

@@ -8,3 +8,13 @@ export declare const TextStyles: {
     err: import("chalk").ChalkInstance;
     bold: import("chalk").ChalkInstance;
 };
+export declare const TextStylesBold: {
+    tinaOrange: import("chalk").ChalkInstance;
+    link: (url: string) => string;
+    cmd: import("chalk").ChalkInstance;
+    info: import("chalk").ChalkInstance;
+    success: import("chalk").ChalkInstance;
+    warn: import("chalk").ChalkInstance;
+    err: import("chalk").ChalkInstance;
+    bold: import("chalk").ChalkInstance;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tina-app",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "main": "dist/index.js",
   "files": [
@@ -44,10 +44,10 @@
     "cross-spawn": "^7.0.6",
     "fs-extra": "^11.3.0",
     "ora": "^8.2.0",
+    "posthog-node": "^5.17.2",
     "prompts": "^2.4.2",
-    "tar": "7.4.0",
-    "validate-npm-package-name": "^5.0.1",
-    "@tinacms/metrics": "2.0.1"
+    "systeminformation": "^5.27.13",
+    "tar": "7.4.0"
   },
   "scripts": {
     "types": "pnpm tsc",