Add a Get started guide and Utilities section to the dummy app#279
Merged
Conversation
Rework the dummy app home page into an orientation guide that maps the site around its own Styles / Components / Utilities sections, shows the bundled GOV.UK and NHS UK Frontend versions, and links to the gem, repository and changelog. Move the live JavaScript demos (Stimulus controllers and time ago) off the home page into a new Utilities section that mirrors the Styles and Components pages. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
timgentry
approved these changes
Jun 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What?
Turns the dummy app home page into a clear "Get started" guide and adds a new Utilities section to the preview site.
The home page now welcomes developers, shows which GOV.UK and NHS UK Frontend versions the gem is built on, links to the gem, repository and changelog, and points to the site's three sections. The live JavaScript demos (Stimulus controllers and time ago) have moved off the home page into the new Utilities section.
Why?
Our users are NHS and GOVUK developers who currently hand-build services in HTML and Bootstrap. The home page used to be a sandbox of loose demos, which did little to help a newcomer understand what the gem offers or how to find it.
The guide speaks to that audience and gets them productive by orienting them around the app itself, using the same Styles / Components / Utilities vocabulary the design systems already use. It also makes the bundled frontend versions and the key links (gem, repo, changelog) easy to find.
How?
pages/index.html.erbas an orientation guide: lead intro, a "What's included" version summary, a "How this site is organised" map of the sections, and a "How to use the examples" note. All built fromds_helpers.frontend_versionhelper that reads the bundled GOV.UK / NHS UK Frontend versions from the gem's stylesheet directory names, so they stay accurate when frontends are updated rather than being hard-coded.Utilitiessection (UtilitiesController, route, index, sidebar) mirroring the existing Styles and Components sections, with the Stimulus controllers and time ago demos rendered through the standardcomponent_preview(ERB input + rendered/HTML output).Utilitiesto the home page sidebar and locale entries for the new preview headings.Testing?
bin/rails test— 318 runs, 0 failures.bin/rubocop— no new offenses introduced by this change.Screenshots?