---
title: Start a New Project
description: Create a new Nx workspace with create-nx-workspace and pick a starter template for your stack.
sidebar:
  label: Start a New Project
  order: 3
filter: 'type:Guides'
---

{% llm_copy_prompt title="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: {pageUrl}
{% /llm_copy_prompt %}

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

```shell {% meta="prompt=true" %}
$ 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

Pick a starter from the prompt, or browse the [template gallery](/docs/templates) 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:

```shell
npx create-nx-workspace@latest --template=nrwl/tanstack-start-template
```

## Next steps

Once your workspace is set up, try these commands:

```shell
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:

- [Configure task caching](/docs/features/cache-task-results) to speed up repeated builds
- [Add Nx plugins](/docs/technologies) for your tech stack (React, Angular, Node, etc.)

## Keep learning

- **New to Nx?** → [Follow the tutorial series](/docs/getting-started/tutorials/crafting-your-workspace) to learn core concepts hands-on
- **Working with AI?** → [Set up AI integrations](/docs/getting-started/ai-setup) so agents understand your workspace
- **Ready for CI?** → [Set up CI](/docs/getting-started/setup-ci) with remote caching and affected commands
- **Prefer video?** → [Learn with our video courses](https://nx.dev/courses)
