Skip to content

Update @defra/docusaurus-theme-govuk and fix docs homepage#379

Merged
alexluckett merged 1 commit intomainfrom
docs/theme-update
May 1, 2026
Merged

Update @defra/docusaurus-theme-govuk and fix docs homepage#379
alexluckett merged 1 commit intomainfrom
docs/theme-update

Conversation

@alexluckett
Copy link
Copy Markdown
Contributor

Proposed change

  • Convert docs/index.md to MDX with govuk-width-container layout
  • Add feature cards (Configuration driven, Inclusive and accessible, Open source)
  • Add custom CSS for app-section styles, Defra green branding, and masthead hero image
  • Add hero screenshot to static/assets/images
  • Update homepage tagline in docusaurus.config.cjs

New homepage:
image

Jira ticket: none

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Misc. (documentation, build updates, etc)

Checklist

  • You have executed this code locally and it performs as expected.
  • You have added tests to verify your code works.
  • You have added code comments and JSDoc, where appropriate.
  • There is no commented-out code.
  • You have added developer docs in README.md and docs/* (where appropriate, e.g. new features).
  • The tests are passing (npm run test).
  • The linting checks are passing (npm run lint).
  • The code has been formatted (npm run format).

- Pin react-router to ^5.3.4 to prevent @react-foundry/router pulling in v7,
  which broke Docusaurus routing (matchPath argument order incompatibility)
- Convert docs/index.md to MDX with govuk-width-container layout
- Add feature cards (Configuration driven, Inclusive and accessible, Open source)
- Add custom CSS for app-section styles, Defra green branding, and masthead hero image
- Add hero screenshot to static/assets/images
- Update homepage tagline in docusaurus.config.cjs
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented May 1, 2026

@alexluckett alexluckett enabled auto-merge May 1, 2026 14:31
Comment thread package.json
},
"serialize-javascript": ">=7.0.3",
"react-router": "^7.13.1"
"react-router": "^5.3.4"
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.

Why did you downgrade this package?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

compatibility reasons, I couldn't get it working with the latest theme - this seemed to be the one that worked (same for interactive-map repo). I'll try to find out the root cause but given it's just developer docs i didn't care too much.

@alexluckett alexluckett merged commit 70c647d into main May 1, 2026
25 checks passed
@alexluckett alexluckett deleted the docs/theme-update branch May 1, 2026 14:34
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.

2 participants