Skip to content
Nx Docs

Start a New Project

Let an AI agent set it up for you

Help me create a new Nx workspace.

1. Run `npx create-nx-workspace@latest` from the directory the workspace should live in, and walk me through the prompts (workspace name, starter template).

2. If I already know the stack I want, skip the prompts with `--template=<name>`. The full list of templates is at /docs/templates (/docs/templates), and each template page shows the exact command.

3. `cd` into the new directory. Run `npx nx run-many -t build` to confirm the workspace works, then `npx nx graph` to show me the project graph.

Do not add plugins or projects I did not ask for. Summarize what was generated before moving on.

Page: https://nx.dev/docs/getting-started/start-new-project.md

Help me create a new Nx workspace.

1. Run `npx create-nx-workspace@latest` from the directory the workspace should live in, and walk me through the prompts (workspace name, starter template).

2. If I already know the stack I want, skip the prompts with `--template=<name>`. The full list of templates is at /docs/templates (/docs/templates), and each template page shows the exact command.

3. `cd` into the new directory. Run `npx nx run-many -t build` to confirm the workspace works, then `npx nx graph` to show me the project graph.

Do not add plugins or projects I did not ask for. Summarize what was generated before moving on.

Page: https://nx.dev/docs/getting-started/start-new-project.md

Create a new Nx workspace with create-nx-workspace:

Terminal window
$ npx create-nx-workspace@latest
✓ generating workspace files
✓ installing dependencies
→ ready in 20s

The command prompts for a workspace name, which becomes the root directory, and a starter template, which decides what the workspace starts with.

Pick a starter template

Section titled “Pick a starter template”

Pick a starter from the prompt, or browse the template gallery for the full set - TanStack Start, Next.js, NestJS, Express, Astro Starlight, React Module Federation, Remotion, and more.

Every template is a working monorepo. Projects are wired together, caching is on, and the task pipeline is configured.

Each template page shows the create-nx-workspace command that scaffolds it, so you can skip the prompt:

Terminal window
npx create-nx-workspace@latest --template=nrwl/tanstack-start-template

Next steps

Section titled “Next steps”

Once your workspace is set up, try these commands:

Terminal window
nx build <project-name>      # Run a task
nx build <project-name>      # Run again - instant cache hit
nx run-many -t build test    # Run tasks across all projects
nx graph                     # Visualize project dependencies

From here you can:

Keep learning

Section titled “Keep learning”