nx/docs/shared/getting-started/installation.md
Leosvel Pérez Espinosa 6576325f7b
docs(misc): fix misc issues (#22039)
Co-authored-by: Isaac Mann <isaacplmann@users.noreply.github.com>
2024-02-28 10:02:27 -05:00

2.6 KiB

Installation

Create a new Nx workspace using the following command:

{% tabs %} {% tab label="npm" %}

npx create-nx-workspace

{% /tab %} {% tab label="yarn" %}

npx create-nx-workspace --pm yarn

{% /tab %} {% tab label="pnpm" %}

npx create-nx-workspace --pm pnpm

{% /tab %} {% /tabs %}

This will guide you through the setup, asking whether you want a monorepo or a standalone app and whether you want to start with a blank or a preconfigured setup.


NX   Let's create a new workspace [https://nx.dev/getting-started/intro]

✔ Where would you like to create your workspace? · myorg
? Which stack do you want to use? …
None:          Configures a TypeScript/JavaScript project with minimal structure.
React:         Configures a React application with your framework of choice.
Vue:           Configures a Vue application with your framework of choice.
Angular:       Configures a Angular application with modern tooling.
Node:          Configures a Node API application with your framework of choice.

Once you've created your workspace, you can

  • run single tasks with npx nx <target> <project>
  • run multiple tasks with npx nx run-many -t <target1> <target2>

Run npx nx run-many -t build twice to see how Nx's powerful caching speeds up your build.

Learn more about running tasks.

Installing Nx Into an Existing Repository

If you want to add Nx to an existing repository run:

npx nx@latest init

You can also manually install the nx NPM package and create a nx.json to configure it. Learn more about adopting Nx in an existing project

Installing Nx Globally

You can install Nx globally. Depending on your package manager, use one of the following commands:

{% tabs %} {% tab label="npm" %}

npm add --global nx@latest

{% /tab %} {% tab label="yarn" %}

yarn global add nx@latest

{% /tab %} {% tab label="pnpm" %}

pnpm add --global nx@latest

{% /tab %} {% /tabs %}

The advantage of a global installation is that you don't have to prefix your commands with npx, yarn or pnpm. The global Nx installation hands off the process execution to the local Nx installation in your repository, which eliminates any issues with outdated globally installed packages.

More Documentation