Install the kit

Download the kit as a zip

The simplest way to get the kit is to download it as a zip. You'll use a new copy of the kit for each new prototype you make. That way your prototypes don’t interfere with each other.

Decide where you want to keep your prototypes

We recommend keeping all your prototypes in one folder called projects.

Mac users

Create a folder called projects in your home folder. You can open your home folder by opening a new finder window, and selecting go > home from the top menu.

Screenshot of a 'projects' folder in the mac home folder

Windows users

Create a folder called projects in your Documents folder.

Unzip the kit and move it

Unzip the kit you downloaded - you should end up with a folder called govuk-prototype-kit followed by the version number.

Rename the folder to something descriptive for your prototype. For this guide, we’ll use juggling-licence-prototype.

Move the folder into your projects folder.

Terminal basics

The terminal (on Mac and Linux, git bash on Windows) lets you type in commands and run programs on your computer. You can also use it to browse your file system, for example to open folders.

You can follow a tutorial on basic terminal commands on the codebar website.

You need to navigate to your prototype in the terminal. Most commands for the kit need to be run in the prototype folder.

If you're using a Mac, enter:

cd ~/projects/juggling-licence-prototype

If you're using Windows, enter:

cd ~/Documents/projects/juggling-licence-prototype

If any of your folder names contain spaces, you must add quotation marks around everything after ~/. For example:

cd ~/"a folder name with spaces/Documents/projects/juggling-licence-prototype"

Install the kit

Install modules

You need to download extra code used by the kit before it can run. You can get this by running:

npm install

The install may take up to a minute. Whilst installing it may WARN about some items - this is ok. As long as there are no ERRORs you can continue.

Next (run the kit)