feat(create): add --package-manager flag and bun catalog support

fengmk2 · fengmk2 · commit c205ed763bd2 · 2026-03-25T23:24:46.000+08:00
Add `--package-manager` option to `vp create` for specifying the package
manager without interactive prompts. Priority: workspace detection &gt;
CLI flag &gt; interactive prompt/default.

Fix bun catalog support in monorepo migration:
- Enable `catalog:` protocol for bun (was incorrectly excluded)
- Add `rewriteBunCatalog()` to write catalog entries to root package.json
  (bun stores catalogs in package.json, not pnpm-workspace.yaml)
- Bun overrides use raw versions (catalog: not supported in overrides)

Add `new-vite-monorepo-bun` snap test verifying:
- Root package.json has catalog, workspaces, and overrides fields
- Sub-packages use `catalog:` references for dependencies
- No pnpm-workspace.yaml or .yarnrc.yml files created
diff --git a/packages/cli/snap-tests-global/new-vite-monorepo-bun/snap.txt b/packages/cli/snap-tests-global/new-vite-monorepo-bun/snap.txt
@@ -0,0 +1,73 @@
+> vp create vite:monorepo --no-interactive --package-manager bun # create monorepo with bun
+> ls vite-plus-monorepo | LC_ALL=C sort # check files created
+AGENTS.md
+README.md
+apps
+package.json
+packages
+tsconfig.json
+vite.config.ts
+
+> cat vite-plus-monorepo/package.json # check package.json with catalog
+{
+  "name": "vite-plus-monorepo",
+  "version": "0.0.0",
+  "private": true,
+  "workspaces": [
+    "packages/*",
+    "apps/*",
+    "tools/*"
+  ],
+  "type": "module",
+  "scripts": {
+    "ready": "vp fmt && vp lint && vp run test -r && vp run build -r",
+    "dev": "vp run website#dev",
+    "prepare": "vp config"
+  },
+  "devDependencies": {
+    "vite-plus": "catalog:"
+  },
+  "overrides": {
+    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "packageManager": "bun@<semver>",
+  "catalog": {
+    "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
+    "vite-plus": "latest"
+  }
+}
+
+> test ! -f vite-plus-monorepo/pnpm-workspace.yaml && echo 'No pnpm-workspace.yaml' || echo 'ERROR: pnpm-workspace.yaml exists' # verify no pnpm config
+No pnpm-workspace.yaml
+
+> test ! -f vite-plus-monorepo/.yarnrc.yml && echo 'No .yarnrc.yml' || echo 'ERROR: .yarnrc.yml exists' # verify no yarn config
+No .yarnrc.yml
+
+> test -d vite-plus-monorepo/.git && echo 'Git initialized' || echo 'No git' # check git init
+Git initialized
+
+> ls vite-plus-monorepo/apps # check apps directory
+website
+
+> cat vite-plus-monorepo/apps/website/package.json # check website uses catalog:
+{
+  "name": "website",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vp dev",
+    "build": "tsc && vp build",
+    "preview": "vp preview"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}
diff --git a/packages/cli/snap-tests-global/new-vite-monorepo-bun/steps.json b/packages/cli/snap-tests-global/new-vite-monorepo-bun/steps.json
@@ -0,0 +1,16 @@
+{
+  "ignoredPlatforms": ["win32"],
+  "commands": [
+    {
+      "command": "vp create vite:monorepo --no-interactive --package-manager bun # create monorepo with bun",
+      "ignoreOutput": true
+    },
+    "ls vite-plus-monorepo | LC_ALL=C sort # check files created",
+    "cat vite-plus-monorepo/package.json # check package.json with catalog",
+    "test ! -f vite-plus-monorepo/pnpm-workspace.yaml && echo 'No pnpm-workspace.yaml' || echo 'ERROR: pnpm-workspace.yaml exists' # verify no pnpm config",
+    "test ! -f vite-plus-monorepo/.yarnrc.yml && echo 'No .yarnrc.yml' || echo 'ERROR: .yarnrc.yml exists' # verify no yarn config",
+    "test -d vite-plus-monorepo/.git && echo 'Git initialized' || echo 'No git' # check git init",
+    "ls vite-plus-monorepo/apps # check apps directory",
+    "cat vite-plus-monorepo/apps/website/package.json # check website uses catalog:"
+  ]
+}
diff --git a/packages/cli/src/create/bin.ts b/packages/cli/src/create/bin.ts
@@ -11,7 +11,7 @@ import {
   rewriteMonorepoProject,
   rewriteStandaloneProject,
 } from '../migration/migrator.js';
-import { DependencyType, type WorkspaceInfo } from '../types/index.js';
+import { DependencyType, type PackageManager, type WorkspaceInfo } from '../types/index.js';
 import {
   detectExistingAgentTargetPaths,
   selectAgentTargetPaths,
@@ -91,6 +91,10 @@ const helpMessage = renderCliDoc({
           description: 'Set up pre-commit hooks (default in non-interactive mode)',
         },
         { label: '--no-hooks', description: 'Skip pre-commit hooks setup' },
+        {
+          label: '--package-manager NAME',
+          description: 'Use specified package manager (pnpm, npm, yarn, bun)',
+        },
         { label: '--verbose', description: 'Show detailed scaffolding output' },
         { label: '--no-interactive', description: 'Run in non-interactive mode' },
         { label: '--list', description: 'List all available templates' },
@@ -185,6 +189,7 @@ export interface Options {
   agent?: string | string[] | false;
   editor?: string;
   hooks?: boolean;
+  packageManager?: string;
 }
 
 // Parse CLI arguments: split on '--' separator
@@ -207,10 +212,11 @@ function parseArgs() {
     agent?: string | string[] | false;
     editor?: string;
     hooks?: boolean;
+    'package-manager'?: string;
   }>(viteArgs, {
     alias: { h: 'help' },
     boolean: ['help', 'list', 'all', 'interactive', 'hooks', 'verbose'],
-    string: ['directory', 'agent', 'editor'],
+    string: ['directory', 'agent', 'editor', 'package-manager'],
     default: { interactive: defaultInteractive() },
   });
 
@@ -227,6 +233,7 @@ function parseArgs() {
       agent: parsed.agent,
       editor: parsed.editor,
       hooks: parsed.hooks,
+      packageManager: parsed['package-manager'],
     } as Options,
     templateArgs,
   };
@@ -624,9 +631,10 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     }
   }
 
-  // Prompt for package manager or use default
+  // Resolve package manager: workspace detection > CLI flag > interactive prompt/default
   const packageManager =
     workspaceInfoOptional.packageManager ??
+    (options.packageManager as PackageManager | undefined) ??
     (await selectPackageManager(options.interactive, compactOutput));
   const shouldSilencePackageManagerInstallLog =
     compactOutput || (isMonorepo && workspaceInfoOptional.packageManager !== undefined);
diff --git a/packages/cli/src/migration/migrator.ts b/packages/cli/src/migration/migrator.ts
@@ -748,6 +748,8 @@ export function rewriteMonorepo(
     rewritePnpmWorkspaceYaml(workspaceInfo.rootDir);
   } else if (workspaceInfo.packageManager === PackageManager.yarn) {
     rewriteYarnrcYml(workspaceInfo.rootDir);
+  } else if (workspaceInfo.packageManager === PackageManager.bun) {
+    rewriteBunCatalog(workspaceInfo.rootDir);
   }
   rewriteRootWorkspacePackageJson(
     workspaceInfo.rootDir,
@@ -948,6 +950,51 @@ function rewriteCatalog(doc: YamlDocument): void {
   // TODO: rewrite `catalogs` when OVERRIDE_PACKAGES exists in catalog
 }
 
+/**
+ * Write catalog entries to root package.json for bun.
+ * Bun stores catalogs in package.json under the `catalog` key,
+ * unlike pnpm which uses pnpm-workspace.yaml.
+ * @see https://bun.sh/docs/pm/catalogs
+ */
+function rewriteBunCatalog(projectPath: string): void {
+  const packageJsonPath = path.join(projectPath, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    return;
+  }
+
+  editJsonFile<{
+    catalog?: Record<string, string>;
+    overrides?: Record<string, string>;
+  }>(packageJsonPath, (pkg) => {
+    const catalog: Record<string, string> = { ...pkg.catalog };
+
+    // Add vite-plus managed packages to catalog
+    for (const [key, value] of Object.entries(VITE_PLUS_OVERRIDE_PACKAGES)) {
+      if (!value.startsWith('file:')) {
+        catalog[key] = value;
+      }
+    }
+    if (!VITE_PLUS_VERSION.startsWith('file:')) {
+      catalog[VITE_PLUS_NAME] = VITE_PLUS_VERSION;
+    }
+
+    // Remove replaced packages from catalog
+    for (const name of REMOVE_PACKAGES) {
+      delete catalog[name];
+    }
+
+    pkg.catalog = catalog;
+
+    // bun uses overrides in package.json (catalog: references are NOT supported in overrides)
+    pkg.overrides = {
+      ...pkg.overrides,
+      ...VITE_PLUS_OVERRIDE_PACKAGES,
+    };
+
+    return pkg;
+  });
+}
+
 /**
  * Rewrite root workspace package.json to add vite-plus dependencies
  * @param projectPath - The path to the project
@@ -1093,8 +1140,7 @@ export function rewritePackageJson(
     const updated = rewriteScripts(JSON.stringify(config), readRulesYaml());
     extractedStagedConfig = updated ? JSON.parse(updated) : config;
   }
-  const supportCatalog =
-    isMonorepo && packageManager !== PackageManager.npm && packageManager !== PackageManager.bun;
+  const supportCatalog = isMonorepo && packageManager !== PackageManager.npm;
   let needVitePlus = false;
   for (const [key, version] of Object.entries(VITE_PLUS_OVERRIDE_PACKAGES)) {
     const value = supportCatalog && !version.startsWith('file:') ? 'catalog:' : version;
