misc(guide): tweak lerna guides
This commit is contained in:
parent
57593f5df7
commit
411f467e5c
@ -1,5 +1,8 @@
|
|||||||
# Nx and Yarn/Lerna (Workspaces for Publishing NPM Packages)
|
# Nx and Yarn/Lerna (Workspaces for Publishing NPM Packages)
|
||||||
|
|
||||||
|
> In our teams we see a shift away from Lerna and a strong preference to use Nx for managing JavaScript-based monorepos.
|
||||||
|
> [Thoughtworks Technology Radar 2021](https://www.thoughtworks.com/en-ca/radar/tools/nx)
|
||||||
|
|
||||||
Nx has more in common with the build tools used at Google or Facebook (just made a lot more easily accessible for other
|
Nx has more in common with the build tools used at Google or Facebook (just made a lot more easily accessible for other
|
||||||
companies) than with tools like Yarn Workspaces or Lerna. When using the word "monorepo" in the context of say Google,
|
companies) than with tools like Yarn Workspaces or Lerna. When using the word "monorepo" in the context of say Google,
|
||||||
we imagine a much richer dev experience, not simply collocating a few projects side-by-side.
|
we imagine a much richer dev experience, not simply collocating a few projects side-by-side.
|
||||||
|
|||||||
@ -1,5 +1,8 @@
|
|||||||
# Adding Nx to Lerna/Yarn/PNPM/NPM Workspace
|
# Adding Nx to Lerna/Yarn/PNPM/NPM Workspace
|
||||||
|
|
||||||
|
> In our teams we see a shift away from Lerna and a strong preference to use Nx for managing JavaScript-based monorepos.
|
||||||
|
> [Thoughtworks Technology Radar 2021](https://www.thoughtworks.com/en-ca/radar/tools/nx)
|
||||||
|
|
||||||
If you have a monorepo that is powered by Lerna, Yarn, PNPM, or NPM, you can transform it into an Nx workspace by
|
If you have a monorepo that is powered by Lerna, Yarn, PNPM, or NPM, you can transform it into an Nx workspace by
|
||||||
running this command:
|
running this command:
|
||||||
|
|
||||||
@ -140,6 +143,10 @@ import source code analysis. If the path mappings are deduced incorrectly, feel
|
|||||||
|
|
||||||
## Real world examples of using add-nx-to-monorepo
|
## Real world examples of using add-nx-to-monorepo
|
||||||
|
|
||||||
|
### Speeding Up Facebook React Monorepo with Nx
|
||||||
|
|
||||||
|
<iframe width="560" height="315" src="https://www.youtube.com/embed/XLP2RAOwfLQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||||
|
|
||||||
### Speeding Up Remotion Monorepo with Nx
|
### Speeding Up Remotion Monorepo with Nx
|
||||||
|
|
||||||
<iframe width="560" height="315" src="https://www.youtube.com/embed/TXySu4dZLp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allow="fullscreen"></iframe>
|
<iframe width="560" height="315" src="https://www.youtube.com/embed/TXySu4dZLp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allow="fullscreen"></iframe>
|
||||||
|
|||||||
@ -0,0 +1,60 @@
|
|||||||
|
---
|
||||||
|
title: '@nrwl/js:node executor'
|
||||||
|
description: 'Build Node.js applications'
|
||||||
|
---
|
||||||
|
|
||||||
|
# @nrwl/js:node
|
||||||
|
|
||||||
|
Build Node.js applications
|
||||||
|
|
||||||
|
Options can be configured in `angular.json` when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/core-concepts/configuration#targets.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### buildTarget (_**required**_)
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The target to run to build you the app
|
||||||
|
|
||||||
|
### args
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args when starting the app
|
||||||
|
|
||||||
|
### host
|
||||||
|
|
||||||
|
Default: `localhost`
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The host to inspect the process on
|
||||||
|
|
||||||
|
### inspect
|
||||||
|
|
||||||
|
Default: `inspect`
|
||||||
|
|
||||||
|
Type: `string | boolean `
|
||||||
|
|
||||||
|
Ensures the app is starting with debugging
|
||||||
|
|
||||||
|
### port
|
||||||
|
|
||||||
|
Default: `9229`
|
||||||
|
|
||||||
|
Type: `number`
|
||||||
|
|
||||||
|
The port to inspect the process on. Setting port to 0 will assign random free ports to all forked processes.
|
||||||
|
|
||||||
|
### runtimeArgs
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args passed to the node process
|
||||||
|
|
||||||
|
### waitUntilTargets
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
The targets to run to before starting the node app
|
||||||
@ -0,0 +1,60 @@
|
|||||||
|
---
|
||||||
|
title: '@nrwl/js:node executor'
|
||||||
|
description: 'Build Node.js applications'
|
||||||
|
---
|
||||||
|
|
||||||
|
# @nrwl/js:node
|
||||||
|
|
||||||
|
Build Node.js applications
|
||||||
|
|
||||||
|
Options can be configured in `workspace.json` when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/core-concepts/configuration#targets.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### buildTarget (_**required**_)
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The target to run to build you the app
|
||||||
|
|
||||||
|
### args
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args when starting the app
|
||||||
|
|
||||||
|
### host
|
||||||
|
|
||||||
|
Default: `localhost`
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The host to inspect the process on
|
||||||
|
|
||||||
|
### inspect
|
||||||
|
|
||||||
|
Default: `inspect`
|
||||||
|
|
||||||
|
Type: `string | boolean `
|
||||||
|
|
||||||
|
Ensures the app is starting with debugging
|
||||||
|
|
||||||
|
### port
|
||||||
|
|
||||||
|
Default: `9229`
|
||||||
|
|
||||||
|
Type: `number`
|
||||||
|
|
||||||
|
The port to inspect the process on. Setting port to 0 will assign random free ports to all forked processes.
|
||||||
|
|
||||||
|
### runtimeArgs
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args passed to the node process
|
||||||
|
|
||||||
|
### waitUntilTargets
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
The targets to run to before starting the node app
|
||||||
@ -0,0 +1,60 @@
|
|||||||
|
---
|
||||||
|
title: '@nrwl/js:node executor'
|
||||||
|
description: 'Build Node.js applications'
|
||||||
|
---
|
||||||
|
|
||||||
|
# @nrwl/js:node
|
||||||
|
|
||||||
|
Build Node.js applications
|
||||||
|
|
||||||
|
Options can be configured in `workspace.json` when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/core-concepts/configuration#targets.
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### buildTarget (_**required**_)
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The target to run to build you the app
|
||||||
|
|
||||||
|
### args
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args when starting the app
|
||||||
|
|
||||||
|
### host
|
||||||
|
|
||||||
|
Default: `localhost`
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The host to inspect the process on
|
||||||
|
|
||||||
|
### inspect
|
||||||
|
|
||||||
|
Default: `inspect`
|
||||||
|
|
||||||
|
Type: `string | boolean `
|
||||||
|
|
||||||
|
Ensures the app is starting with debugging
|
||||||
|
|
||||||
|
### port
|
||||||
|
|
||||||
|
Default: `9229`
|
||||||
|
|
||||||
|
Type: `number`
|
||||||
|
|
||||||
|
The port to inspect the process on. Setting port to 0 will assign random free ports to all forked processes.
|
||||||
|
|
||||||
|
### runtimeArgs
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
Extra args passed to the node process
|
||||||
|
|
||||||
|
### waitUntilTargets
|
||||||
|
|
||||||
|
Type: `array`
|
||||||
|
|
||||||
|
The targets to run to before starting the node app
|
||||||
Loading…
x
Reference in New Issue
Block a user