@create-node-app/core 0.6.0 → 0.6.1

package/README.md

@@ -0,0 +1,148 @@
+<div align="center">
+
+<h1>⚙️ <code>@create-node-app/core</code></h1>
+
+<p><strong>Programmatic engine behind Create Awesome Node App.</strong><br/>
+Import the scaffolding pipeline — composable, headless, and CI-ready.</p>
+
+[![npm][npmversion]][npmurl]
+[![Downloads][npmdownloads]][npmurl]
+[![License: MIT][licensebadge]][licenseurl]
+
+</div>
+
+---
+
+## Installation
+
+```bash
+npm install @create-node-app/core
+```
+
+Requires **Node.js >= 22**.
+
+> This is the _engine_ package. For the interactive CLI, use [`create-awesome-node-app`](https://www.npmjs.com/package/create-awesome-node-app) instead.
+
+---
+
+## Usage
+
+### Scaffold a project programmatically
+
+```ts
+import { createNodeApp, getTemplateDirPath } from "@create-node-app/core";
+
+await createNodeApp(
+  "my-app",
+  {
+    projectName: "my-app",
+    template: "react-vite-boilerplate",
+  },
+  (options) => Promise.resolve(options),
+);
+```
+
+### Check environment info
+
+```ts
+import { printEnvInfo } from "@create-node-app/core";
+
+await printEnvInfo();
+// Prints OS, CPU, Node, npm, browsers, etc. Then exits.
+```
+
+### Validate the Node.js version
+
+```ts
+import { checkNodeVersion } from "@create-node-app/core";
+
+checkNodeVersion(">=22", "my-tool");
+// Exits with a red error message if the version doesn't match.
+```
+
+---
+
+## API Reference
+
+All exports from `@create-node-app/core`:
+
+### Functions
+
+| Signature | Description |
+|-----------|-------------|
+| `createNodeApp(programName, options, transformOptions)` | Main scaffolding orchestrator. Resolves the template, copies files, merges configs, installs deps, and initializes git. |
+| `checkNodeVersion(requiredVersion, packageName)` | Compares `process.version` against a semver range. Exits with code 1 if too old. |
+| `checkForLatestVersion(packageName)` | Fetches the latest version from the npm registry. Falls back to `npm view`. Returns `null` if both fail. |
+| `printEnvInfo()` | Prints OS, CPU, binaries, and browser info to stdout, then exits. |
+| `getPackagePath(templateOrExtension, name?, ignorePackage?)` | Resolves a file path inside a template/extension directory (usually `package.json`). Handles GitHub URLs, `file://` URLs, and legacy slugs. |
+| `getTemplateDirPath(templateOrExtensionUrl)` | Resolves the template directory. Looks for a `template/` subdirectory first, falls back to the resolved root. |
+| `getTemplateBaseDirPath(templateOrExtensionUrl)` | Returns the parent of the `template/` directory (where `cna.config.json` lives). |
+| `downloadRepository(options)` | Clones or pulls a Git repo into a cache dir, then copies files to the target. Supports offline mode, deduplication, and error formatting. |
+| `loadTemplateCnaConfig(templateUrl)` | Loads the optional `cna.config.json` from a template's base directory. |
+
+### Types
+
+| Type | Shape |
+|------|-------|
+| `CnaOptions` | `{ projectName, info?, verbose?, packageManager?, install?, template?, templatesOrExtensions?, ... }` |
+| `CnaOptionsTransform` | `(options: CnaOptions) => Promise<CnaOptions>` |
+| `CnaConfig` | `{ customOptions?: CnaCustomOption[] }` |
+| `CnaCustomOption` | `{ name, type, message?, initial?, ... }` |
+| `TemplateOrExtension` | `{ url: string; ignorePackage?: boolean }` |
+
+---
+
+## How It Works
+
+```
+createNodeApp()
+  ├── checkNodeVersion()
+  ├── printEnvInfo() if info flag
+  ├── resolve templates/extensions via getTemplateDirPath()
+  ├── download Git repos via downloadRepository()
+  ├── load cna.config.json via loadTemplateCnaConfig()
+  ├── merge package.json files via lodash.merge
+  ├── copy/process template files (Lodash interpolation, .if-npm, .append, etc.)
+  ├── install dependencies (npm/yarn/pnpm/bun)
+  ├── git init
+  └── format + lint:fix post-install
+```
+
+---
+
+## Architecture
+
+The package is organized into these modules:
+
+| Module | Responsibility |
+|--------|---------------|
+| `index.ts` | Barrel export and main `createNodeApp` orchestration |
+| `installer.ts` | Project directory creation, dep installation, git init, post-install scripts |
+| `loaders.ts` | File discovery, classification (`.template`, `.append`, conditional prefixes), and processing |
+| `package.ts` | Deep-merges `package.json` from multiple templates/extensions |
+| `paths.ts` | URL resolution — GitHub branches, `file://`, legacy slugs, cache at `~/.cna/` |
+| `git.ts` | Clone/pull with deduplication, offline support, error formatting |
+| `config.ts` | Reads optional `cna.config.json` for custom CLI prompts |
+| `helpers.ts` | Package manager detection, online check, path/naming utilities |
+
+---
+
+## Related
+
+- [`create-awesome-node-app`](https://www.npmjs.com/package/create-awesome-node-app) — Interactive CLI built on this core
+- [Create Node App](https://github.com/Create-Node-App/create-node-app) — Monorepo
+- [Templates catalog](https://github.com/Create-Node-App/cna-templates)
+
+---
+
+## License
+
+MIT &copy; [Create Node App Contributors](https://github.com/Create-Node-App/create-node-app/graphs/contributors)
+
+<!-- Reference links -->
+
+[npmversion]: https://img.shields.io/npm/v/@create-node-app/core.svg?style=flat-square&color=cb3837
+[npmdownloads]: https://img.shields.io/npm/dm/@create-node-app/core.svg?style=flat-square&color=cb3837
+[licensebadge]: https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square
+[npmurl]: https://www.npmjs.com/package/@create-node-app/core
+[licenseurl]: https://github.com/Create-Node-App/create-node-app/blob/main/LICENSE

package/dist/index.cjs

@@ -47,7 +47,7 @@ var import_semver3 = __toESM(require("semver"), 1);
 var import_child_process3 = require("child_process");
 
 // installer.ts
-var import_underscore2 = __toESM(require("underscore"), 1);
+var import_lodash3 = __toESM(require("lodash"), 1);
 var import_path4 = __toESM(require("path"), 1);
 var import_fs5 = __toESM(require("fs"), 1);
 var import_picocolors3 = __toESM(require("picocolors"), 1);
@@ -62,6 +62,11 @@ var import_picocolors = __toESM(require("picocolors"), 1);
 var import_semver = __toESM(require("semver"), 1);
 var import_dns = __toESM(require("dns"), 1);
 var import_url = require("url");
+
+// executable.ts
+var resolveExecutable = (bin) => process.platform === "win32" ? `${bin}.cmd` : bin;
+
+// helpers.ts
 var shouldUseYarn = () => {
   const { hasMinYarnPnp, hasMaxYarnPnp, yarnVersion } = checkYarnVersion();
   if (!hasMinYarnPnp) {
@@ -98,6 +103,20 @@ var shouldUsePnpm = () => {
   }
   return true;
 };
+var shouldUseBun = () => {
+  const { hasMinBun, bunVersion } = checkBunVersion();
+  if (!hasMinBun) {
+    console.log(
+      import_picocolors.default.yellow(
+        `You are using bun version ${import_picocolors.default.bold(
+          bunVersion
+        )} which is not supported yet. To use bun, install v1.0.0 or higher. See https://bun.sh for instructions on how to install.`
+      )
+    );
+    return false;
+  }
+  return true;
+};
 var checkThatNpmCanReadCwd = () => {
   const cwd = process.cwd();
   let childOutput = null;
@@ -153,7 +172,7 @@ var checkPnpmVersion = () => {
   let hasMinPnpm = false;
   let pnpmVersion = null;
   try {
-    pnpmVersion = (0, import_child_process.execSync)("pnpm --version").toString().trim();
+    pnpmVersion = (0, import_child_process.execFileSync)(resolveExecutable("pnpm"), ["--version"]).toString().trim();
     if (import_semver.default.valid(pnpmVersion)) {
       hasMinPnpm = import_semver.default.gte(pnpmVersion, minPnpm);
     } else {
@@ -166,6 +185,19 @@ var checkPnpmVersion = () => {
   }
   return { hasMinPnpm, pnpmVersion };
 };
+var checkBunVersion = () => {
+  const minBun = "1.0.0";
+  let hasMinBun = false;
+  let bunVersion = null;
+  try {
+    bunVersion = (0, import_child_process.execFileSync)(resolveExecutable("bun"), ["--version"]).toString().trim();
+    if (import_semver.default.valid(bunVersion)) {
+      hasMinBun = import_semver.default.gte(bunVersion, minBun);
+    }
+  } catch {
+  }
+  return { hasMinBun, bunVersion };
+};
 var checkYarnVersion = () => {
   const minYarnPnp = "1.12.0";
   const maxYarnPnp = "2.0.0";
@@ -173,7 +205,7 @@ var checkYarnVersion = () => {
   let hasMaxYarnPnp = false;
   let yarnVersion = null;
   try {
-    yarnVersion = (0, import_child_process.execSync)("yarnpkg --version").toString().trim();
+    yarnVersion = (0, import_child_process.execFileSync)(resolveExecutable("yarnpkg"), ["--version"]).toString().trim();
     if (import_semver.default.valid(yarnVersion)) {
       hasMinYarnPnp = import_semver.default.gte(yarnVersion, minYarnPnp);
       hasMaxYarnPnp = import_semver.default.lt(yarnVersion, maxYarnPnp);
@@ -199,7 +231,7 @@ var checkNpmVersion = () => {
   let hasMinNpm = false;
   let npmVersion = null;
   try {
-    npmVersion = (0, import_child_process.execSync)("npm --version").toString().trim();
+    npmVersion = (0, import_child_process.execFileSync)(resolveExecutable("npm"), ["--version"]).toString().trim();
     hasMinNpm = import_semver.default.gte(npmVersion, "6.0.0");
   } catch {
   }
@@ -213,7 +245,11 @@ var getProxy = () => {
     return process.env.HTTPS_PROXY;
   }
   try {
-    const httpsProxy = (0, import_child_process.execSync)("npm config get https-proxy").toString().trim();
+    const httpsProxy = (0, import_child_process.execFileSync)(resolveExecutable("npm"), [
+      "config",
+      "get",
+      "https-proxy"
+    ]).toString().trim();
     return httpsProxy !== "null" ? httpsProxy : void 0;
   } catch {
   }
@@ -245,6 +281,8 @@ var import_lodash = __toESM(require("lodash.merge"), 1);
 var import_fs2 = __toESM(require("fs"), 1);
 var import_os2 = __toESM(require("os"), 1);
 var import_path2 = __toESM(require("path"), 1);
+var import_url2 = require("url");
+var import_debug2 = __toESM(require("debug"), 1);
 
 // git.ts
 var import_os = __toESM(require("os"), 1);
@@ -254,6 +292,35 @@ var import_debug = __toESM(require("debug"), 1);
 var import_simple_git = require("simple-git");
 var fse = __toESM(require("fs-extra"), 1);
 var log = (0, import_debug.default)("cna:git");
+var formatRepositoryDownloadError = (error, url) => {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/not found|404|repository not found/i.test(message)) {
+    return [
+      `Error: Could not fetch template from '${url}'.`,
+      "  \u2192 The URL returned HTTP 404 or the repository was not found. Please verify the URL is correct.",
+      "  \u2192 Run 'npx create-awesome-node-app --list-templates' to see available templates."
+    ].join("\n");
+  }
+  if (/403|authentication|permission denied|access denied/i.test(message)) {
+    return [
+      `Error: Could not fetch template from '${url}'.`,
+      "  \u2192 Access denied (HTTP 403). Check that the repository is public or you have access.",
+      "  \u2192 Run 'npx create-awesome-node-app --list-templates' to see available templates."
+    ].join("\n");
+  }
+  if (/ECONNREFUSED|ENOTFOUND|ETIMEDOUT|network/i.test(message)) {
+    return [
+      `Error: Could not fetch template from '${url}'.`,
+      "  \u2192 Could not reach the repository. Please check your internet connection.",
+      "  \u2192 Run 'npx create-awesome-node-app --list-templates' to see available templates."
+    ].join("\n");
+  }
+  return [
+    `Error: Could not fetch template from '${url}'.`,
+    `  \u2192 ${message}`,
+    "  \u2192 Run 'npx create-awesome-node-app --list-templates' to see available templates."
+  ].join("\n");
+};
 var filterGit = (src) => {
   return !/(\\|\/)\.git\b/.test(src);
 };
@@ -268,6 +335,7 @@ var downloadRepository = async ({
   cacheDir: optsCacheDir
 }) => {
   const absoluteTarget = import_path.default.isAbsolute(target) ? target : import_path.default.resolve(target);
+  const targetExistedBefore = import_fs.default.existsSync(absoluteTarget);
   const isGithub = /^[^/]+\/[^/]+$/.test(url);
   const gitUrl = isGithub ? `https://github.com/${url}` : url;
   const id = targetId || Buffer.from(`${gitUrl}@${branch}`).toString("base64");
@@ -318,7 +386,15 @@ var downloadRepository = async ({
       });
       completedTargetIds.set(id, true);
     } catch (error) {
-      console.error("Error during repository download:", error);
+      if (!targetExistedBefore && import_fs.default.existsSync(absoluteTarget)) {
+        try {
+          fse.removeSync(absoluteTarget);
+          log("Cleaned up partially created directory: %s", absoluteTarget);
+        } catch (cleanupErr) {
+          log("Failed to clean up directory: %s", cleanupErr);
+        }
+      }
+      throw new Error(formatRepositoryDownloadError(error, gitUrl));
     } finally {
       gitOperationMap.delete(id);
     }
@@ -328,6 +404,9 @@ var downloadRepository = async ({
 };
 
 // paths.ts
+var import_meta = {};
+var log2 = (0, import_debug2.default)("cna:paths");
+var moduleDir = typeof __dirname !== "undefined" ? __dirname : import_path2.default.dirname((0, import_url2.fileURLToPath)(import_meta.url));
 var solveValuesFromTemplateOrExtensionUrl = (templateOrExtension) => {
   const url = new URL(templateOrExtension);
   const ignorePackage = url.searchParams.get("ignorePackage") === "true";
@@ -381,30 +460,23 @@ var solveRepositoryPath = async ({
   if (process.env.CNA_SKIP_GIT === "1") {
     return { dir: target, subdir };
   }
-  try {
-    await downloadRepository({
-      url,
-      branch: branch || "",
-      target,
-      targetId
-    });
-  } catch {
-  }
+  await downloadRepository({
+    url,
+    branch: branch || "",
+    target,
+    targetId
+  });
   return { dir: target, subdir };
 };
 var solveTemplateOrExtensionPath = async (templateOrExtension) => {
+  let parsed;
   try {
-    const { url, branch, subdir, protocol, pathname, ignorePackage } = solveValuesFromTemplateOrExtensionUrl(templateOrExtension);
-    if (protocol === "file:") {
-      const baseDir = pathname;
-      return { dir: baseDir, subdir, ignorePackage };
-    }
-    const gitData = await solveRepositoryPath({ url, branch, subdir });
-    return { dir: gitData.dir, subdir: gitData.subdir, ignorePackage };
+    parsed = solveValuesFromTemplateOrExtensionUrl(templateOrExtension);
   } catch {
+    log2("Falling back to legacy template path for: %s", templateOrExtension);
     return {
       dir: import_path2.default.resolve(
-        __dirname,
+        moduleDir,
         "..",
         "templatesOrExtensions",
         templateOrExtension
@@ -413,6 +485,12 @@ var solveTemplateOrExtensionPath = async (templateOrExtension) => {
       ignorePackage: void 0
     };
   }
+  const { url, branch, subdir, protocol, pathname, ignorePackage } = parsed;
+  if (protocol === "file:") {
+    return { dir: pathname, subdir, ignorePackage };
+  }
+  const gitData = await solveRepositoryPath({ url, branch, subdir });
+  return { dir: gitData.dir, subdir: gitData.subdir, ignorePackage };
 };
 var getPackagePath = async (templateOrExtension, name = "package", ignorePackage = false) => {
   const {
@@ -487,10 +565,10 @@ var loadPackages = async ({
   const setup = await Promise.all(
     templatesOrExtensions.map(async ({ url: templateOrExtension }) => {
       try {
-        const template = requireIfExists(
+        const template2 = requireIfExists(
           await getPackagePath(templateOrExtension, "template.json")
         );
-        return template.package || {};
+        return template2.package || {};
       } catch {
         return {};
       }
@@ -543,12 +621,13 @@ var loadPackages = async ({
 };
 
 // loaders.ts
-var import_underscore = __toESM(require("underscore"), 1);
 var import_fs4 = __toESM(require("fs"), 1);
 var import_picocolors2 = __toESM(require("picocolors"), 1);
 var import_readdirp = require("readdirp");
 var import_path3 = require("path");
 var import_util = require("util");
+var import_lodash2 = __toESM(require("lodash"), 1);
+var { template } = import_lodash2.default;
 var writeFileAsync = (0, import_util.promisify)(import_fs4.default.writeFile);
 var copyFileAsync = (0, import_util.promisify)(import_fs4.default.copyFile);
 var SRC_PATH_PATTERN = "[src]/";
@@ -577,6 +656,11 @@ var batchedCopyFiles = async (operations) => {
     try {
       makeDirectory((0, import_path3.dirname)(operation.dest));
       await copyFileAsync(operation.src, operation.dest);
+      try {
+        const srcStat = await (0, import_util.promisify)(import_fs4.default.stat)(operation.src);
+        await (0, import_util.promisify)(import_fs4.default.chmod)(operation.dest, srcStat.mode);
+      } catch {
+      }
       if (operation.verbose) {
         console.log(
           import_picocolors2.default.green(
@@ -646,7 +730,7 @@ var batchedAppendFiles = async (operations) => {
 var copyLoader = ({ root, templateDir, verbose, srcDir }) => async ({ path: path5 }) => {
   const operations = [];
   try {
-    const newPath = path5.replace(/.if-(npm|yarn|pnpm)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
+    const newPath = path5.replace(/.if-(npm|yarn|pnpm|bun)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
     operations.push({
       src: `${templateDir}/${path5}`,
       dest: `${root}/${newPath}`,
@@ -663,7 +747,7 @@ var copyLoader = ({ root, templateDir, verbose, srcDir }) => async ({ path: path
 var appendLoader = ({ root, templateDir, verbose, srcDir }) => async ({ path: path5 }) => {
   const operations = [];
   try {
-    const newPath = path5.replace(/.append$/, "").replace(/.if-(npm|yarn|pnpm)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
+    const newPath = path5.replace(/.append$/, "").replace(/.if-(npm|yarn|pnpm|bun)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
     operations.push({
       src: `${templateDir}/${path5}`,
       dest: `${root}/${newPath}`,
@@ -694,8 +778,8 @@ var templateLoader = ({
     const filePath = `${templateDir}/${path5}`;
     const file = await (0, import_util.promisify)(import_fs4.default.readFile)(filePath, "utf8");
     const fileMode = (await (0, import_util.promisify)(import_fs4.default.stat)(filePath)).mode;
-    const newFile = import_underscore.default.template(file);
-    const newPath = path5.replace(/.template$/, "").replace(/.append$/, "").replace(/.if-(npm|yarn|pnpm)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
+    const newFile = template(file);
+    const newPath = path5.replace(/.template$/, "").replace(/.append$/, "").replace(/.if-(npm|yarn|pnpm|bun)$/, "").replace(SRC_PATH_PATTERN, getSrcDirPattern(srcDir));
     operations.push({
       path: `${root}/${newPath}`,
       content: newFile({
@@ -725,6 +809,7 @@ var fileLoader = ({
   verbose,
   useYarn,
   usePnpm,
+  useBun,
   srcDir = DEFAULT_SRC_PATH,
   runCommand,
   installCommand,
@@ -747,6 +832,7 @@ var fileLoader = ({
       verbose,
       useYarn: !!useYarn,
       usePnpm: !!usePnpm,
+      useBun: !!useBun,
       mode,
       srcDir,
       runCommand,
@@ -770,6 +856,7 @@ var loadFiles = async ({
   verbose,
   useYarn = false,
   usePnpm = false,
+  useBun = false,
   srcDir = DEFAULT_SRC_PATH,
   runCommand,
   installCommand,
@@ -800,7 +887,7 @@ var loadFiles = async ({
           /\byarn\.lock$/,
           /\bpnpm-lock\.yaml$/
         ];
-        const skipManager = usePnpm ? [/\.if-npm\./, /\.if-yarn\./] : useYarn ? [/\.if-npm\./, /\.if-pnpm\./] : [/\.if-yarn\./, /\.if-pnpm\./];
+        const skipManager = usePnpm ? [/\.if-npm\./, /\.if-yarn\./, /\.if-bun\./] : useYarn ? [/\.if-npm\./, /\.if-pnpm\./, /\.if-bun\./] : useBun ? [/\.if-yarn\./, /\.if-pnpm\./] : [/\.if-yarn\./, /\.if-pnpm\./, /\.if-bun\./];
         const shouldSkip = (p) => [...skipGlobs, ...skipManager].some((rgx) => rgx.test(p));
         for await (const entry of (0, import_readdirp.readdirp)(templateDir, {
           type: "files",
@@ -820,6 +907,7 @@ var loadFiles = async ({
             verbose,
             useYarn,
             usePnpm,
+            useBun,
             srcDir,
             runCommand,
             installCommand,
@@ -855,7 +943,8 @@ var loadFiles = async ({
 };
 
 // installer.ts
-var install = async (root, useYarn = false, usePnpm = false, dependencies = [], verbose = false, isOnline = true, isDevDependencies = false) => {
+var { isEmpty } = import_lodash3.default;
+var install = async (root, useYarn = false, usePnpm = false, useBun = false, dependencies = [], verbose = false, isOnline = true, isDevDependencies = false) => {
   let command;
   let args;
   if (useYarn) {
@@ -884,6 +973,17 @@ var install = async (root, useYarn = false, usePnpm = false, dependencies = [],
       args.push("--save");
     }
     args.push(...dependencies);
+  } else if (useBun) {
+    command = "bun";
+    if (dependencies.length > 0) {
+      args = ["add"];
+      if (isDevDependencies) {
+        args.push("--dev");
+      }
+      args.push(...dependencies);
+    } else {
+      args = ["install"];
+    }
   } else {
     command = "npm";
     args = ["install", "--loglevel", "error"];
@@ -898,7 +998,7 @@ var install = async (root, useYarn = false, usePnpm = false, dependencies = [],
     args.push("--verbose");
   }
   try {
-    (0, import_child_process2.execSync)(`${command} ${args.join(" ")}`, {
+    (0, import_child_process2.execFileSync)(resolveExecutable(command), args, {
       cwd: root,
       stdio: "inherit"
     });
@@ -907,8 +1007,9 @@ var install = async (root, useYarn = false, usePnpm = false, dependencies = [],
   }
 };
 var runCommandInProjectDir = async (root, command, args = [], successMessage = "Operation completed successfully.", errorMessage = "Operation failed.") => {
+  const [executable, ...baseArgs] = command === "npm run" ? ["npm", "run"] : command === "pnpm run" ? ["pnpm", "run"] : command === "bun run" ? ["bun", "run"] : [command];
   try {
-    (0, import_child_process2.execSync)(`${command} ${args.join(" ")}`, {
+    (0, import_child_process2.execFileSync)(resolveExecutable(executable), [...baseArgs, ...args], {
       cwd: root,
       stdio: "ignore"
     });
@@ -936,6 +1037,7 @@ var run = async ({
   verbose = false,
   useYarn = false,
   usePnpm = false,
+  useBun = false,
   templatesOrExtensions = [],
   dependencies = [],
   devDependencies = [],
@@ -945,7 +1047,7 @@ var run = async ({
   ...customOptions
 }) => {
   const isOnline = useYarn ? await checkIfOnline(useYarn) : true;
-  if (import_underscore2.default.isEmpty(templatesOrExtensions)) {
+  if (isEmpty(templatesOrExtensions)) {
     console.log();
     console.log(
       import_picocolors3.default.yellow(
@@ -965,6 +1067,7 @@ var run = async ({
     verbose,
     useYarn,
     usePnpm,
+    useBun,
     runCommand,
     installCommand,
     ...customOptions
@@ -982,6 +1085,7 @@ var run = async ({
       root,
       useYarn,
       usePnpm,
+      useBun,
       dependencies,
       verbose,
       isOnline,
@@ -995,6 +1099,7 @@ var run = async ({
         root,
         useYarn,
         usePnpm,
+        useBun,
         devDependencies,
         verbose,
         isOnline,
@@ -1119,13 +1224,15 @@ var createApp = async ({
   console.log();
   const useYarn = customOptions.packageManager === "yarn" && shouldUseYarn();
   const usePnpm = customOptions.packageManager === "pnpm" && shouldUsePnpm();
-  const runCommand = useYarn ? "yarn" : usePnpm ? "pnpm run" : "npm run";
-  const installCommand = useYarn ? "yarn" : usePnpm ? "pnpm install" : "npm install";
+  const useBun = customOptions.packageManager === "bun" && shouldUseBun();
+  const runCommand = useYarn ? "yarn" : usePnpm ? "pnpm run" : useBun ? "bun run" : "npm run";
+  const installCommand = useYarn ? "yarn" : usePnpm ? "pnpm install" : useBun ? "bun install" : "npm install";
   const { packageJson, dependencies, devDependencies } = await loadPackages({
     templatesOrExtensions,
     appName,
     usePnpm,
     useYarn,
+    useBun,
     runCommand,
     ignorePackage
   });
@@ -1135,7 +1242,7 @@ var createApp = async ({
   );
   const originalDirectory = process.cwd();
   process.chdir(root);
-  if (!useYarn && !checkThatNpmCanReadCwd()) {
+  if (!useYarn && !useBun && !checkThatNpmCanReadCwd()) {
     process.exit(1);
   }
   if (!import_semver2.default.satisfies(process.version, ">=18.0.0")) {
@@ -1148,7 +1255,7 @@ Please update to Node 18 or higher for a better, fully supported experience.
       )
     );
   }
-  if (!useYarn) {
+  if (!useYarn && !useBun) {
     const npmInfo = checkNpmVersion();
     if (!npmInfo.hasMinNpm) {
       if (npmInfo.npmVersion) {
@@ -1166,7 +1273,11 @@ Please update to npm 3 or higher for a better, fully supported experience.
   if (useYarn) {
     let yarnUsesDefaultRegistry = true;
     try {
-      yarnUsesDefaultRegistry = (0, import_child_process2.execSync)("yarnpkg config get registry").toString().trim() === "https://registry.yarnpkg.com";
+      yarnUsesDefaultRegistry = (0, import_child_process2.execFileSync)(resolveExecutable("yarnpkg"), [
+        "config",
+        "get",
+        "registry"
+      ]).toString().trim() === "https://registry.yarnpkg.com";
     } catch {
     }
     if (false) {
@@ -1184,6 +1295,7 @@ Please update to npm 3 or higher for a better, fully supported experience.
     verbose,
     useYarn,
     usePnpm,
+    useBun,
     templatesOrExtensions,
     dependencies,
     devDependencies,
@@ -1238,7 +1350,11 @@ var checkForLatestVersion = async (packageName) => {
     return null;
   } catch {
     try {
-      return (0, import_child_process3.execSync)(`npm view ${packageName} version`).toString().trim();
+      return (0, import_child_process3.execFileSync)(resolveExecutable("npm"), [
+        "view",
+        packageName,
+        "version"
+      ]).toString().trim();
     } catch {
     }
   }
@@ -1249,7 +1365,7 @@ var printEnvInfo = async () => {
   const info = await import_envinfo.default.run(
     {
       System: ["OS", "CPU", "Memory", "Shell"],
-      Binaries: ["Node", "npm", "pnpm", "Yarn", "Watchman"],
+      Binaries: ["Node", "npm", "pnpm", "Yarn", "Bun", "Watchman"],
       Browsers: ["Chrome", "Edge", "Internet Explorer", "Firefox", "Safari"]
     },
     {