The aim of this template is to give you a head start in setting up a new web application for Companies House.
The template uses Express, TypeScript and the GovUK Frontend toolkit to set up a simple example of a web application that runs on NodeJS.
You can create a new project from this template by clicking the Use this template button.
- Quick start
- Prerequisites
- Running the server
- Static assets
- Compiling the application
- Linting
- Testing
If you are familiar with NodeJS development and already have it installed, simply run the init make task
make init
And then start the application
npm start
Then go to http://localhost:3000.
You are going to need a few things to begin. Firstly, NodeJS. There are a few ways to install it.
Node version manager allows you to install multiple versions side by side on the host machine.
Once you have that installed, you will need to install the dependencies (locally) and GulpJS (globally). This task runner is used to compile the Sass used in the GovUK Frontend.
npm i
npm install gulp-cli -g
There are two ways to run the server in development. You run it in normal mode;
npm start
Or, automatically reload the server once you make changes to source code;
npm run start:watch
Sass is used to compile the css from GovUK Frontend. The static gulp task will build the necessary files and output them to the dist folder.
gulp static
During development, static assets are served from this folder using the url prefix /static.
TypeScript compiles down the JavaScript code that eventually gets run via NodeJS. The build npm task will write the JavaScript to the dist folder.
npm run build
It is this code that gets run in production.
TSLint is used to perform static analysis on code style.
npm run lint
Tests can be found in the directory src/test. The framework used is Jest along with Supertest to dispatch handlers that can have assertions made against the responses. Execute the following to run the tests;
npm t