This gem is under heavy development and the API is likely to change.

This gem provides a suite of reusable components for the GOV.UK Design System. It is intended to provide a lightweight alternative to the GOV.UK Publishing Components library and is built with Github's ViewComponent framework. ViewComponent will be supported natively in Rails 6.1.

• #govuk_link_to
• #govuk_mail_to
• #govuk_button_to
• #govuk_back_to_top_link
• #govuk_skip_link

This library allows components to be rendered with Rails' render method or via the provided helpers. Here we'll use the govuk_accordion to render an accordion.

<%= govuk_accordion(id: 'def234') do |accordion| %>
  <%= accordion.add_section(title: 'Section 1') do %>
    <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
  <% end %>
  <%= accordion.add_section(title: 'Section 2') do %>
    <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
  <% end %>
  <%= accordion.add_section(title: 'Section 3') do %>
    <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
  <% end %>
<% end %>

Here is the rendered accordion.

For examples on usage see the guide page.

Add this line to your config/application.rb:

require "govuk/components"

Add this line to your application's Gemfile:

gem 'govuk-components'

And then execute:

$ bundle

Or install it yourself as:

$ gem install govuk-components

To setup the dummy app:

cd spec/dummy yarn install bundle install bin/rails db:create bin/rails db:migrate bin/rails s

After adding a new component update the examples page by cd-ing into the dummy app cd spec/dummy and running the rake task bin/rake generate_examples_page.

The gem is available as open source under the terms of the MIT License.