nx/docs/generated/cli/create-nx-workspace.md

165 lines
2.4 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
### bundler
Type: `string`
Choices: [webpack, vite]
Bundler to be used to build the application
### ci
Type: `string`
Choices: [github, circleci, azure, bitbucket-pipelines, gitlab]
Generate a CI workflow file
### 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
### docker
Type: `boolean`
Generate a Dockerfile with your node-server
### framework
Type: `string`
Choices: [express, fastify, koa, nest]
Framework option to be used when the node-server preset is selected
### help
Type: `boolean`
Show help
### interactive
Type: `boolean`
Default: `true`
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-monorepo", "angular-standalone", "react-monorepo", "react-standalone", "react-native", "expo", "next", "nest", "express", "react", "angular", "node-standalone"]. To build your own see https://nx.dev/packages/nx-plugin#preset
### routing
Type: `boolean`
Add a routing setup when a preset with pregenerated app is selected
### skipGit
Type: `boolean`
Default: `false`
Skip initializing a git repository
### standaloneApi
Type: `boolean`
Use Standalone Components if generating an Angular app
### style
Type: `string`
Style option to be used when a preset with pregenerated app is selected
### version
Type: `boolean`
Show version number