Create a prototype
You'll need to use a terminal to create and run prototypes (or Git Bash on Windows, which is part of Git for Windows). It lets you type in commands and run programs on your computer.
The important thing to remember about the terminal is that you work in one directory (folder) at any one time.
There are a few terminal commands you‘ll need to know to use the Prototype Kit.
A command is a short way to give your computer instructions to complete certain tasks.
The commands we use with the kit are:
cd [name of directory]= change to [name of directory]
cd ~= go to your home directory
ls= list all the folders and files in a directory
pwd= print working directory tells you what directory you’re in
- press up and down on the keyboard to go through previous commands
npm run dev= start the Prototype Kit (you need to be in your prototype folder)
To quit the Prototype Kit, in the terminal press the
c keys together.
If you type a command that the terminal does not understand, it will show you an error message. Do not worry if you see one of these. Have a look at the command you wrote and see if there is a typo in the command.
Make a folder for your prototypes
Create a folder called
prototypesfolder, create a folder for your new prototype. Use all lower case, hyphens instead of spaces and avoid any other special characters. For example
Navigate to your prototype folder
You need to navigate to your prototype folder in the terminal. Most commands for the kit need to be run in the prototype folder.
When you open the terminal it should look like this:
To navigate to your prototype, type this command into the terminal and press enter:
Your terminal should look like this:
Take note of what is upper or lower case - for example lower case 'd' for 'Documents' will not work.
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/prototypes/juggling-licence"
Create your prototype
npx govuk-prototype-kit@latest create