A .NET project which include some of the common things needed at NHS.UK.

View the latest deployment of main branch.

• ASP .NET Core MVC Views using .NET 3.1 Framework
• NHS.UK frontend library
• NHS.UK header and footer Nuget package

Setup for NUnit unit tests.

Automated CI pipeline to deploy pushes to main to nhsuk development environment.

• Checkout
• Nuget - restore packages including
• Test - runs tests in NUnit test project
• Build - build web application
• Publish - publish web application
• Deploy - deploy to Azure web service

The application runs on Windows and Linux using either Visual Studio or CLI.

For dev the application will run on https://localhost:5001/service-name with the base path being configurable in Startup.cs

We always use base paths for applications so it is easier for infra to handle our application in higher environments and to ensure any assets are served from the correct application and not the domain root which would hit Wagtail.

Building the web application will automatically run npm install && npm run build.

The npm install command installs all NPM dependencies listed within the package.json.

The npm run build command runs the gulp build task.

The application contains 2 tasks in gulpfile.js.

The task gulp build will build CSS and JS assets and add them to wwwroot/dist. These files are not commited to the repository.

The task gulp does the same as gulp build but adds a watch to recompile assets as they change in wwwroot/src/**/*.

A single JavaScript file exists as wwwroot/src/main.scss.

This file imports the required SCSS from NHS.UK frontend library.

Any custom SCSS can be added or imported into this file.

The Gulp tasks compile this file into CSS and minify it for production.

The resulting JavaScript is saved in wwwroot/dist/main.css. This file is not commited to the repository.

A single JavaScript file exists as wwwroot/src/main.js.

This file imports the required JavaScript from NHS.UK frontend library.

Any custom ES2015 JavaScript can be added or imported into this file.

The Gulp tasks transpile this file into ES5 JavaScript using Babel and minify it for production. This file is not commited to the repository.

The resulting JavaScript is saved in wwwroot/dist/main.js. This file is not commited to the repository.

The header and footer are dynamically built by the nhsuk.header-and-footer-client Nuget package.

Adobe analytics script is loaded in based on AdobeAnalyticsScriptUrl set in appsettings.json.

Adobe analytics digitalData object is built dynamically from application URL.

NHS.UK cookier banner is loaded in based on CookieScriptUrl set in appsettings.json.