ccs-frontend_helpers 0.1.0.rc.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 688e4ab0ddc41179157be55abb6a1afe720c55e027305e840d009cfbdad580c9
+  data.tar.gz: c8aa5d34f38f99b2e70f4eea14d0614075bd2c6d58ed7ba1fdb92683594ad65e
+SHA512:
+  metadata.gz: 7a3f14a98c028b451ba6d39962923eac034b9a0619adb3722d40f7f3230dd860f5ca8bffc4eb1f94292b1c6d87772df96c272a946e0c00d78fdc681f16cb3cc4
+  data.tar.gz: 89519f4a8a15e9a2d4517a03562e2c001635f5b79fbb1020474393f45b32f7b8f0cf22d3c1541e711e945425542416791cb4cc6c9e4608faf336e14af668277a

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,127 @@
+---
+require:
+  - rubocop-rspec
+  - rubocop-rails
+  - rubocop-rake
+
+AllCops:
+    NewCops: enable
+    TargetRubyVersion: 2.7
+    Exclude:
+        - 'bin/**/*'
+        - 'tmp/**/*'
+        - 'vendor/**/*'
+
+Bundler/OrderedGems:
+    Enabled: false
+
+Style/Alias:
+    Enabled: false
+
+Style/FrozenStringLiteralComment:
+    Enabled: false
+
+Style/NumericLiterals:
+    Enabled: false
+
+Style/TrailingCommaInArrayLiteral:
+    Enabled: false
+
+Style/TrailingCommaInHashLiteral:
+    Enabled: false
+
+Style/TrailingCommaInArguments:
+    Enabled: false
+
+Style/Documentation:
+    Enabled: false
+
+Style/DoubleNegation:
+    Enabled: false
+
+Style/WordArray:
+    Enabled: false
+
+Style/ClassAndModuleChildren:
+    Enabled: false
+
+Layout/EndOfLine:
+   EnforcedStyle: lf
+
+Layout/TrailingEmptyLines:
+    Enabled: true
+
+Layout/LineLength:
+    Max: 120
+    Enabled: false
+    AllowedPatterns:
+        - 'it .* do$'
+        - 'context .* do$'
+        - 'scenario .* do$'
+
+Metrics/ClassLength:
+    Enabled: false
+
+Metrics/MethodLength:
+    Max: 50
+    Exclude:
+
+Metrics/AbcSize:
+    Max: 25 # TODO: Restore to '20'
+    Exclude:
+        - 'spec/**/*'
+
+Metrics/BlockLength:
+    Max: 40
+    Exclude:
+        - 'spec/**/*'
+
+RSpec/ContextWording:
+    Prefixes:
+      - when
+      - with
+      - without
+      - and
+
+Metrics/ModuleLength:
+    Exclude:
+        - 'spec/ccs/frontend_helpers/**/*'
+
+RSpec/MultipleMemoizedHelpers:
+    Enabled: false
+
+RSpec/VariableName:
+    Enabled: false
+
+Naming/VariableNumber:
+    Enabled: false
+
+Lint/MissingSuper:
+    Enabled: false
+
+Rails/HelperInstanceVariable:
+    Enabled: false
+
+Style/OptionalBooleanParameter:
+    Enabled: false
+
+RSpec/VerifiedDoubleReference:
+    Enabled: false
+
+RSpec/NestedGroups:
+    Max: 5
+
+RSpec/ExampleLength:
+    Exclude:
+         - 'spec/ccs/frontend_helpers/**/*'
+
+Rails/DynamicFindBy:
+  Whitelist:
+    - find_by_id
+
+RSpec/MultipleExpectations:
+    Max: 3
+
+RSpec/FilePath:
+    CustomTransform:
+        GovUKFrontend: govuk_frontend

data/CHANGELOG.md

@@ -0,0 +1,44 @@
+## [0.1.0.rc.1] - 2023-02-22
+
+Initial release of CCS Frontend Helpers.
+This release contains view helpers that are used to create GOV.UK and CCS components.
+
+The following GOV.UK helpers have been added:
+
+- Accordion
+- Back link
+- Breadcrumbs
+- Button
+- Character count
+- Checkboxes
+- Cookie banner
+- Date input
+- Details
+- Error message
+- Error summary
+- Fieldset
+- File upload
+- Footer
+- Header
+- Inset text
+- Notification banner
+- Pagination
+- Panel
+- Phase banner
+- Radios
+- Select
+- Skip link
+- Summary list
+- Table
+- Tabs
+- Tag
+- Text input
+- Textarea
+- Warning text
+
+The following CCS helpers have been added:
+
+- Dashboard Panels
+- Logo
+- Header
+- Footer

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ccs-frontend_helpers.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+
+gem 'rspec', '~> 3.0'

data/Gemfile.lock

@@ -0,0 +1,241 @@
+PATH
+  remote: .
+  specs:
+    ccs-frontend_helpers (0.1.0.rc.1)
+      rails (>= 6.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailbox (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      activejob (= 7.0.4.2)
+      activerecord (= 7.0.4.2)
+      activestorage (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      mail (>= 2.7.1)
+      net-imap
+      net-pop
+      net-smtp
+    actionmailer (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      actionview (= 7.0.4.2)
+      activejob (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      mail (~> 2.5, >= 2.5.4)
+      net-imap
+      net-pop
+      net-smtp
+      rails-dom-testing (~> 2.0)
+    actionpack (7.0.4.2)
+      actionview (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      rack (~> 2.0, >= 2.2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      activerecord (= 7.0.4.2)
+      activestorage (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      globalid (>= 0.6.0)
+      nokogiri (>= 1.8.5)
+    actionview (7.0.4.2)
+      activesupport (= 7.0.4.2)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (7.0.4.2)
+      activesupport (= 7.0.4.2)
+      globalid (>= 0.3.6)
+    activemodel (7.0.4.2)
+      activesupport (= 7.0.4.2)
+    activerecord (7.0.4.2)
+      activemodel (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+    activestorage (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      activejob (= 7.0.4.2)
+      activerecord (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      marcel (~> 1.0)
+      mini_mime (>= 1.1.0)
+    activesupport (7.0.4.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
+    ast (2.4.2)
+    builder (3.2.4)
+    capybara (3.38.0)
+      addressable
+      matrix
+      mini_mime (>= 0.1.3)
+      nokogiri (~> 1.8)
+      rack (>= 1.6.0)
+      rack-test (>= 0.6.3)
+      regexp_parser (>= 1.5, < 3.0)
+      xpath (~> 3.2)
+    concurrent-ruby (1.2.0)
+    crass (1.0.6)
+    date (3.3.3)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    erubi (1.12.0)
+    globalid (1.1.0)
+      activesupport (>= 5.0)
+    i18n (1.12.0)
+      concurrent-ruby (~> 1.0)
+    json (2.6.3)
+    loofah (2.19.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    mail (2.8.1)
+      mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
+    marcel (1.0.2)
+    matrix (0.4.2)
+    method_source (1.0.0)
+    mini_mime (1.1.2)
+    minitest (5.17.0)
+    net-imap (0.3.4)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.1)
+      timeout
+    net-smtp (0.3.3)
+      net-protocol
+    nio4r (2.5.8)
+    nokogiri (1.14.1-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.14.1-x86_64-linux)
+      racc (~> 1.4)
+    parallel (1.22.1)
+    parser (3.2.1.0)
+      ast (~> 2.4.1)
+    public_suffix (5.0.1)
+    racc (1.6.2)
+    rack (2.2.6.2)
+    rack-test (2.0.2)
+      rack (>= 1.3)
+    rails (7.0.4.2)
+      actioncable (= 7.0.4.2)
+      actionmailbox (= 7.0.4.2)
+      actionmailer (= 7.0.4.2)
+      actionpack (= 7.0.4.2)
+      actiontext (= 7.0.4.2)
+      actionview (= 7.0.4.2)
+      activejob (= 7.0.4.2)
+      activemodel (= 7.0.4.2)
+      activerecord (= 7.0.4.2)
+      activestorage (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      bundler (>= 1.15.0)
+      railties (= 7.0.4.2)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.5.0)
+      loofah (~> 2.19, >= 2.19.1)
+    railties (7.0.4.2)
+      actionpack (= 7.0.4.2)
+      activesupport (= 7.0.4.2)
+      method_source
+      rake (>= 12.2)
+      thor (~> 1.0)
+      zeitwerk (~> 2.5)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.7.0)
+    rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.1)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.45.1)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.24.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.26.0)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.17.0)
+      rubocop (~> 1.41)
+    rubocop-rails (2.17.4)
+      activesupport (>= 4.2.0)
+      rack (>= 1.1)
+      rubocop (>= 1.33.0, < 2.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.18.1)
+      rubocop (~> 1.33)
+      rubocop-capybara (~> 2.17)
+    ruby-progressbar (1.11.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    thor (1.2.1)
+    timeout (0.3.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.4.2)
+    webrick (1.7.0)
+    websocket-driver (0.7.5)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    xpath (3.2.0)
+      nokogiri (~> 1.8)
+    yard (0.9.28)
+      webrick (~> 1.7.0)
+    zeitwerk (2.6.6)
+
+PLATFORMS
+  x86_64-darwin-19
+  x86_64-darwin-20
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.3)
+  capybara (~> 3.38.0)
+  ccs-frontend_helpers!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.36)
+  rubocop-rails (~> 2.16)
+  rubocop-rake (~> 0.6)
+  rubocop-rspec (~> 2.13)
+  simplecov (~> 0.21)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.3.12

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 tim-s-ccs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,102 @@
+# CCS Frontend Helpers
+
+[![Ruby](https://github.com/tim-s-ccs/ccs-frontend_helpers/actions/workflows/main.yml/badge.svg)](https://github.com/tim-s-ccs/ccs-frontend_helpers/actions/workflows/main.yml)
+[![Gem Version](https://badge.fury.io/rb/ccs-frontend_helpers.svg)](https://badge.fury.io/rb/ccs-frontend_helpers)
+
+The CCS Frontend Helpers gem was created for use in the Crown Marketplace projects at the Crown Commercial Service.
+This project contains two applications (both use the Ruby on Rails framework):
+- [Crown Marketplace](https://github.com/Crown-Commercial-Service/crown-marketplace)
+- [Crown Marketplace Legacy](https://github.com/Crown-Commercial-Service/crown-marketplace-legacy)
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add ccs-frontend_helpers
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install ccs-frontend_helpers
+
+## Usage
+
+To use this gem, simply add it to your Gemfile (as described above).
+
+### Helpers
+
+To include the helper methods from the `GovUKFrontend` and `CCSFrontend` module, you can include the `CCS::FrontendHelpers` module in your `app/helpers/application_helper.rb` file like so:
+
+```ruby
+module ApplicationHelper
+  include CCS::FrontendHelpers
+end 
+```
+
+This will give you access to a variety of [GDS components](https://design-system.service.gov.uk/components) and [CCS components](https://github.com/tim-s-ccs/ts-ccs-frontend) to use in your application views.
+The `GovUKFrontend` components are based on the components found in [GOV.UK Frontend v4.5.0](https://github.com/alphagov/govuk-frontend/releases/tag/v4.5.0).
+
+Documentation for the helper methods can be found at [LINK TO RDOCS](#)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+### Linting
+
+The [rubocop](https://github.com/rubocop-hq/rubocop) & [rubocop-rspec](https://github.com/rubocop-hq/rubocop-rspec) gems are used to enforce standard coding styles.
+Some "cops" in the standard configuration have been disabled or adjusted in [`.rubocop.yml`](https://github.com/Crown-Commercial-Service/crown-marketplace-legacy/blob/master/.rubocop.yml).
+Rubocop linting is run as part of the default Rake task, but can be run individually using `rake rubocop`.
+
+### Testing
+
+#### Unit testing
+There is an automated RSpec-based test suite.
+
+You can run all the unit tests with:
+```shell
+bundle exec rake
+```
+
+To run a specific unit test, use:
+```shell
+bundle exec rspec /path/to/file_spec.rb
+```
+
+All the specs are run as part of the Pull Request process.
+
+### Code coverage
+
+Code coverage is measured by [simplecov](https://github.com/simplecov-ruby/simplecov)
+
+After running the Rspec tests, open [coverage/index.html](coverage/index.html) in a browser to see the code coverage percentage.
+
+### Managing dependencies
+ 
+We use [dependabot](https://github.com/dependabot) and [Snyk](https://app.snyk.io/org/ccs-wattsa) to help manage our dependencies.
+
+We schedule `dependabot` to run every Sunday night which will get the latest dependency updates.
+ 
+Snyk is used more for analysing security issues and it will raise PRs itself for a developer to analyse.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/tim-s-ccs/ccs-frontend_helpers.
+
+To contribute to the project, you should checkout a new branch from `main` and make your changes.
+
+Before pushing to the remote, you should squash your commits into a single commit.
+This can be done using `git rebase -i main` and changing `pick` to `s` for the commits you want to squash (usually all but the first).
+This is not required but it helps keep the commit history fairly neat and tidy
+
+Once you have pushed your changes, you should open a Pull Request on the main branch.
+This will run:
+- Rubocop
+- Unit tests
+
+Once all these have passed, and the PR has been reviewed and approved by another developer, you can merge the PR.
+
+## Licence
+
+The gem is available as open source under the terms of the [MIT Licence](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:rubocop)
+
+task default: %i[rubocop spec]

data/ccs-frontend_helpers.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'lib/ccs/frontend_helpers/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'ccs-frontend_helpers'
+  spec.version = CCS::FrontendHelpers::VERSION
+  spec.authors = ['tim-s-ccs']
+  spec.email = ['timothy.south@crowncommercial.gov.uk']
+
+  spec.summary = 'Gem containing view helpers for CCS Ruby on Rails projects'
+  spec.description = 'Gem containing view helpers for CCS Ruby on Rails projects'
+  spec.homepage = 'https://github.com/tim-s-ccs/ccs-frontend_helpers'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.7.0'
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'rails', '>= 6.0'
+
+  spec.add_development_dependency 'bundler', '~> 2.3'
+  spec.add_development_dependency 'capybara', '~> 3.38.0'
+  spec.add_development_dependency 'rspec', '~> 3.12'
+  spec.add_development_dependency 'rubocop', '~> 1.36'
+  spec.add_development_dependency 'rubocop-rails', '~> 2.16'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.6'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.13'
+  spec.add_development_dependency 'simplecov', '~> 0.21'
+  spec.add_development_dependency 'yard', '~> 0.9'
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

data/lib/ccs/frontend_helpers/ccs_frontend/dashboard_panels.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'action_view'
+
+require_relative '../shared_methods'
+
+module CCS
+  module FrontendHelpers
+    module CCSFrontend
+      # = CCS Dashboard Panels
+      #
+      # This helper is used for generating the dashboard panels component
+
+      module DashboardPanels
+        include SharedMethods
+        include ActionView::Context
+        include ActionView::Helpers::TagHelper
+        include ActionView::Helpers::TextHelper
+        include ActionView::Helpers::UrlHelper
+
+        # Generates the HTML for the CCS Dashboard Panels component
+        #
+        # @param panel_items [Array] the panel items, see {ccs_dashboard_panels_item}
+        # @param title_text [String] text for the title of a dashboard panels section
+        # @param ccs_dashboard_panels_options [Hash] options that will be used in customising the HTML
+        #
+        # @option ccs_dashboard_panels_options [String] :classes additional CSS classes for the dashboard panels HTML
+        # @option ccs_dashboard_panels_options [String] :width (default: 'full') the width of the dashbaord panel section
+        # @option ccs_dashboard_panels_options [Hash] :attributes additional attributes that will added as part of the HTML
+        #
+        # @return [ActiveSupport::SafeBuffer] the HTML for the CCS Dashboard Panels
+        #                                     which can then be rendered on the page
+
+        def ccs_dashboard_panels(panel_items, title_text = nil, **ccs_dashboard_panels_options)
+          initialise_attributes_and_set_classes(ccs_dashboard_panels_options, 'ccs-dashboard-panels')
+
+          tag.div(**ccs_dashboard_panels_options[:attributes]) do
+            tag.div(class: 'govuk-grid-row') do
+              tag.div(class: "govuk-grid-column-#{ccs_dashboard_panels_options[:width] || 'full'}") do
+                if title_text
+                  concat(tag.h2(title_text, class: 'ccs-dashboard-panels__heading govuk-heading-m'))
+                  concat(tag.hr(class: 'ccs-dashboard-panels__heading-section-break govuk-section-break govuk-section-break--visible'))
+                end
+                concat(tag.div(class: 'ccs-dashboard-panels__container') do
+                  tag.div(class: 'govuk-grid-row') do
+                    panel_items.each { |panel_item| concat(ccs_dashboard_panels_item(panel_item)) }
+                  end
+                end)
+              end
+            end
+          end
+        end
+
+        private
+
+        # Generates the HTML for the a dashboard panel item in {ccs_dashboard_panels}
+        #
+        # @param panel_item [Hash] options for the dashboard panel item
+        #
+        # @option panel_item [String] :title the title for the dashboard panel
+        # @option panel_item [String] :href the href for the dashboard panel
+        # @option panel_item [String] :description the description text for the dashboard panel
+        # @option panel_item [String] :width (default: 'one-third') the width of the dashboard panel item
+        # @option panel_item [Hash] :attributes additional attributes that will added as part of the HTML
+        #
+        # @return [ActiveSupport::SafeBuffer] the HTML for a panel item in {ccs_dashboard_panels}
+
+        def ccs_dashboard_panels_item(panel_item)
+          (panel_item[:attributes] ||= {})[:class] = "ccs-dashboard-panels__item govuk-grid-column-#{panel_item[:width] || 'one-third'}"
+
+          tag.div(**panel_item[:attributes]) do
+            concat(link_to(panel_item[:title], panel_item[:href], class: 'ccs-dashboard-panels__item-title'))
+            concat(tag.p(panel_item[:description], class: 'ccs-dashboard-panels__item-description'))
+          end
+        end
+      end
+    end
+  end
+end