Start a New Project

Create a new Nx workspace using one of these options:

• Option 1: Create locally with templates - Run a command to scaffold a new monorepo on your machine
• Option 2: Create via Nx Cloud - Use the browser-based setup with CI/CD pre-configured

Adding Nx to an existing project?

If you already have a project and want to add Nx to it, see Add to an Existing Project instead.

Option 1: create locally with templates

Run the following command to create a new Nx workspace:

npx create-nx-workspace@latest

This interactive command guides you through the setup:

• Workspace name - The name of your root directory.
• Starter template - Choose from pre-built monorepo templates (React, Tanstack Start, Angular, Next.js, NestJS, Astro, etc.).

For a minimal setup, use the empty template. This gives you a bare TypeScript monorepo that you can extend incrementally.

npx create-nx-workspace@latest --template=empty

Option 2: Create via Nx Cloud

Create your workspace directly from Nx Cloud for a browser-based setup experience.

This option gives you:

• A working CI configuration out of the box
• Remote caching enabled from the start
• Self-healing CI that automatically fixes common failures

Get started with Nx Cloud →

Next steps

Once your workspace is set up:

• New to Nx? → Follow the tutorial series to learn core concepts hands-on
• Set up your editor → Install Nx Console for VSCode or JetBrains
• Speed up CI → Connect to Nx Cloud for remote caching and distributed tasks