# README

dp-developer-site

A Go application that generates the HTML pages for the developer hub for ons.gov.uk.

To run this app you'll need certain versions installed:

These versions are what the pipeline will build with.

You can use nvm use to set your Node version to the current compatible one.

You'll also need github.com/fogleman/serve@latest which you can install using:

    make install-prereqs

The templates that make up the developer hub are available in /templates.

Static pages, such as the introduction are in /static.

The most common use case will be to update files and watch them change on the local site:

to watch the files for changes and host them run:

make watch-serve

or, with a custom port:

make watch-serve PORT=8000

To watch and automatically rebuild the site on any changes to any .go, .md or .tmpl file run:

make watch

To only serve the built assets (on default port of 23600) run:

make serve

...which has an optional PORT environment variable, for example:

make server PORT=8000

Environment variable	Default	Description
PORT	23600	The port to serve the files on

See CONTRIBUTING for details.