Skip to content

Add custom branding#2223

Open
SamJamCul wants to merge 15 commits into
mainfrom
add-custom-branding
Open

Add custom branding#2223
SamJamCul wants to merge 15 commits into
mainfrom
add-custom-branding

Conversation

@SamJamCul

Copy link
Copy Markdown
Contributor

What problem does this pull request solve?

Trello card:

Things to consider when reviewing

  • Ensure that you consider the wider context.
  • Does it work when run on your machine?
  • Is it clear what the code is doing?
  • Do the commit messages explain why the changes were made?
  • Are there all the unit tests needed?
  • Do the end to end tests need updating before these changes will pass?
  • Has all relevant documentation been updated?

@SamJamCul
SamJamCul force-pushed the add-custom-branding branch 4 times, most recently from ee8d41f to 8e82014 Compare July 20, 2026 11:45
@SamJamCul
SamJamCul marked this pull request as ready for review July 24, 2026 09:34
SamJamCul and others added 15 commits July 24, 2026 10:34
Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
This should make styling easier - we won't have to add individual classes to the HTML of each component we style.
Adds a new component to contain the `<style>` tag and custom CSS for the custom branding feature in one place.
Major email clients have trouble with data URIs (Gmail doesn't support them at all, Outlook seems to render them inconsistently). If we want to include custom branding in emails, we'll need to include URLs to existing files.

For now the brand assets can live in the public folder. Later we can figure out how to store them in a way that makes self-service in forms-admin possible.
Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
When a form uses custom branding, show the branded accessibility
statement link in the footer.

Co-authored-by: David Biddle <david.biddle@digital.cabinet-office.gov.uk>
@SamJamCul
SamJamCul force-pushed the add-custom-branding branch from 8e82014 to 6c2577d Compare July 24, 2026 09:34
@github-actions

Copy link
Copy Markdown
Contributor

🎉 A review copy of this PR has been deployed! It is made of up two components

  1. A review copy of forms-runner
  2. A production copy of forms-admin

It may take 5 minutes or so for the application to be fully deployed and working. If it still isn't ready
after 5 minutes, there may be something wrong with the ECS task. You will need to go to the integration AWS account
to debug, or otherwise ask an infrastructure person.

For the sign in details and more information, see the review apps wiki page.

@theseanything theseanything left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is fine to go in now (considering it won't affect our user's at the moment) - it will allow us to iterate on it.

Comment thread config/locales/cy.yml

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Obviously these need to be translated into welsh - but can happen in a separate PR. Worth making a TODO

Comment thread config/branding.yml
organisation_name: "South Gloucestershire Council"
organisation_url: "https://www.southglos.gov.uk"
logo: /brand_assets/south-gloucestershire/logo.png
favicon: /brand_assets/south-gloucestershire/favicon.png

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: No opengraph for south Gloucestershire. Something to fix later.

Comment thread config/branding.yml
@@ -0,0 +1,15 @@
cheshire-east:
background_colour: "white"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we use hex values for all colours (as they will be easier to validate, when injecting dynamic css values)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants