miel.truyen/nx
1
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity
nx/docs/generated/packages/workspace/documents/overview.md
Jack Hsu 66eaf2fc74
docs(misc): remove /nx-api pages (#31453) 
This PR removes the `/nx-api` pages from `nx-dev`. They are already
redirected from `/nx-api` to either `/technologies` or
`/reference/core-api` URLs.

e.g. `/nx-api/nx` goes to `/reference/core-api/nx` and `/nx-api/react`
goes to `/technologies/react/api`

**Changes**:
- Remove old `nx-api.json` from being generated in
`scripts/documentation/generators/generate-manifests.ts` -- this was
used to generate the sitemap
- Remove `pages/nx-api` from Next.js app since we don't need them
- Remove workaround from link checker
`scripts/documentation/internal-link-checker.ts` -- the angular
rspack/rsbuild and other workarounds are gone now that they are proper
docs in `map.json`
- Update Powerpack/Remote Cache reference docs to exclude API documents
(since they are duplicated in the Intro page) --
`nx-dev/models-document/src/lib/mappings.ts`
- All content in `docs` have been updated with new URL structure

**Note:** Redirects are already handled, and Claude Code was used to
verify the updated `docs/` URLs (see report below). The twelve 404s
links were updated by hand.

## Verification Report

https://gist.github.com/jaysoo/c7863fe7e091cb77929d1976165c357a
2025-06-04 16:57:01 -04:00

2.7 KiB
Raw Blame History

title description
Workspace Plugin for Nx Learn about the core workspace plugin that provides essential executors and generators for any Nx workspace, including tools for project management.

The workspace plugin contains executors and generators that are useful for any Nx workspace. It should be present in every Nx workspace and other plugins build on it.

Creating Local Generators

Codifying your organization's best practices into local generators is a great way to ensure that the best practices are easy to follow and implement. Running nx g @nx/plugin:plugin packages/feature will create a local plugin with a generator which is written the same way generators are written for Nx plugins.

See more about local generators

Reorganizing Projects

After some time of working within a workspace, projects might need to be moved or sometimes even removed. The workspace plugin provides the @nx/workspace:move and @nx/workspace:remove generators to help aid with this.

Moving Projects

Running nx g @nx/workspace:move --projectName my-lib --destination new/location/my-lib will move the my-lib library to libs/new/location/my-lib.

Moving the files manually can be done easily but a lot of steps are often missed when projects are moved. This generator will also handle the following:

  1. The project's files will be moved
  2. The project will be renamed to new-location-my-lib
  3. The path mapping in tsconfig.base.json will be changed to @npmScope/new/location/my-lib
  4. Imports in other projects will be changed to @npmScope/new/location/my-lib
  5. Paths in target options such as output path will be changed
  6. Other configuration will be updated too, such as extends in tsconfig.json, the name of the project in jest.config.js, and the extends in .eslintrc.json

See more about @nx/workspace:move

Removing Projects

Running nx g @nx/workspace:remove my-lib will remove the my-lib from the workspace. It is important to note that sometimes, projects cannot be removed if they are still depended on by other projects.

Like when moving projects, some steps are often missed when removing projects. This generator will also handle the following:

  1. Checks if other projects depend on the project being removed. This can be ignored via the --forceRemove flag.
  2. The project's files will be deleted.
  3. The project's configuration will be removed.
  4. The path mapping in tsconfig.base.json will be removed.

See more about @nx/workspace:remove