Skip to main content
Table of contents

Get started

The following instructions assume that you have a Mac laptop.

You must set up the following on your local machine:

Administrator rights on your laptop

If you are a Government Digital Service (GDS) employee, raise a ticket on the GDS Web Help Desk to request administrator rights on your laptop.

If you are not a GDS employee, follow your internal IT processes.

Install Xcode command line interface tools

  1. Go to Apple Developer Downloads.
  2. Search for “Xcode”.
  3. Select the appropriate Command Line Tools (macOS x.x) for Xcode x.x and download the file.
  4. Install the file.

If you have a software centre for your department, you should be able to install the Xcode command line tools through this software centre.

Install Ruby

You can install Ruby to any location on your local machine.

You can install Ruby in multiple ways, for example using Ruby Version Manager (RVM) or rbenv. These instructions assume you are using RVM.

  1. Run the following in the command line to install the ruby version manager:

    \curl -sSL https://get.rvm.io | bash -s stable --ruby
    
  2. Check the Ruby downloads page for the latest version of Ruby.

  3. Run rvm install ruby-x.x.x to install the latest version of Ruby.

Install Middleman

You can install Middleman to any location on your local machine.

Run the following in the command line to install Middleman:

gem install middleman
This page was last reviewed on 1 July 2020. It needs to be reviewed again on 1 July 2021 by the page owner #tech-writers .
This page was set to be reviewed before 1 July 2021 by the page owner #tech-writers. This might mean the content is out of date.