create-tina-app 0.0.0-d80714b-20241205222511 → 0.0.0-d9487bf-20251119052214

package/README.md

@@ -6,6 +6,6 @@ Create Tina App is a powerful command-line interface (CLI) tool designed to kick
 
 To get started, you need to first build the code - see [contributing](https://github.com/tinacms/tinacms/blob/main/CONTRIBUTING.md).
 
-1. run `pnpm link create-tina-app`
+1. run `pnpm link --global`
 1. Test your changes by running `npx create-tina-app`
 1. Run `pnpm unlink` when done to unlink the local build

package/dist/index.d.ts

@@ -1,2 +1 @@
-export declare const PKG_MANAGERS: string[];
 export declare function run(): Promise<void>;

package/dist/index.js

@@ -4,6 +4,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name2 in all)
     __defProp(target, name2, { get: all[name2], enumerable: true });
@@ -17,66 +20,103 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "create-tina-app",
+      version: "1.6.0",
+      main: "dist/index.js",
+      files: [
+        "dist",
+        "examples",
+        "bin/*"
+      ],
+      bin: "bin/create-tina-app",
+      typings: "dist/index.d.ts",
+      license: "Apache-2.0",
+      buildConfig: {
+        entryPoints: [
+          {
+            name: "src/index.ts",
+            target: "node"
+          }
+        ]
+      },
+      engines: {
+        node: ">=18.18.0"
+      },
+      scripts: {
+        types: "pnpm tsc",
+        build: "tinacms-scripts build",
+        "test-run-bin": "pnpm create-tina-app"
+      },
+      publishConfig: {
+        registry: "https://registry.npmjs.org"
+      },
+      repository: {
+        url: "https://github.com/tinacms/tinacms.git",
+        directory: "packages/create-tina-app"
+      },
+      devDependencies: {
+        "@tinacms/scripts": "workspace:*",
+        "@types/cross-spawn": "catalog:",
+        "@types/fs-extra": "^11.0.4",
+        "@types/node": "^22.13.1",
+        "@types/prompts": "catalog:",
+        "@types/tar": "catalog:",
+        typescript: "^5.7.3"
+      },
+      dependencies: {
+        "@tinacms/metrics": "workspace:*",
+        chalk: "4.1.2",
+        commander: "^12.1.0",
+        "cross-spawn": "catalog:",
+        "fs-extra": "catalog:",
+        ora: "catalog:",
+        prompts: "catalog:",
+        tar: "catalog:",
+        "validate-npm-package-name": "catalog:"
+      }
+    };
+  }
+});
+
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  PKG_MANAGERS: () => PKG_MANAGERS,
+var index_exports = {};
+__export(index_exports, {
   run: () => run
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 var import_metrics = require("@tinacms/metrics");
-var import_commander = require("commander");
 var import_prompts = __toESM(require("prompts"));
-var import_node_path = __toESM(require("path"));
-
-// package.json
-var name = "create-tina-app";
-var version = "1.2.4";
+var import_node_path = __toESM(require("node:path"));
 
 // src/util/fileUtil.ts
 var import_fs_extra = __toESM(require("fs-extra"));
 var import_path = __toESM(require("path"));
 
-// src/util/logger.ts
+// src/util/textstyles.ts
 var import_chalk = __toESM(require("chalk"));
 var TextStyles = {
-  link: import_chalk.default.bold.cyan,
-  cmd: import_chalk.default.inverse,
+  tinaOrange: import_chalk.default.hex("#EC4816"),
+  link: (url) => `\x1B]8;;${url}\x07${import_chalk.default.cyan.underline(url)}\x1B]8;;\x07`,
+  cmd: import_chalk.default.bgBlackBright.bold.white,
   info: import_chalk.default.blue,
   success: import_chalk.default.green,
   warn: import_chalk.default.yellow,
   err: import_chalk.default.red,
   bold: import_chalk.default.bold
 };
-var Logger = class {
-  log(message) {
-    console.info(message);
-  }
-  debug(message) {
-    console.debug(TextStyles.info(`[DEBUG] ${message}`));
-  }
-  info(message) {
-    console.info(TextStyles.info(`[INFO] ${message}`));
-  }
-  success(message) {
-    console.log(TextStyles.success(`[SUCCESS] ${message}`));
-  }
-  cmd(message) {
-    console.log(TextStyles.cmd(message));
-  }
-  warn(message) {
-    console.warn(TextStyles.warn(`[WARNING] ${message}`));
-  }
-  err(message) {
-    console.error(TextStyles.err(`[ERROR] ${message}`));
-  }
-};
-var log = new Logger();
 
 // src/util/fileUtil.ts
 async function isWriteable(directory) {
@@ -117,24 +157,22 @@ async function setupProjectDirectory(dir) {
   process.chdir(dir);
   const conflicts = folderContainsInstallConflicts(dir);
   if (conflicts.length > 0) {
-    log.err(
-      `The directory '${TextStyles.bold(
-        appName
-      )}' contains files that could conflict. Below is a list of conflicts, please remove them and try again.`
-    );
+    const errorMessageLines = [
+      `The directory '${TextStyles.bold(appName)}' contains files that could conflict. Below is a list of conflicts, please remove them and try again.`
+    ];
     for (const file of conflicts) {
       try {
         const stats = import_fs_extra.default.lstatSync(import_path.default.join(dir, file));
         if (stats.isDirectory()) {
-          log.log(`-  ${TextStyles.info(file)}/`);
+          errorMessageLines.push(`  -  ${TextStyles.info(file)}/`);
         } else {
-          log.log(`-  ${file}`);
+          errorMessageLines.push(`  -  ${file}`);
         }
       } catch {
-        log.log(`-  ${file}`);
+        errorMessageLines.push(`  -  ${file}`);
       }
     }
-    process.exit(1);
+    throw new Error(errorMessageLines.join("\n"));
   }
   return appName;
 }
@@ -150,70 +188,31 @@ function updateProjectPackageVersion(dir, version2) {
   packageJson.version = version2;
   import_fs_extra.default.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
 }
+async function updateThemeSettings(dir, selectedTheme) {
+  const settingsDir = import_path.default.join(dir, "content", "settings");
+  const configPath = import_path.default.join(settingsDir, "config.json");
+  await import_fs_extra.default.mkdirp(settingsDir);
+  let config = {};
+  try {
+    const existingConfig = await import_fs_extra.default.readFile(configPath, "utf8");
+    config = JSON.parse(existingConfig);
+  } catch (error) {
+  }
+  config.selectedTheme = selectedTheme;
+  await import_fs_extra.default.writeFile(configPath, JSON.stringify(config, null, 2));
+}
 
 // src/util/install.ts
 var import_cross_spawn = __toESM(require("cross-spawn"));
-function install(root, dependencies, { packageManager, isOnline, devDependencies }) {
-  const npmFlags = [];
-  const yarnFlags = [];
-  const pnpmFlags = [];
+function install(packageManager, verboseOutput) {
   return new Promise((resolve, reject) => {
-    let args;
-    const command = packageManager;
-    if (dependencies == null ? void 0 : dependencies.length) {
-      switch (packageManager) {
-        case "yarn":
-          args = ["add", "--exact"];
-          if (!isOnline)
-            args.push("--offline");
-          args.push("--cwd", root);
-          if (devDependencies)
-            args.push("--dev");
-          args.push(...dependencies);
-          break;
-        case "npm":
-          args = ["install", "--save-exact"];
-          args.push(devDependencies ? "--save-dev" : "--save");
-          args.push(...dependencies);
-          break;
-        case "pnpm":
-          args = ["add"];
-          if (!isOnline)
-            args.push("--offline");
-          args.push("--save-exact");
-          if (devDependencies)
-            args.push("-D");
-          args.push(...dependencies);
-          break;
-      }
-    } else {
-      args = ["install"];
-      if (!isOnline) {
-        log.warn("You appear to be offline.");
-        if (packageManager === "yarn") {
-          log.warn("Falling back to the local Yarn cache.");
-          args.push("--offline");
-        }
-      }
-    }
-    switch (packageManager) {
-      case "yarn":
-        args.push(...yarnFlags);
-        break;
-      case "npm":
-        args.push(...npmFlags);
-        break;
-      case "pnpm":
-        args.push(...pnpmFlags);
-        break;
-    }
-    const child = (0, import_cross_spawn.default)(command, args, {
-      stdio: "inherit",
+    const child = (0, import_cross_spawn.default)(packageManager, ["install"], {
+      stdio: verboseOutput ? "inherit" : "ignore",
       env: { ...process.env, ADBLOCK: "1", DISABLE_OPENCOLLECTIVE: "1" }
     });
     child.on("close", (code) => {
       if (code !== 0) {
-        reject({ command: `${command} ${args.join(" ")}` });
+        reject({ command: `${packageManager} install` });
         return;
       }
       resolve();
@@ -253,14 +252,16 @@ function makeFirstCommit(root) {
     throw err;
   }
 }
-function initializeGit() {
+function initializeGit(spinner) {
   (0, import_child_process.execSync)("git --version", { stdio: "ignore" });
   if (isInGitRepository() || isInMercurialRepository()) {
-    log.warn("Already in a Git repository, skipping.");
+    spinner.warn("Already in a Git repository, skipping.");
     return false;
   }
   if (!import_fs_extra2.default.existsSync(".gitignore")) {
-    log.warn("There is no .gitignore file in this repository, creating one...");
+    spinner.warn(
+      "There is no .gitignore file in this repository, creating one..."
+    );
     import_fs_extra2.default.writeFileSync(
       ".gitignore",
       `node_modules
@@ -276,13 +277,20 @@ function initializeGit() {
 }
 
 // src/util/examples.ts
-var import_node_stream = require("stream");
-var import_promises = require("stream/promises");
+var import_node_stream = require("node:stream");
+var import_promises = require("node:stream/promises");
 var import_tar = require("tar");
 async function getRepoInfo(url, examplePath) {
   const [, username, name2, t, _branch, ...file] = url.pathname.split("/");
   const filePath = examplePath ? examplePath.replace(/^\//, "") : file.join("/");
-  if (t === void 0 || t === "" && _branch === void 0) {
+  if (
+    // Support repos whose entire purpose is to be a Next.js example, e.g.
+    // https://github.com/:username/:my-cool-nextjs-example-repo-name.
+    t === void 0 || // Support GitHub URL that ends with a trailing slash, e.g.
+    // https://github.com/:username/:my-cool-nextjs-example-repo-name/
+    // In this case "t" will be an empty string while the next part "_branch" will be undefined
+    t === "" && _branch === void 0
+  ) {
     try {
       const infoResponse = await fetch(
         `https://api.github.com/repos/${username}/${name2}`
@@ -329,52 +337,71 @@ var import_path3 = __toESM(require("path"));
 var TEMPLATES = [
   {
     title: "\u2B50 NextJS starter",
-    description: "Kickstart your project with NextJS \u2013 our top recommendation for a seamless, performant, and versatile web experience.",
-    value: "tina-cloud-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,
+    gitURL: "https://github.com/tinacms/tina-nextjs-starter",
+    devUrl: "http://localhost:3000"
+  },
+  {
+    title: "\u2B50\uFE0F TinaDocs",
+    description: "Get your documentation site up and running with TinaCMS and Next.js in minutes.",
+    value: "tina-docs",
+    isInternal: false,
+    gitURL: "https://github.com/tinacms/tina-docs",
+    devUrl: "http://localhost:3000"
+  },
+  {
+    title: "Astro Starter",
+    description: "Get started with Astro - a modern static site generator designed for fast, lightweight, and flexible web projects.",
+    value: "tina-astro-starter",
     isInternal: false,
-    gitURL: "https://github.com/tinacms/tina-cloud-starter"
+    gitURL: "https://github.com/tinacms/tina-astro-starter",
+    devUrl: "http://localhost:4321"
   },
   {
     title: "Hugo Starter",
     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,
-    gitURL: "https://github.com/tinacms/tina-hugo-starter"
+    gitURL: "https://github.com/tinacms/tina-hugo-starter",
+    devUrl: "http://localhost:1313"
   },
   {
     title: "Remix Starter",
     description: "Dive into Remix to orchestrate seamless, interactive user journeys like a maestro of the web.",
     value: "tina-remix-starter",
     isInternal: false,
-    gitURL: "https://github.com/tinacms/tina-remix-starter"
+    gitURL: "https://github.com/tinacms/tina-remix-starter",
+    devUrl: "http://localhost:3000"
   },
   {
     title: "Docusaurus Starter",
     description: "Docusaurus empowers you to build and evolve documentation like crafting a living, breathing knowledge repository.",
     value: "tinasaurus",
     isInternal: false,
-    gitURL: "https://github.com/tinacms/tinasaurus"
+    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.",
     value: "basic",
     isInternal: false,
-    gitURL: "https://github.com/tinacms/tina-barebones-starter"
+    gitURL: "https://github.com/tinacms/tina-barebones-starter",
+    devUrl: "http://localhost:3000"
   }
 ];
-async function downloadTemplate(template, root) {
+async function downloadTemplate(template, root, spinner) {
   if (template.isInternal === false) {
     const repoURL = new URL(template.gitURL);
     const repoInfo = await getRepoInfo(repoURL);
     if (!repoInfo) {
       throw new Error("Repository information not found.");
     }
-    log.info(
-      `Downloading files from repo ${TextStyles.link(
-        `${repoInfo == null ? void 0 : repoInfo.username}/${repoInfo == null ? void 0 : repoInfo.name}`
-      )}.`
-    );
+    spinner.text = `Downloading files from repo ${TextStyles.tinaOrange(
+      `${repoInfo?.username}/${repoInfo?.name}`
+    )}`;
     await downloadAndExtractRepo(root, repoInfo);
   } else {
     const templateFile = import_path3.default.join(__dirname, "..", "examples", template.value);
@@ -383,17 +410,21 @@ async function downloadTemplate(template, root) {
 }
 
 // src/util/preRunChecks.ts
-var SUPPORTED_NODE_VERSIONS = ["18", "20", "22"];
-function preRunChecks() {
-  checkSupportedNodeVersion();
-}
-function checkSupportedNodeVersion() {
-  if (!SUPPORTED_NODE_VERSIONS.some(
-    (version2) => process.version.startsWith(`v${version2}`)
-  )) {
-    log.warn(
-      `Version ${process.version} of Node.js is not supported in create-tina-app, please update to the latest LTS version. See https://nodejs.org/en/download/ for more details.`
+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}`)
+);
+function preRunChecks(spinner) {
+  spinner.start("Running pre-run checks...");
+  if (!isSupported) {
+    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.`
     );
+  } else {
+    spinner.succeed(`Node ${process.version} is supported.`);
   }
 }
 
@@ -416,14 +447,20 @@ async function checkPackageExists(name2) {
 }
 
 // src/index.ts
-var import_node_process = require("process");
-var import_validate_npm_package_name = __toESM(require("validate-npm-package-name"));
-var PKG_MANAGERS = ["npm", "yarn", "pnpm"];
-async function run() {
-  preRunChecks();
+var import_node_process = require("node:process");
+
+// src/util/options.ts
+var import_commander = require("commander");
+var import_package = __toESM(require_package());
+
+// src/util/packageManagers.ts
+var PKG_MANAGERS = ["npm", "yarn", "pnpm", "bun"];
+
+// src/util/options.ts
+function extractOptions(args) {
   let projectName = "";
-  const program = new import_commander.Command(name);
-  program.version(version).option(
+  const program = new import_commander.Command(import_package.name);
+  program.version(import_package.version).option(
     "-t, --template <template>",
     `Choose which template to start from. Valid templates are: ${TEMPLATES.map(
       (x2) => x2.value
@@ -434,20 +471,82 @@ async function run() {
   ).option(
     "-d, --dir <dir>",
     "Choose which directory to run this script from."
-  ).option("--noTelemetry", "Disable anonymous telemetry that is collected.").arguments("[project-directory]").usage(`${TextStyles.success("<project-directory>")} [options]`).action((name2) => {
+  ).option("-v, --verbose", "Enable verbose output.").option("--noTelemetry", "Disable anonymous telemetry that is collected.").arguments("[project-directory]").usage(`${TextStyles.success("<project-directory>")} [options]`).action((name2) => {
     projectName = name2;
   });
-  program.parse(process.argv);
+  program.parse(args);
   const opts = program.opts();
   if (opts.dir) {
     process.chdir(opts.dir);
   }
-  const telemetry = new import_metrics.Telemetry({ disabled: opts == null ? void 0 : opts.noTelemetry });
-  let template = opts.template;
-  if (template) {
-    template = TEMPLATES.find((_template) => _template.value === template);
+  if (projectName) {
+    opts.projectName = projectName;
+  }
+  return opts;
+}
+
+// src/index.ts
+var import_validate_npm_package_name = __toESM(require("validate-npm-package-name"));
+
+// 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 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
+var THEMES = [
+  {
+    title: "Default",
+    description: "The default monochromatic theme for your documentation site",
+    value: "default"
+  },
+  {
+    title: "Tina",
+    description: "The warm color scheme of TinaCMS for your documentation",
+    value: "tina"
+  },
+  {
+    title: "Blossom",
+    value: "blossom",
+    description: "A Blossom theme for your project"
+  },
+  {
+    title: "Lake",
+    value: "lake",
+    description: "A Lake theme for your project"
+  },
+  {
+    title: "Pine",
+    value: "pine",
+    description: "A Pine theme for your project"
+  },
+  {
+    title: "Indigo",
+    value: "indigo",
+    description: "An Indigo theme for your project"
+  }
+];
+
+// src/index.ts
+async function run() {
+  const ora = (await import("ora")).default;
+  let packageManagerInstallationHadError = false;
+  if (process.stdout.columns >= 60) {
+    console.log(TextStyles.tinaOrange(`${llama}`));
+    console.log(TextStyles.tinaOrange(`${tinaCms}`));
+  } else {
+    console.log(TextStyles.tinaOrange(`\u{1F999} TinaCMS`));
+  }
+  const version2 = require_package().version;
+  console.log(`Create Tina App v${version2}`);
+  const spinner = ora();
+  preRunChecks(spinner);
+  const opts = extractOptions(process.argv);
+  const telemetry = new import_metrics.Telemetry({ disabled: opts?.noTelemetry });
+  let template = null;
+  if (opts.template) {
+    template = TEMPLATES.find((_template) => _template.value === opts.template);
     if (!template) {
-      log.err(
+      spinner.fail(
         `The provided template '${opts.template}' is invalid. Please provide one of the following: ${TEMPLATES.map(
           (x2) => x2.value
         )}`
@@ -458,7 +557,7 @@ async function run() {
   let pkgManager = opts.pkgManager;
   if (pkgManager) {
     if (!PKG_MANAGERS.find((_pkgManager) => _pkgManager === pkgManager)) {
-      log.err(
+      spinner.fail(
         `The provided package manager '${opts.pkgManager}' is not supported. Please provide one of the following: ${PKG_MANAGERS}`
       );
       (0, import_node_process.exit)(1);
@@ -472,7 +571,7 @@ async function run() {
       }
     }
     if (installedPkgManagers.length === 0) {
-      log.err(
+      spinner.fail(
         `You have no supported package managers installed. Please install one of the following: ${PKG_MANAGERS}`
       );
       (0, import_node_process.exit)(1);
@@ -485,10 +584,10 @@ async function run() {
         return { title: manager, value: manager };
       })
     });
-    if (!Object.hasOwn(res, "packageManager"))
-      (0, import_node_process.exit)(1);
+    if (!Object.hasOwn(res, "packageManager")) (0, import_node_process.exit)(1);
     pkgManager = res.packageManager;
   }
+  let projectName = opts.projectName;
   if (!projectName) {
     const res = await (0, import_prompts.default)({
       name: "name",
@@ -499,13 +598,11 @@ async function run() {
         const { validForNewPackages, errors } = (0, import_validate_npm_package_name.default)(
           import_node_path.default.basename(import_node_path.default.resolve(name2))
         );
-        if (validForNewPackages)
-          return true;
-        return "Invalid project name: " + errors[0];
+        if (validForNewPackages) return true;
+        return `Invalid project name: ${errors[0]}`;
       }
     });
-    if (!Object.hasOwn(res, "name"))
-      (0, import_node_process.exit)(1);
+    if (!Object.hasOwn(res, "name")) (0, import_node_process.exit)(1);
     projectName = res.name;
   }
   if (!template) {
@@ -515,65 +612,109 @@ async function run() {
       message: "What starter code would you like to use?",
       choices: TEMPLATES
     });
-    if (!Object.hasOwn(res, "template"))
-      (0, import_node_process.exit)(1);
+    if (!Object.hasOwn(res, "template")) (0, import_node_process.exit)(1);
     template = TEMPLATES.find((_template) => _template.value === res.template);
   }
+  let themeChoice;
+  if (template.value === "tina-docs") {
+    const res = await (0, import_prompts.default)({
+      name: "theme",
+      type: "select",
+      message: "What theme would you like to use?",
+      choices: THEMES
+    });
+    if (!Object.hasOwn(res, "theme")) (0, import_node_process.exit)(1);
+    themeChoice = res.theme;
+  }
   await telemetry.submitRecord({
     event: {
       name: "create-tina-app:invoke",
-      template,
+      template: template.value,
       pkgManager
     }
   });
   const rootDir = import_node_path.default.join(process.cwd(), projectName);
   if (!await isWriteable(import_node_path.default.dirname(rootDir))) {
-    log.err(
+    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."
     );
     process.exit(1);
   }
-  const appName = await setupProjectDirectory(rootDir);
+  let appName;
+  try {
+    appName = await setupProjectDirectory(rootDir);
+  } catch (err) {
+    spinner.fail(err.message);
+    (0, import_node_process.exit)(1);
+  }
   try {
-    await downloadTemplate(template, rootDir);
+    await downloadTemplate(template, rootDir, spinner);
+    if (themeChoice) {
+      await updateThemeSettings(rootDir, themeChoice);
+    }
+    spinner.start("Downloading template...");
+    await downloadTemplate(template, rootDir, spinner);
+    spinner.succeed();
+    spinner.start("Updating project metadata...");
     updateProjectPackageName(rootDir, projectName);
     updateProjectPackageVersion(rootDir, "0.0.1");
+    spinner.succeed();
   } catch (err) {
-    log.err(`Failed to download template: ${err.message}`);
+    spinner.fail(`Failed to download template: ${err.message}`);
     (0, import_node_process.exit)(1);
   }
-  log.info("Installing packages.");
-  await install(rootDir, null, { packageManager: pkgManager, isOnline: true });
-  log.info("Initializing git repository.");
+  spinner.start("Installing packages.");
   try {
-    if (initializeGit()) {
+    await install(pkgManager, opts.verbose);
+    spinner.succeed();
+  } catch (err) {
+    spinner.fail(`Failed to install packages: ${err.message}`);
+    packageManagerInstallationHadError = true;
+  }
+  spinner.start("Initializing git repository.");
+  try {
+    if (initializeGit(spinner)) {
       makeFirstCommit(rootDir);
-      log.info("Initialized git repository.");
+      spinner.succeed();
     }
   } catch (err) {
-    log.err("Failed to initialize Git repository, skipping.");
-  }
-  log.success("Starter successfully created!");
-  log.log(TextStyles.bold("\nTo launch your app, run:\n"));
-  log.cmd(`cd ${appName}
-${pkgManager} run dev`);
-  log.log(`
-Next steps:
-    \u2022 \u{1F4DD} Edit some content on ${TextStyles.link(
-    "http://localhost:3000"
-  )} (See ${TextStyles.link("https://tina.io/docs/using-tina-editor")})
-    \u2022 \u{1F4D6} Learn the basics: ${TextStyles.link("https://tina.io/docs/schema/")}
-    \u2022 \u{1F58C}\uFE0F Extend Tina with custom field components: ${TextStyles.link(
-    "https://tina.io/docs/advanced/extending-tina/"
-  )}
-    \u2022 \u{1F680} Deploy to Production: ${TextStyles.link(
-    "https://tina.io/docs/tina-cloud/"
-  )}
-  `);
+    spinner.fail("Failed to initialize Git repository, skipping.");
+  }
+  spinner.succeed(`Created ${TextStyles.tinaOrange(appName)}
+`);
+  if (template.value === "tina-hugo-starter") {
+    spinner.warn(
+      `Hugo is required for this starter. Install it via ${TextStyles.link("https://gohugo.io/installation/")}
+`
+    );
+  }
+  const padCommand = (cmd, width = 20) => TextStyles.cmd(cmd) + " ".repeat(Math.max(0, width - cmd.length));
+  spinner.info(`${TextStyles.bold("To get started:")}
+
+  ${padCommand(`cd ${appName}`)}# move into your project directory${packageManagerInstallationHadError ? `
+  ${padCommand(`${pkgManager} install`)}# install dependencies` : ""}
+  ${padCommand(`${pkgManager} run dev`)}# start the dev server ${TextStyles.link(template.devUrl)}
+  ${padCommand(`${pkgManager} run build`)}# build the app for production
+`);
+  console.log("Next steps:");
+  console.log(
+    `  \u2022 \u{1F4DD} Edit some content: ${TextStyles.link("https://tina.io/docs/using-tina-editor")}`
+  );
+  console.log(
+    `  \u2022 \u{1F4D6} Learn the basics: ${TextStyles.link("https://tina.io/docs/schema/")}`
+  );
+  console.log(
+    `  \u2022 \u{1F58C}\uFE0F Extend Tina with custom field components: ${TextStyles.link("https://tina.io/docs/advanced/extending-tina/")}`
+  );
+  console.log(
+    `  \u2022 \u{1F680} Deploy to Production: ${TextStyles.link("https://tina.io/docs/tinacloud/")}`
+  );
 }
-run();
+run().catch((error) => {
+  console.error("Error running create-tina-app:", error);
+  process.exit(1);
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  PKG_MANAGERS,
   run
 });

package/dist/templates.d.ts

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

package/dist/themes.d.ts

@@ -0,0 +1,7 @@
+type TinaDocsTheme = {
+    title: string;
+    value: string;
+    description: string;
+};
+export declare const THEMES: TinaDocsTheme[];
+export {};

package/dist/util/asciiArt.d.ts

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

package/dist/util/checkPkgManagers.d.ts

@@ -1,2 +1,2 @@
-import { PKG_MANAGERS } from '..';
-export declare function checkPackageExists(name: (typeof PKG_MANAGERS)[number]): Promise<boolean>;
+import { PackageManager } from './packageManagers';
+export declare function checkPackageExists(name: PackageManager): Promise<boolean>;

package/dist/util/fileUtil.d.ts

@@ -3,3 +3,4 @@ export declare function folderContainsInstallConflicts(root: string): string[];
 export declare function setupProjectDirectory(dir: string): Promise<string>;
 export declare function updateProjectPackageName(dir: string, name: string): void;
 export declare function updateProjectPackageVersion(dir: string, version: string): void;
+export declare function updateThemeSettings(dir: string, selectedTheme: string): Promise<void>;

package/dist/util/git.d.ts

@@ -1,2 +1,3 @@
+import { Ora } from 'ora';
 export declare function makeFirstCommit(root: string): void;
-export declare function initializeGit(): boolean;
+export declare function initializeGit(spinner: Ora): boolean;

package/dist/util/install.d.ts

@@ -1,21 +1,7 @@
-interface InstallArgs {
-    /**
-     * The package manager to use (yarn, npm, pnpm).
-     */
-    packageManager: 'yarn' | 'npm' | 'pnpm';
-    /**
-     * Indicate whether there is an active Internet connection.
-     */
-    isOnline: boolean;
-    /**
-     * Indicate whether the given dependencies are devDependencies.
-     */
-    devDependencies?: boolean;
-}
+import { PackageManager } from './packageManagers';
 /**
- * Spawn a package manager installation with Yarn, NPM, or PNPM.
+ * Spawn a package manager installation.
  *
  * @returns A Promise that resolves once the installation is finished.
  */
-export declare function install(root: string, dependencies: string[] | null, { packageManager, isOnline, devDependencies }: InstallArgs): Promise<void>;
-export {};
+export declare function install(packageManager: PackageManager, verboseOutput: boolean): Promise<void>;

package/dist/util/options.d.ts

@@ -0,0 +1,9 @@
+export interface CreateOptions {
+    template: string;
+    pkgManager: string;
+    dir: string;
+    noTelemetry: boolean;
+    projectName: string;
+    verbose: boolean;
+}
+export declare function extractOptions(args: string[]): CreateOptions;

package/dist/util/packageManagers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The available package managers a user can use.
+ * To add a new supported package manager, add the usage command to this list.
+ * The `PackageManager` type will be automatically updated as a result.
+ */
+export declare const PKG_MANAGERS: readonly ["npm", "yarn", "pnpm", "bun"];
+export type PackageManager = (typeof PKG_MANAGERS)[number];

package/dist/util/preRunChecks.d.ts

@@ -1,2 +1,2 @@
-export declare const SUPPORTED_NODE_VERSIONS: string[];
-export declare function preRunChecks(): void;
+import { Ora } from 'ora';
+export declare function preRunChecks(spinner: Ora): void;

package/dist/util/textstyles.d.ts

@@ -0,0 +1,11 @@
+import chalk from 'chalk';
+export declare const TextStyles: {
+    tinaOrange: chalk.Chalk;
+    link: (url: string) => string;
+    cmd: chalk.Chalk;
+    info: chalk.Chalk;
+    success: chalk.Chalk;
+    warn: chalk.Chalk;
+    err: chalk.Chalk;
+    bold: chalk.Chalk;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tina-app",
-  "version": "0.0.0-d80714b-20241205222511",
+  "version": "0.0.0-d9487bf-20251119052214",
   "main": "dist/index.js",
   "files": [
     "dist",
@@ -31,21 +31,22 @@
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.9.0",
+    "@types/node": "^22.13.1",
     "@types/prompts": "^2.4.9",
     "@types/tar": "6.1.13",
-    "typescript": "^5.6.3",
-    "@tinacms/scripts": "1.3.1"
+    "typescript": "^5.7.3",
+    "@tinacms/scripts": "0.0.0-d9487bf-20251119052214"
   },
   "dependencies": {
     "chalk": "4.1.2",
     "commander": "^12.1.0",
-    "cross-spawn": "^7.0.5",
-    "fs-extra": "^11.2.0",
+    "cross-spawn": "^7.0.6",
+    "fs-extra": "^11.3.0",
+    "ora": "^8.2.0",
     "prompts": "^2.4.2",
     "tar": "7.4.0",
     "validate-npm-package-name": "^5.0.1",
-    "@tinacms/metrics": "1.0.8"
+    "@tinacms/metrics": "1.1.0"
   },
   "scripts": {
     "types": "pnpm tsc",

package/dist/util/logger.d.ts

@@ -1,20 +0,0 @@
-import chalk from 'chalk';
-export declare const TextStyles: {
-    link: chalk.Chalk;
-    cmd: chalk.Chalk;
-    info: chalk.Chalk;
-    success: chalk.Chalk;
-    warn: chalk.Chalk;
-    err: chalk.Chalk;
-    bold: chalk.Chalk;
-};
-export declare class Logger {
-    log(message: string): void;
-    debug(message: string): void;
-    info(message: string): void;
-    success(message: string): void;
-    cmd(message: string): void;
-    warn(message: string): void;
-    err(message: string): void;
-}
-export declare const log: Logger;