refactor(cli): rename vp new to vp create with shorthand expansion (#570)

Rename the `new` command to `create` to align with `npm create` / `pnpm
create`
conventions. Add shorthand expansion so `vp create vite` resolves to
`create-vite`
and `vp create @tanstack/start` resolves to `@tanstack/create-start`.

- Rename Rust enum variant `New` → `Create` and module `new.rs` →
`create.rs`
- Update JS routing to handle `create` command
- Add `expandCreateShorthand()` with unit tests
- Rename help section "Vite+ Commands" → "Core Commands", reorder
entries
- Update all docs, snap tests, CI workflows, and install scripts

Author: fengmk2

.github/workflows/test-standalone-install.yml

@@ -67,7 +67,7 @@ jobs:
           vp --version
           vp --help
           # test new command
-          vp new create-vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
+          vp create vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
           cd hello && vp run build
 
       - name: Set PATH
@@ -173,7 +173,7 @@ jobs:
               vp --version
 
               # FIXME: qemu: uncaught target signal 11 (Segmentation fault) - core dumped
-              # vp new create-vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
+              # vp create vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
               # cd hello && vp run build
             "
 
@@ -218,7 +218,7 @@ jobs:
           vp --help
           # $env:VITE_LOG = "trace"
           # test new command
-          vp new create-vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
+          vp create vite --no-interactive --no-agent -- hello --no-interactive -t vanilla
           cd hello && vp run build
 
       - name: Verify bin setup on powershell
@@ -261,7 +261,7 @@ jobs:
           dir "%USERPROFILE%\.vite-plus\bin"
 
           REM test new command
-          vp new create-vite --no-interactive --no-agent -- hello-cmd --no-interactive -t vanilla
+          vp create vite --no-interactive --no-agent -- hello-cmd --no-interactive -t vanilla
           cd hello-cmd && vp run build
 
       - name: Verify bin setup on cmd
@@ -300,7 +300,7 @@ jobs:
           vp --version
           vp --help
           # test new command
-          vp new create-vite --no-interactive --no-agent -- hello-bash --no-interactive -t vanilla
+          vp create vite --no-interactive --no-agent -- hello-bash --no-interactive -t vanilla
           cd hello-bash && vp run build
 
       - name: Verify bin setup on bash

README.md

@@ -68,13 +68,13 @@ Vite+ automatically detects and wraps the underlying package manager such as pnp
 
 ### Scaffolding your first Vite+ project
 
-Use `vp new` to create a new project:
+Use `vp create` to create a new project:
 
 ```bash
-vp new
+vp create
 ```
 
-You can run `vp new` inside of a project to add new apps or libraries to your project.
+You can run `vp create` inside of a project to add new apps or libraries to your project.
 
 ### Migrating an existing project
 

crates/vite_global_cli/src/cli.rs

@@ -515,7 +515,7 @@ pub enum Commands {
     // =========================================================================
     /// Create a new project from a template (delegates to JS)
     #[command(disable_help_flag = true)]
-    New {
+    Create {
         #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
         args: Vec<String>,
     },
@@ -1524,7 +1524,7 @@ pub async fn run_command(cwd: AbsolutePathBuf, args: Args) -> Result<ExitStatus,
         Commands::Pm(pm_command) => commands::pm::execute_pm_subcommand(cwd, pm_command).await,
 
         // Category B: JS Script Commands
-        Commands::New { args } => commands::new::execute(cwd, &args).await,
+        Commands::Create { args } => commands::create::execute(cwd, &args).await,
 
         Commands::Migrate { args } => commands::migrate::execute(cwd, &args).await,
 
@@ -1590,18 +1590,18 @@ fn apply_custom_help(cmd: clap::Command) -> clap::Command {
     let version = env!("CARGO_PKG_VERSION");
 
     let after_help = format!(
-        "{bold_underline}Vite+ Commands:{reset}
+        "{bold_underline}Core Commands:{reset}
+  {bold}create{reset}     Create a new project from a template
   {bold}dev{reset}        Run the development server
   {bold}build{reset}      Build for production
-  {bold}lint{reset}       Lint code
   {bold}test{reset}       Run tests
+  {bold}lint{reset}       Lint code
   {bold}fmt{reset}        Format code
-  {bold}lib{reset}        Build library
-  {bold}migrate{reset}    Migrate an existing project to Vite+
-  {bold}cache{reset}      Manage the task cache
-  {bold}new{reset}        Generate a new project
   {bold}run{reset}        Run tasks
+  {bold}preview{reset}    Preview production build
   {bold}env{reset}        Manage Node.js versions
+  {bold}migrate{reset}    Migrate an existing project to Vite+
+  {bold}cache{reset}      Manage the task cache
 
 {bold_underline}Package Manager Commands:{reset}
   {bold}install, i{reset}                     Install all dependencies, or add packages if package names are provided

…ates/vite_global_cli/src/commands/new.rs …s/vite_global_cli/src/commands/create.rscrates/vite_global_cli/src/commands/new.rs renamed to crates/vite_global_cli/src/commands/create.rs crates/vite_global_cli/src/commands/new.rs renamed to crates/vite_global_cli/src/commands/create.rs

@@ -6,19 +6,19 @@ use vite_path::AbsolutePathBuf;
 
 use crate::{error::Error, js_executor::JsExecutor};
 
-/// Execute the `new` command by delegating to the bundled JavaScript implementation.
+/// Execute the `create` command by delegating to the bundled JavaScript implementation.
 pub async fn execute(cwd: AbsolutePathBuf, args: &[String]) -> Result<ExitStatus, Error> {
     let mut executor = JsExecutor::new(None);
 
-    // Execute the bundled JS script with the "new" command
+    // Execute the bundled JS script with the "create" command
     // The JS script handles all argument parsing, template discovery, and execution
-    executor.execute_cli_script("index.js", "new", args, &cwd).await
+    executor.execute_cli_script("index.js", "create", args, &cwd).await
 }
 
 #[cfg(test)]
 mod tests {
     #[test]
-    fn test_new_command_module_exists() {
+    fn test_create_command_module_exists() {
         // Basic test to ensure the module compiles
         assert!(true);
     }

crates/vite_global_cli/src/commands/mod.rs

@@ -16,7 +16,7 @@
 //! - `pm`: Forward commands to the package manager
 //!
 //! Category B - JS Script Commands:
-//! - `new`: Project scaffolding
+//! - `create`: Project scaffolding
 //! - `migrate`: Migration command
 //! - `version`: Version display
 //!
@@ -132,8 +132,8 @@ pub mod update;
 pub mod why;
 
 // Category B: JS Script Commands
+pub mod create;
 pub mod migrate;
-pub mod new;
 pub mod version;
 
 // Category D: Environment Management

docs/vite/guide/index.md

@@ -49,7 +49,7 @@ vp env help               # Show all commands
 Create a Vite+ project:
 
 ```bash
-vp new
+vp create
 ```
 
 Follow the prompts to select your preferred framework and configuration.

packages/cli/README.md

@@ -66,13 +66,13 @@ Vite+ automatically detects and wraps the underlying package manager such as pnp
 
 ### Scaffolding your first Vite+ project
 
-Use `vp new` to create a new project:
+Use `vp create` to create a new project:
 
 ```bash
-vp new
+vp create
 ```
 
-You can run `vp new` inside of a project to add new apps or libraries to your project.
+You can run `vp create` inside of a project to add new apps or libraries to your project.
 
 ### Migrating an existing project
 

packages/global/README.md

@@ -64,13 +64,13 @@ Vite+ automatically detects and wraps the underlying package manager such as pnp
 
 ### Scaffolding your first Vite+ project
 
-Use `vp new` to create a new project:
+Use `vp create` to create a new project:
 
 ```bash
-vp new
+vp create
 ```
 
-You can run `vp new` inside of a project to add new apps or libraries to your project.
+You can run `vp create` inside of a project to add new apps or libraries to your project.
 
 ### Migrating an existing project
 

packages/global/install.ps1

@@ -474,7 +474,7 @@ exec "`$VITE_PLUS_HOME/current/bin/vp.exe" "`$@"
     Write-Host "  The Unified Toolchain for the Web."
     Write-Host ""
     Write-Host "  ${BOLD}Get started:${NC}"
-    Write-Host "    ${BRIGHT_BLUE}vp new${NC}          Create a new project"
+    Write-Host "    ${BRIGHT_BLUE}vp create${NC}          Create a new project"
     Write-Host "    ${BRIGHT_BLUE}vp env${NC}          Manage Node.js versions"
     Write-Host "    ${BRIGHT_BLUE}vp install${NC}      Install dependencies"
     Write-Host "    ${BRIGHT_BLUE}vp dev${NC}          Start dev server"

packages/global/install.sh

@@ -673,7 +673,7 @@ main() {
   echo "  The Unified Toolchain for the Web."
   echo ""
   echo -e "  ${BOLD}Get started:${NC}"
-  echo -e "    ${BRIGHT_BLUE}vp new${NC}          Create a new project"
+  echo -e "    ${BRIGHT_BLUE}vp create${NC}          Create a new project"
   echo -e "    ${BRIGHT_BLUE}vp env${NC}          Manage Node.js versions"
   echo -e "    ${BRIGHT_BLUE}vp install${NC}      Install dependencies"
   echo -e "    ${BRIGHT_BLUE}vp dev${NC}          Start dev server"