*Note: These instructions describe setting up the alpha version of govuk_frontend and can/will change*

## Add to Gemfile

From this repo build a local version of the gem:

```bash
gulp package
```

This will create a gem in `dist/gem`, which you can reference from your app's Gemfile.

```ruby
gem 'govuk_frontend_alpha', path: '../govuk_frontend_alpha/dist/gem'
```

Make sure you update the `path:` value to point to the correct place, if your path is different.

## Use the layout

Add this line to the bottom of your application layout view (usually in `app/views/layouts/application.html.erb`):

```erb
<%= render file: 'layouts/govuk_template' %>
```

## Importing SASS

In your application `application.scss`, add this to the start:

```scss
@import 'govuk-frontend';
```

You will then need to include your application stylesheet in the `:head` content block - see below.

## Customise the template

`govuk_template` provides blocks you can insert content into, to customise the basic layout.

For example, to set a `<title>` for your page you can set content for the `:page_title` block, and it will be inserted into the `govuk_template` layout.:

```eb
<% content_for :page_title, "My page title" %>
```

Or to add content to `<head>`, for stylesheets or similar:

```erb
<% content_for :head do %>
  <%= stylesheet_link_tag 'application', media: 'all' %>
  <%= csrf_meta_tags %>
<% end %>
```

Check out the [full list of blocks](template-blocks.md) you can use to customise the template.

Copy "Using with Rails" docs
Copy "Using with Rails" docs
