nx/docs/generated/cli/create-nx-workspace.md
2022-09-06 15:31:01 -04:00

137 lines
1.8 KiB
Markdown

---
title: 'create-nx-workspace - CLI command'
description: 'Create a new Nx workspace'
---
# create-nx-workspace
Create a new Nx workspace
## Usage
```bash
create-nx-workspace [name] [options]
```
Install `create-nx-workspace` globally to invoke the command directly, or use `npx create-nx-workspace`, `yarn create nx-workspace`, or `pnpx create-nx-workspace`.
## Options
### allPrompts
Type: boolean
Default: false
Show all prompts
### appName
Type: string
The name of the application when a preset with pregenerated app is selected
### ci
Type: string
Choices: [github, circleci, azure]
Generate a CI workflow file
### cli
Type: string
Choices: [nx, angular]
CLI to power the Nx workspace
### commit.email
Type: string
E-mail of the committer
### commit.message
Type: string
Default: Initial commit
Commit message
### commit.name
Type: string
Name of the committer
### defaultBase
Type: string
Default: main
Default base to use for new projects
### help
Type: boolean
Show help
### interactive
Type: boolean
Enable interactive mode with presets
### name
Type: string
Workspace name (e.g. org name)
### nxCloud
Type: boolean
Enable distributed caching to make your CI faster
### packageManager
Type: string
Choices: [npm, pnpm, yarn]
Default: npm
Package manager to use
### preset
Type: string
Customizes the initial content of your workspace. Default presets include: ["apps", "empty", "core", "npm", "ts", "web-components", "angular", "angular-nest", "react", "react-express", "react-native", "next", "nest", "express"]. To build your own see https://nx.dev/packages/nx-plugin#preset
### skipGit
Type: boolean
Default: false
Skip initializing a git repository.
### style
Type: string
Style option to be used when a preset with pregenerated app is selected
### version
Type: boolean
Show version number