Swallow.MSBuild.Node 0.2.1

Swallow.MSBuild.Node

An MSBuild adapter to run npm run build in dotnet build and include the resulting files as static assets.

Installation

Add a package reference to Swallow.MSBuild.Node, but be sure to include the assets only for building:

<PackageReference Include="Swallow.MSBuild.Node" Version="0.1.1">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>build</IncludeAssets>
</PackageReference>

After that, once you've got a package.json in the root of your project, MSBuild will...

• Run npm install on a dotnet restore (if needed)
• Run npm run build on a dotnet build (if needed)
• Run npm run clean on a dotnet clean

If the build or clean scrpt is not defined, it will just not run anything. All scripts will be executed with $OUT_DIR set to the target directory; if you write to any file, be sure to pass that environment variable to any tooling. Otherwise, the resulting output will not be included as static asset.

Configuring

Swallow.MSBuild.Node can be configured in a number of ways. Shown is the default value for every property:

Properties

Items excluded by default

There are a handful of patterns configured for FrontendBuildExcludes by default:

• $(FrontendRootPath)node_modules/
• wwwroot/ (unless ExcludeWwwRoot is set to false)
• Razor component-specific assets ($(FrontendRootPath)**/*.razor.js and $(FrontendRootPath)**/*.razor.css)
• Razor page-specific assets ($(FrontendRootPath)**/*.cshtml.js and $(FrontendRootPath)**/*.cshtml.css)

Items

FrontendBuild includes - by default - all relevant files found in $(FrontendRootPath), whereas FrontendConfig includes the package.json and package-lock.json. Both item groups will be considered for the incremental build; if any of these files is newer than the generated output files in $(FrontendOutputPath), a npm run build is triggered.

You can add your own items to any of these item groups if you need to handle additional files not covered by the default includes. Note that certain files will be ignored even when added to the item groups, most notably those found in these folders:

• node_modules/
• wwwroot/ (unless ExcludeWwwRoot is set to false)
• bin/
• obj/

The default items consider all files with the following extensions as relevant:

• .js and .jsx
• .ts and .tsx
• .css
• .scss and .sass
• .less
• .styl