Getting Started

Prerequisites#

Have an existing nx workspace. For creating this, see nrwl's documentation.
.NET SDK is installed, and dotnet is available on the path. For help on this, see Microsoft's documentation

Installation#

NPM#

npm i --save-dev @nx-dotnet/corenpx nx g @nx-dotnet/core:init

PNPM#

pnpm i --save-dev @nx-dotnet/corepnpx nx g @nx-dotnet/core:init

Yarn#

yarn add --dev @nx-dotnet/corenpx nx g @nx-dotnet/core:init

Generate and run your first api!#

Generate my-api, and my-api-test with C# and nunit tests.

npx nx g @nx-dotnet/core:app my-api --test-template nunit --language C#

Run my-api locally

npx nx serve my-api

nrwl/nx/enforce-module-boundaries support#

Nrwl publishes an eslint rule for enforcing module boundaries based on tags in a library. We recently added similar support to nx-dotnet.

To avoid duplicating the rules configuration, if your workspace already has it, nx-dotnet can read the dependency constraints from your workspace's eslint files. It does this by looking at what is configured for typescript files.

If your workspace does not currently contain eslint, do not worry! You do not have to install eslint just for its configuration. The same dependency constraints can be placed inside of your .nx-dotnet.rc.json file at workspace root. This should look something like below:

{  "moduleBoundaries": [    {      "onlyDependOnLibsWithTags": ["a", "shared"],      "sourceTag": "a"    },    {      "onlyDependOnLibsWithTags": ["b", "shared"],      "sourceTag": "b"    },    {      "onlyDependOnLibsWithTags": ["shared"],      "sourceTag": "shared"    }  ],  "nugetPackages": {}}