Set up a New Nx Workspace
Run the following command to create a new workspace.
# pass @latest in case npx cached an older version of create-nx-workspace npx create-nx-workspace@latest
When creating a workspace, you will have to choose a preset, which will preconfigure a few things for you.
# create an empty workspace set up for building applications npx create-nx-workspace --preset=apps # create an empty workspace set up for building packages npx create-nx-workspace --preset=core # create an empty workspace set up for building packages with the @nrwl/js plugin installed npx create-nx-workspace --preset=ts
Some presets set up applications, e2e tests, etc.
npx create-nx-workspace --preset=react npx create-nx-workspace --preset=react-native npx create-nx-workspace --preset=angular
For more information about possible options see the create-nx-workspace command.
Add Nx to an Existing Project
If you have an existing Lerna or Yarn monorepo, you can gain the benefits of Nx's computation cache and distributed task execution without modifying the file structure by running this command:
If you have an existing Create React App project, you can gain the benefits of Nx's computation cache and distributed task execution without modifying the file structure by running this command:
For more information on adding Nx to an existing repository see the migration guide
Install Nx CLI
To make the developer experience nicer, you may want to install the Nx CLI globally.
npm install -g nx
Nx can be added to any workspace, so there is no fixed folder structure. However, if you use one of the existing presets, you will likely see something like this:
myorg/ ├── apps/ ├── libs/ ├── tools/ ├── workspace.json ├── nx.json ├── package.json └── tsconfig.base.json
/apps/ contains the application projects. This is the main entry point for a runnable application. We recommend keeping applications as light-weight as possible, with all the heavy lifting being done by libraries that are imported by each application.
/libs/ contains the library projects. There are many kinds of libraries, and each library defines its own external API so that boundaries between libraries remain clear.
/workspace.json lists every project in your workspace. (this file is optional)
/nx.json configures the Nx CLI itself. It tells Nx what needs to be cached, how to run tasks etc.
/tsconfig.base.json sets up the global TypeScript settings and creates aliases for each library to aid when creating TS/JS imports.