nx/docs/shared/deprecated/rescope.md
Jack Hsu f221a41dbd
feat(misc): remove @nrwl/ scoped packages (#27858)
This PR removes the `@nrwl/*` packages. Also cleans up references to the
legacy packages.

NOTE: The rescope page is now under `/deprecated/rescope`. There is
still >1000K monthly traffic to it, which might be due to older Nx
users.

<!-- If this is a particularly complex change or feature addition, you
can request a dedicated Nx release for this pull request branch. Mention
someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they
will confirm if the PR warrants its own release for testing purposes,
and generate it for you if appropriate. -->

## Current Behavior
<!-- This is the behavior we have today -->

## Expected Behavior
<!-- This is the behavior we should expect with the changes in this PR
-->

## Related Issue(s)
<!-- Please link the issue being fixed so it gets closed when this is
merged. -->

Fixes #
2024-09-27 17:19:01 -04:00

68 lines
2.9 KiB
Markdown

# Rescope Packages from @nrwl to @nx
As of version 16, all the official Nx plugins moved from the `@nrwl` npm scope to `@nx`. The goal is for anyone looking through a list of dependencies to easily make the connection between the `nx` package and the `@nx` plugins that are associated with it.
As of version 20, the `@nrwl` scoped packages will no longer be published to npm.
## What Do You Need To Do?
For new repos, run `npx create-nx-workspace` as usual. The correct packages will be added.
For existing repos, run `nx migrate` as you normally would. When migrating to version 16 or higher, the package names will be automatically updated for you. If you have a local script, update it to use `@nx/*` packages.
If you maintain a Nx plugin, please update it to use the `@nx/*` packages.
> If you come across Nrwl in blog posts, videos, or elsewhere, that content is likely referring to these packages. Depending on when the content was published, it is likely still relevant.
### Rename
The packages are being renamed as defined in the tables below:
The following packages were not simply rescoped `@nrwl` to `@nx`.
| Nx 15 and lower | Nx 16 and higher |
| ---------------------- | ----------------- |
| @nrwl/nx-cloud | nx-cloud |
| @nrwl/eslint-plugin-nx | @nx/eslint-plugin |
| @nrwl/nx-plugin | @nx/plugin |
| Nx 15 and lower | Nx 16 | Nx 17 |
| --------------- | ---------- | ---------- |
| @nrwl/linter | @nx/linter | @nx/eslint |
### Rescope Only
All other packages keep the same name, but change scope from `@nrwl` to `@nx`.
| Nx 15 and lower | Nx 16 |
| ------------------ | ---------------- |
| @nrwl/angular | @nx/angular |
| @nrwl/aws-lambda | @nx/aws-lambda |
| @nrwl/cypress | @nx/cypress |
| @nrwl/detox | @nx/detox |
| @nrwl/devkit | @nx/devkit |
| @nrwl/esbuild | @nx/esbuild |
| @nrwl/expo | @nx/expo |
| @nrwl/express | @nx/express |
| @nrwl/gatsby | @nx/gatsby |
| @nrwl/jest | @nx/jest |
| @nrwl/js | @nx/js |
| @nrwl/nest | @nx/nest |
| @nrwl/netlify | @nx/netlify |
| @nrwl/next | @nx/next |
| @nrwl/node | @nx/node |
| @nrwl/react | @nx/react |
| @nrwl/react-native | @nx/react-native |
| @nrwl/remix | @nx/remix |
| @nrwl/rollup | @nx/rollup |
| @nrwl/rspack | @nx/rspack |
| @nrwl/storybook | @nx/storybook |
| @nrwl/vite | @nx/vite |
| @nrwl/web | @nx/web |
| @nrwl/webpack | @nx/webpack |
| @nrwl/workspace | @nx/workspace |
## @nrwl Scope End of Life
Starting in version 20, the `@nrwl` scoped packages will no longer be published to npm. Only the `@nx` scoped packages will be available on the npm registry.