61436a64ef
Co-authored-by: Katerina Skroumpelou <mandarini@users.noreply.github.com> Co-authored-by: Colum Ferry <cferry09@gmail.com> Co-authored-by: Emily Xiong <xiongemi@gmail.com> Co-authored-by: Nicholas Cunningham <ndcunningham@gmail.com> Co-authored-by: Jason Jean <jasonjean1993@gmail.com> Co-authored-by: Victor Savkin <mail@vsavkin.com> Co-authored-by: Jack Hsu <jack.hsu@gmail.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# Workspace Generators
|
|
|
|
In Nx 13.10, we introduced the ability to run generators from Nx plugins in the workspace they were created in.
|
|
|
|
By using a "local" plugin, you can set the plugin as your workspace's default collection and get several other affordances that are not provided to workspace generators. This is the preferred method for "workspace generators", and existing generators will eventually be transitioned to use a local plugin.
|
|
|
|
Check the [local generator guide](/extending-nx/recipes/local-generators) for information on creating a new plugin.
|
|
|
|
## Converting workspace generators to local generators
|
|
|
|
{% callout type="info" %}
|
|
When migrating to Nx 16, a new workspace plugin is automatically generated in the tools folder if you already have workspace-generators.
|
|
{% /callout %}
|
|
|
|
- If you don't already have a local plugin, use Nx to generate one:
|
|
|
|
```shell
|
|
npm add -D @nx/plugin
|
|
nx g @nx/plugin:plugin my-plugin
|
|
```
|
|
|
|
- Use the Nx CLI to generate the initial files needed for your generator. Replace `my-generator` with the name of your workspace generator.
|
|
|
|
```shell
|
|
nx generate @nx/plugin:generator my-generator --project=my-plugin
|
|
```
|
|
|
|
- Copy the code for your workspace generator into the newly created generator's folder. e.g. `libs/my-plugin/src/generators/my-generator/`
|
|
|
|
- Now you can run the generator like this:
|
|
|
|
```shell
|
|
nx g my-generator
|
|
```
|