Skip to content

Commit

Permalink
feat(misc): remove @nrwl/ scoped packages (#27858)
Browse files Browse the repository at this point in the history
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 #
  • Loading branch information
jaysoo committed Sep 27, 2024
1 parent 0fd8b41 commit f221a41
Show file tree
Hide file tree
Showing 301 changed files with 71 additions and 4,308 deletions.
2 changes: 1 addition & 1 deletion docs/changelog/17_0_0.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ title="Nx 17.0 Has Landed!!!"
Use [the `nx migrate` command](/features/automate-updating-dependencies) to automatically account for these breaking changes.

{% cards cols="2" %}
{% card title="Rename @nx/linter to @nx/eslint" type="document" url="/recipes/other/rescope#rename" /%}
{% card title="Rename @nx/linter to @nx/eslint" type="document" url="/deprecated/rescope#rename" /%}
{% card title="Removed workspace generator command" type="external" url="https://github.com/nrwl/nx/pull/19541" /%}
{% card title="Removed workspace-lint command" type="external" url="https://github.com/nrwl/nx/pull/16212" /%}
{% card title="Removed defaultCollection property" type="external" url="https://github.com/nrwl/nx/pull/19708" /%}
Expand Down
66 changes: 16 additions & 50 deletions docs/generated/manifests/menus.json
Original file line number Diff line number Diff line change
Expand Up @@ -2166,23 +2166,6 @@
}
],
"disableCollapsible": false
},
{
"name": "Other",
"path": "/recipes/other",
"id": "other",
"isExternal": false,
"children": [
{
"name": "Rescope Packages from @nrwl to @nx",
"path": "/recipes/other/rescope",
"id": "rescope",
"isExternal": false,
"children": [],
"disableCollapsible": false
}
],
"disableCollapsible": false
}
],
"disableCollapsible": false
Expand Down Expand Up @@ -4054,31 +4037,6 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Other",
"path": "/recipes/other",
"id": "other",
"isExternal": false,
"children": [
{
"name": "Rescope Packages from @nrwl to @nx",
"path": "/recipes/other/rescope",
"id": "rescope",
"isExternal": false,
"children": [],
"disableCollapsible": false
}
],
"disableCollapsible": false
},
{
"name": "Rescope Packages from @nrwl to @nx",
"path": "/recipes/other/rescope",
"id": "rescope",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Showcase",
"path": "/showcase",
Expand Down Expand Up @@ -4939,6 +4897,14 @@
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Rescope Packages from @nrwl to @nx",
"path": "/deprecated/rescope",
"id": "rescope",
"isExternal": false,
"children": [],
"disableCollapsible": false
}
],
"disableCollapsible": false
Expand Down Expand Up @@ -5047,6 +5013,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Rescope Packages from @nrwl to @nx",
"path": "/deprecated/rescope",
"id": "rescope",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "See Also",
"path": "/see-also",
Expand Down Expand Up @@ -10123,14 +10097,6 @@
"isExternal": false,
"disableCollapsible": false
},
{
"id": "tao",
"path": "/nx-api/tao",
"name": "tao",
"children": [],
"isExternal": false,
"disableCollapsible": false
},
{
"id": "vite",
"path": "/nx-api/vite",
Expand Down
12 changes: 0 additions & 12 deletions docs/generated/manifests/nx-api.json
Original file line number Diff line number Diff line change
Expand Up @@ -3113,18 +3113,6 @@
},
"path": "/nx-api/storybook"
},
"tao": {
"githubRoot": "https://github.com/nrwl/nx/blob/master",
"name": "tao",
"packageName": "@nrwl/tao",
"description": "CLI for generating code and running commands",
"documents": {},
"root": "/packages/tao",
"source": "/packages/tao/src",
"executors": {},
"generators": {},
"path": "/nx-api/tao"
},
"vite": {
"githubRoot": "https://github.com/nrwl/nx/blob/master",
"name": "vite",
Expand Down
79 changes: 22 additions & 57 deletions docs/generated/manifests/nx.json
Original file line number Diff line number Diff line change
Expand Up @@ -2962,29 +2962,6 @@
"isExternal": false,
"path": "/recipes/nx-release",
"tags": []
},
{
"id": "other",
"name": "Other",
"description": "Other recipes you will find useful.",
"mediaImage": "",
"file": "",
"itemList": [
{
"id": "rescope",
"name": "Rescope Packages from @nrwl to @nx",
"description": "",
"mediaImage": "",
"file": "shared/recipes/rescope",
"itemList": [],
"isExternal": false,
"path": "/recipes/other/rescope",
"tags": []
}
],
"isExternal": false,
"path": "/recipes/other",
"tags": []
}
],
"isExternal": false,
Expand Down Expand Up @@ -5551,40 +5528,6 @@
"path": "/recipes/nx-release/build-before-versioning",
"tags": ["nx-release"]
},
"/recipes/other": {
"id": "other",
"name": "Other",
"description": "Other recipes you will find useful.",
"mediaImage": "",
"file": "",
"itemList": [
{
"id": "rescope",
"name": "Rescope Packages from @nrwl to @nx",
"description": "",
"mediaImage": "",
"file": "shared/recipes/rescope",
"itemList": [],
"isExternal": false,
"path": "/recipes/other/rescope",
"tags": []
}
],
"isExternal": false,
"path": "/recipes/other",
"tags": []
},
"/recipes/other/rescope": {
"id": "rescope",
"name": "Rescope Packages from @nrwl to @nx",
"description": "",
"mediaImage": "",
"file": "shared/recipes/rescope",
"itemList": [],
"isExternal": false,
"path": "/recipes/other/rescope",
"tags": []
},
"/showcase": {
"id": "showcase",
"name": "Showcase",
Expand Down Expand Up @@ -6764,6 +6707,17 @@
"isExternal": false,
"path": "/deprecated/v1-nx-plugin-api",
"tags": []
},
{
"id": "rescope",
"name": "Rescope Packages from @nrwl to @nx",
"description": "",
"mediaImage": "",
"file": "shared/deprecated/rescope",
"itemList": [],
"isExternal": false,
"path": "/deprecated/rescope",
"tags": []
}
],
"isExternal": false,
Expand Down Expand Up @@ -6913,6 +6867,17 @@
"path": "/deprecated/v1-nx-plugin-api",
"tags": []
},
"/deprecated/rescope": {
"id": "rescope",
"name": "Rescope Packages from @nrwl to @nx",
"description": "",
"mediaImage": "",
"file": "shared/deprecated/rescope",
"itemList": [],
"isExternal": false,
"path": "/deprecated/rescope",
"tags": []
},
"/see-also": {
"id": "see-also",
"name": "See Also",
Expand Down
11 changes: 0 additions & 11 deletions docs/generated/packages-metadata.json
Original file line number Diff line number Diff line change
Expand Up @@ -3086,17 +3086,6 @@
"root": "/packages/storybook",
"source": "/packages/storybook/src"
},
{
"description": "CLI for generating code and running commands",
"documents": [],
"executors": [],
"generators": [],
"githubRoot": "https://github.com/nrwl/nx/blob/master",
"name": "tao",
"packageName": "@nrwl/tao",
"root": "/packages/tao",
"source": "/packages/tao/src"
},
{
"description": "The Nx Plugin for building and testing applications using Vite",
"documents": [
Expand Down
18 changes: 5 additions & 13 deletions docs/map.json
Original file line number Diff line number Diff line change
Expand Up @@ -1121,19 +1121,6 @@
"file": "shared/recipes/nx-release/build-before-versioning"
}
]
},
{
"name": "Other",
"id": "other",
"description": "Other recipes you will find useful.",
"itemList": [
{
"name": "Rescope Packages from @nrwl to @nx",
"id": "rescope",
"tags": [],
"file": "shared/recipes/rescope"
}
]
}
]
},
Expand Down Expand Up @@ -1438,6 +1425,11 @@
"name": "v1 Nx Plugin API",
"id": "v1-nx-plugin-api",
"file": "shared/deprecated/v1-nx-plugin-api"
},
{
"name": "Rescope Packages from @nrwl to @nx",
"id": "rescope",
"file": "shared/deprecated/rescope"
}
]
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Rescope Packages from @nrwl to @nx

As of version 16, all the official Nx plugins are moving 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 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.

`@nrwl/*` packages are still provided and reexport the `@nx/*` packages so any third-party plugins should continue to work. Any generators (e.g. `@nrwl/react:library`) and executors (e.g. `@nrwl/webpack:webpack`) will continue to work in the interim as well.
As of version 20, the `@nrwl` scoped packages will no longer be published to npm.

## What Do You Need To Do?

Expand Down
16 changes: 5 additions & 11 deletions docs/shared/recipes/installation/update-global-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ There are some cases where an issue could arise when using an outdated global in
- `Could not find Nx modules in this workspace.`
- `The current directory isn't part of an Nx workspace.`

If you find yourself in this position, you will need to update your global install of Nx.
If you find yourself in this position, you will need to update your global installation of Nx.

In most cases, you can update a globally installed npm package by rerunning the command you used to install it.

If you cannot remember which package manager you installed Nx globally with or are still encountering issues, you can locate other installs of Nx with these commands:
If you cannot remember which package manager you installed Nx globally with or are still encountering issues, you can locate other installations of Nx with these commands:

{% tabs %}
{% tab label="npm" %}
Expand Down Expand Up @@ -43,33 +43,27 @@ pnpm list --global nx
{% /tab %}
{% /tabs %}

{% callout type="note" title="Older Global Installations" %}

In prior versions, Nx could be installed globally via `@nrwl/cli` or `@nrwl/tao`. If you are seeing these warnings but cannot find other global installations of Nx via the above commands, you should look for these packages as well. In general, you should remove these and install the latest version of `nx` instead.

{% /callout %}

You can then remove the extra global installations by running the following commands for the duplicate installations:

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

```shell
npm rm --global nx @nrwl/cli @nrwl/tao
npm rm --global nx
```

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

```shell
yarn global remove nx @nrwl/cli @nrwl/tao
yarn global remove nx
```

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

```shell
pnpm rm --global nx @nrwl/cli @nrwl/tao
pnpm rm --global nx
```

{% /tab %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

If your Nx plugin versions do not match the version of `nx` in your repository, you can encounter some difficult to debug errors. To get your Nx plugins back in sync, follow the steps below:

1. Identify all the official Nx plugins that are used in your repo. This includes `nx` and any packages in the `@nx/` or `@nrwl/` organization scope, except for plugins that are still in [nx-labs](https://github.com/nrwl/nx-labs). Also, `nx-cloud` does not need to match the other package versions.
1. Identify all the official Nx plugins that are used in your repo. This includes `nx` and any packages in the `@nx/` organization scope, except for plugins that are still in [nx-labs](https://github.com/nrwl/nx-labs). Also, `nx-cloud` does not need to match the other package versions.
2. Run `nx report` and identify the minimum and maximum version numbers for all the packages that need to by in sync.
3. Run `nx migrate --from=[minimumVersion] --to=[maximumVersion]`. Note that all the official Nx plugin migration generators are designed to be idempotent - meaning that running them multiple times is equivalent to running them once. This allows you to run the migrations for all plugins without being concerned about re-running a migration that was already run.

Expand Down
4 changes: 1 addition & 3 deletions docs/shared/reference/sitemap.md
Original file line number Diff line number Diff line change
Expand Up @@ -177,8 +177,6 @@
- [Configure Changelog Format](/recipes/nx-release/configure-changelog-format)
- [Publish a Custom Dist Directory](/recipes/nx-release/publish-custom-dist-directory)
- [Build Before Versioning](/recipes/nx-release/build-before-versioning)
- [Other](/recipes/other)
- [Rescope Packages from @nrwl to @nx](/recipes/other/rescope)
- [Troubleshoot Nx Console Issues](/recipes/nx-console/console-troubleshooting)
- [Showcase](/showcase)
- [Nx with your favorite tech](/showcase/example-repos)
Expand Down Expand Up @@ -232,6 +230,7 @@
- [globalImplicitDependencies](/deprecated/global-implicit-dependencies)
- [Angular Schematics and Builders](/deprecated/angular-schematics-builders)
- [v1 Nx Plugin API](/deprecated/v1-nx-plugin-api)
- [Rescope Packages from @nrwl to @nx](/deprecated/rescope)
- [See Also](/see-also)
- [Site Map](/see-also/sitemap)

Expand Down Expand Up @@ -712,7 +711,6 @@
- [convert-to-inferred](/nx-api/storybook/generators/convert-to-inferred)
- [migrate-7](/nx-api/storybook/generators/migrate-7)
- [migrate-8](/nx-api/storybook/generators/migrate-8)
- [tao](/nx-api/tao)
- [vite](/nx-api/vite)
- [documents](/nx-api/vite/documents)
- [Overview](/nx-api/vite/documents/overview)
Expand Down
4 changes: 2 additions & 2 deletions docs/shared/tutorials/angular-monorepo.md
Original file line number Diff line number Diff line change
Expand Up @@ -203,7 +203,7 @@ NX Capabilities in @nx/angular:
component-story : Creates a stories.ts file for a component.
component-test : Creates a cypress component test file for a component.
convert-tslint-to-eslint : Converts a project from TSLint to ESLint.
init : Initializes the `@nrwl/angular` plugin.
init : Initializes the `@nx/angular` plugin.
library : Creates an Angular library.
library-secondary-entry-point : Creates a secondary entry point for an Angular publishable library.
remote : Generate a Remote Angular Module Federation Application.
Expand All @@ -214,7 +214,7 @@ NX Capabilities in @nx/angular:
delegate-build : Delegates the build to a different target while supporting incremental builds.
ng-packagr-lite : Builds a library with support for incremental builds.
This executor is meant to be used with buildable libraries in an incremental build scenario. It is similar to the `@nrwl/angular:package` executor but with some key differences:
This executor is meant to be used with buildable libraries in an incremental build scenario. It is similar to the `@nx/angular:package` executor but with some key differences:
- It doesn't run `ngcc` automatically (`ngcc` needs to be run separately beforehand if needed, this can be done in a `postinstall` hook on `package.json`).
- It only produces ESM2020 bundles.
- It doesn't generate package exports in the `package.json`.
Expand Down
Loading

0 comments on commit f221a41

Please sign in to comment.