nx-loopback-next v0.0.4
nx-loopback-next
Create a Loopback 4 application within your Nx Monorepo. This is more of a proof of concept, and may not be production ready. My hope is that Nrwl adds official support for Loopback within Nx. Pull requests are more than welcome.
Install package
With Yarn:
yarn add nx-loopback-next
With NPM:
npm i nx-loopback-next --save
Github:
npm i https://github.com/codephobia/nx-loopback-next.git --save
And then you must build the contents in your node_modules/nx-loopback-next with yarn build.
Create a new application
With Nrwl CLI:
nx g nx-loopback-next:app
With Angular CLI:
ng g nx-loopback-next:app
Schematics
Init
Initializes the Nx monorepo to have dependencies for Loopback 4. This is a hidden schematic and should not ever need to be called.
Schema
| Name | Type | Required | Description |
|---|---|---|---|
| skipFormat | boolean | false | Not actually being used yet |
Application
Generates a new Loopback 4 application.
Schema
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Name of the new application |
| tags | string | no | Comma separated tags used for linting |
| skipFormat | boolean | false | Not actually being used yet |
Builders
Build
Builds the application using lb-tsc.
Schema
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| appPath | string | yes | Path the application. ie. apps/backend | |
| tsConfig | string | yes | Path to the tsConfig.json file for Loopback | |
| clean | boolean | false | no | Delete dist files prior to build |
Execute
Runs the build application with Node.js.
Schema
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| appPath | string | yes | Path the application. ie. apps/backend | |
| NODE_ENV | string | development | no | Node environment for the application |
| args | string[] | [] | no | Arguments to add to the command |
| buildTarget | string | yes | The Nx build command for the new application | |
| runOnly | boolean | true | no | Skip the build before running |
| clean | boolean | false | no | Delete dist files prior to build |
Features still missing
I would like to see the following features added to the project.
- Build with watch
- Linting
- Unit tests
Shoutouts and Credit
I couldn't have built this without the following resources and wanted to make sure to note them:
The official Nx github is a great resource for seeing how the team at Nrwl are building schematics and builders for Nx. https://github.com/nrwl/nx
Abdooly wrote a custom builder for using ts-node. That repo was a massive help in understanding how to make a builder without using webpack. https://github.com/abdoolly/ts-node-builder