cargo ux new

This is a Draft Version

Creates a new workspace and an initial Angular Rust application.

cargo ux new <name> [options]
cargo ux n <name> [options]


Creates and initializes a new Angular Rust application that is the default project for a new workspace.

Provides interactive prompts for optional configuration, such as adding routing support. All prompts can safely be allowed to default.

  • The new workspace folder is given the specified project name, and contains configuration files at the top level.

  • By default, the files for a new initial application (with the same name as the workspace) are placed in the src/ subfolder. Corresponding end-to-end tests are placed in the e2e/ subfolder.

  • The new application's configuration appears in the projects section of the ux.yaml workspace configuration file, under its project name.

  • Subsequent applications that you generate in the workspace reside in the projects/ subfolder.

If you plan to have multiple applications in the workspace, you can create an empty workspace by setting the --createApplication option to false. You can then use cargo ux generate application to create an initial application. This allows a workspace name different from the initial app name, and ensures that all applications reside in the /projects subfolder, matching the structure of the configuration file.


Argument | Description Value Type name | The name of the new workspace and initial project. | string


OptionDescriptionValue TypeDefault Value
--collectionA collection of schematics to use in generating the initial application. Aliases: -cstring
--commitInitial git repository commit information.booleantrue
--create-applicationCreate a new initial application project in the 'src' folder of the new workspace. When false, creates an empty workspace with no initial application. You can then use the generate application command so that all applications are created in the projects folder.booleantrue
--defaultsDisable interactive input prompts for options with a default.boolean
--directoryThe directory name to create the workspace in.string
--dry-runRun through and reports activity without writing out results. Aliases: -dbooleanfalse
--forceForce overwriting of existing files. Aliases: -fbooleanfalse
--helpShows a help message for this command in the console.true|false|jsonfalse
--inline-styleInclude styles inline in the component file. By default, an external styles file is created and referenced in the component file. Aliases: -sboolean
--inline-templateInclude template inline in the component file. By default, an external template file is created and referenced in the component file. Aliases: -tboolean
--interactiveEnable interactive input prompts.boolean
--legacy-browsersAdd support for legacy browsers like Internet Explorer using differential loading.booleanfalse
--minimalCreate a workspace without any testing frameworks. (Use for learning purposes only.)booleanfalse
--new-project-rootThe path where new projects will be created, relative to the new workspace root.stringprojects
--prefixThe prefix to apply to generated selectors for the initial project. Aliases: -pstringapp
--routingGenerate a routing module for the initial project.boolean
--skip-gitDo not initialize a git repository. Aliases: -gbooleanfalse
--skip-installDo not install dependency packages.booleanfalse
--skip-testsDo not generate "" test files for the new project. Aliases: -Sbooleanfalse
--strictCreates a workspace with stricter type checking and stricter bundle budgets settings. This setting helps improve maintainability and catch bugs ahead of time. For more information, see
--verboseAdd more details to output logging. Aliases: -vbooleanfalse
--view-encapsulationThe view encapsulation strategy to use in the initial project.Emulated|None|ShadowDom