1.9.0

What's new since 1.8.2

• Issue #3475110 by joshua1234511, richardgaunt, sime, granticusiv: Illegal access to constants in shipshape on govcms @joshua-salsadigital (#1314)
• Issue #3486893, #3478484, #3483064, #3415662, by joshua1234511, richardgaunt, fionamorrison23, febdao, gargsuchi, sonam.chaturvedi, mwjansen, alex.skrypnyk: Add opt-in for controlling what form elements are rendered via civictheme system. @richardgaunt (#1306)
• [#380] Added navigation name to support aria-label for <nav> element @febdao (#1315)
• Fixed multiple checkboxes mistakenly marked as required if a Field is marked as required. @AlexSkrypnyk (#1312)
• Issue #3415664 by sime, joshua1234511, richardgaunt, alexskrypnyk, fionamorrison23: Contextual links are broken @joshua-salsadigital (#1311)
• Added page level styles into Drupal theme. @alan-cole (#1308)
• Issue #3476600: Adding a layout setting for controlling space around the layout. @alan-cole (#1305)
• Issue #3476889 - Fixed useEffect only running on load due to blank deps. @alan-cole (#1309)
• Added tbachert/spi to allow-plugins. @joshua-salsadigital (#1310)
• Issue #3460512 by joshua1234511, richardgaunt, fionamorrison23, alexskrypnyk, alancole: Added ellipsis to truncated card summary. @joshua-salsadigital (#1307)

Full Changelog: 1.8.2...1.9.0

@AlexSkrypnyk, @alan-cole, @febdao, @joshua-salsadigital and @richardgaunt

1.8.2

What's new since 1.8.1

• Upgrade to uikit 1.8.2
• Updated tag of uikit for testing. @richardgaunt (#1302)
• Updated composer to Drupal 10.3. @richardgaunt (#1301)
• Issue #3469582 by joshua1234511: Alert content type - Page visibility validation issue. @joshua-salsadigital (#1294)
• Issue #3468224 by joshua1234511, richardgaunt, gargsuchi: Unknown view mode used in paragraph.civictheme_subject_card_ref.default.yml @joshua-salsadigital (#1298)
• Issue #3471518 by joshua1234511, richardgaunt, toby-wild: civictheme_media_get_variables not returning correct "created" value @joshua-salsadigital (#1297)
• Fix for Lagoon CLI 3.0. @richardgaunt (#1296)
• Fixed menu links items processing when the URL is rendered. @AlexSkrypnyk (#1293)
• Issue #3464362 by joshua1234511: Mega menu broken for authenticated users @joshua-salsadigital (#1290)

Full Changelog: 1.8.1...1.9.0

@AlexSkrypnyk, @joshua-salsadigital and @richardgaunt

1.8.1

What's new since 1.8.0

• Issue #3458260 by alex.skrypnyk, joshua1234511: Missing update hooks in 1.8 @joshua-salsadigital (#1286)
• Update README to point to docs for theme install. @kepol (#1288)
• Fixed hooks for Automated list to allow alteration within consumer sites. @AlexSkrypnyk (#1287)

Full Changelog: 1.8.0...1.8.1

@AlexSkrypnyk, @joshua-salsadigital and @kepol

1.8.0

What's new since 1.7.1

This release includes the upgrade to UIKit 1.8, the addition of a 3-column layout, update to form elements, and the implementation of the Focal Point module.
The theme is now compatible with Drupal 11.

New Features

• Updated to the UIKit 1.8. @AlexSkrypnyk @joshua-salsadigital (#1246)(#1283)(#1275)
• Issue #3455319 by alex.skrypnyk: Add 3 column layout. @AlexSkrypnyk @joshua-salsadigital (#1242)(#1271)(#1277)
• Issue #3415665 by joshua1234511: Utilize Focal Point module @joshua-salsadigital (#1242)
• Issue #3457992 by alex.skrypnyk: Allow excluding provision types in civictheme_provision_cli(). @AlexSkrypnyk (#1281)

Fixes

• Issue #3454548 by alex.skrypnyk, abhishek_gupta1, ivrh, thisisalistairsaccount: Automated list from Banner bottom components throws error. @AlexSkrypnyk (#1284)
• Issue #3457993 by alex.skrypnyk: Provisioning script does not re-use existing block UUIDs'. @AlexSkrypnyk (#1282)
• Issue #3444381 by RichardGaunt, alex.skrypnyk: civictheme_get_field_value helper function does not process some common core field types. @AlexSkrypnyk (#1255)
• Updated deps. @AlexSkrypnyk (#1251)
• Issue #3441713 by RichardGaunt: Layout error when another theme renders a node. @richardgaunt (#1243)
• Issue #3441209 by joshua1234511, sonnykt: Theme content provisioning creates invalid config views.view.civictheme_media @joshua-salsadigital (#1241)
• Fixed Active tab to be marked as such in Drupal. (#1253)
• Fixed schema config errors. @AlexSkrypnyk (#1246)
• Fixed rendering of view elements to use centralised rendering utlity. @AlexSkrypnyk (#1246)
• Added styles on the Layout Builder admin page. @joshua-salsadigital (#1256)
• Issue #3456933 by alex.skrypnyk: SVG icons do not load due to being SVG icons do not load due to being processed through image style. @AlexSkrypnyk (#1273)

Chores

• Updated Drupal 10.3 deprecations. @AlexSkrypnyk (#1254)
• Updated container images, core and GovCMS versions. @AlexSkrypnyk (#1245)
• Fixed coding standards. @AlexSkrypnyk (#1244)
• Updated Devtools to Drupal Extension Scaffold 1.9 @AlexSkrypnyk (#1279)
• Updated content profiles and fixed image styles. @AlexSkrypnyk (#1274)

---

🚨 Update notes:

Follow the update process described at https://docs.civictheme.io/update

For this release, regenerate the sub-theme manually from the starter kit and integrate your overrides into the new theme.

Full Changelog: 1.7.1...1.8.0

@AlexSkrypnyk, @joshua-salsadigital, @richardgaunt and Joshua Fernandes

1.7.1

What's new since 1.7.0

• Issue #3440088 by joshua1234511: Error when trying to mix CT 1.7 colours @joshua-salsadigital (#1239)
• Issue #3421274 by joshua1234511, trrroy, mohd-sahzad: TypeError: Argument #3 ($file_system) must be of type Drupal\Core\File\FileSystem, Drupal\s3fs\S3fsFileService given @joshua-salsadigital (#1240)
• Issue #3432526 by joshua1234511: Promo component does not have padding when used with a sidebar. @joshua-salsadigital (#1238)

Full Changelog: 1.7.0...1.7.1

@AlexSkrypnyk and @joshua-salsadigital

1.7.0

What's new since 1.6.2

New home for UI Kit

Starting from this release, the UI Kit is managed independently in its own repository. All UI Kit issues are now tracked there.

The inclusion method of the UIKit in the Drupal theme has changed: package.json is used to specify the version or commit of the UIKit. The update ensures only necessary UI Kit files are committed.

Issues moved to Drupal.org

Drupal theme issue management has transitioned to Drupal.org, with commits syncing to the default branch on Drupal.org each time code is merged into the develop branch on GitHub. This integration maintains commit history and the credit system while supporting robust CI pipelines for various Drupal implementations.

While we will try to keep the versioning of the Figma and UIKit to be aligned with the CMS-specific implementations, like this Drupal theme, those implementation versions could deviate in their versions.

New Features

• 🚨 BC: Updated the UI Kit source mechanism to align with best front-end practices. @AlexSkrypnyk (#1191, #1197, #1198, #1233)
• Issue #3415754 by joshua1234511: Added publishing workflow. @joshua-salsadigital (#1210)
• Issue #3415656 by joshua1234511: Media name used instead of file name in Attachment component. @joshua-salsadigital (#1230)
• Issue #3415685 by joshua1234511: Added hidden region for entity references in civictheme.info.yml. @joshua-salsadigital (#1229)
• Issue #3415737 by joshua1234511: Added Media tags vocabulary provision. @joshua-salsadigital (#1206)

Fixes

• 🚨 BC: Issue #3415738 by joshua1234511, alex.skrypnyk: Decommissioned the 'Quote' standalone component. @joshua-salsadigital (#1221)
• Issue #3415687 by joshua1234511, alex.skrypnyk: Fixed URLs converted to links in WYSIWYG do not get CivicTheme's classes added @joshua-salsadigital (#1225)
• Issue #3415742 by joshua1234511: Fixed Nodes within an Automated list should not reference itself. @joshua-salsadigital (#1219)
• Issue #3414639 by joshua1234511, alex.skrypnyk: Fixed banner shows page titles as "Access Denied" due to a block cache. @joshua-salsadigital (#1218)
• Issue #3422805 by joshua1234511: Updated conditional check for navigation to support updated Navigation component in UIKit. @joshua-salsadigital (#1234, #1237)
• Issue #3415751 by joshua1234511: Fixed Duplicated checkboxes to show dependent colours on sub-theme settings. @joshua-salsadigital (#1214)
• Issue #3415660 by govind.maloo: Fixed arrows supporting Previous and Next buttons on webforms are not rendering as expected @govindmaloo (#1182)
• Issue #3415747 by joshua1234511: Search for Component title / summary field is not working @joshua-salsadigital (#1207)
• Issue #3427321 by joshua1234511: Missing directory "05-pages" @joshua-salsadigital (#1227)
• Issue #3414203 by joshua1234511: Fixed Eslint failing in Starterkit "lint" script if there are no JS files in components. @joshua-salsadigital (#1205)
• Issue #3414202 by alex.skrypnyk, joshua1234511: Fixed search page does not look as per design @joshua-salsadigital (#1189)

Other

• Fixed coding standards and strict typing and updated dependencies. @AlexSkrypnyk (#1199, #1202, #1204, #1213, #1236)
• Created Storybook link in the secondary navigation and updated redirect. @joshua-salsadigital (#1228)
• Updated configs in industry content profiles. @joshua-salsadigital (#1235)
• Remove component override examples from the demo sites. @joshua-salsadigital (#1220)
• Updated testing Docs to use 'ahoy provision'. @joshua-salsadigital (#1222)
• Updated Composer deps. @AlexSkrypnyk, @govindmaloo (#1211, #1212)
• Fixed footer menu column title missing on the Demo site. @joshua-salsadigital (#1209)
• Updated monorepo site to run on PHP 8.1 and 8.2. @AlexSkrypnyk (#1195, #1201)
• Disabled assertion for the intermittently failing schema update test. @AlexSkrypnyk (#1200)
• Added buildiung for legacy Drupal version in CI. @AlexSkrypnyk (#1196)
• Updated devtools and code after code quality checks. @AlexSkrypnyk (#1192)

---

🚨 Update notes:

Follow the update process described at https://docs.civictheme.io/update

For this release, regenerate the sub-theme manually from the starter kit and integrate your overrides into the new theme.

The "Quote" paragraph will be automatically removed after updates — ensure to re-export your site configuration.

Full Changelog: 1.6.2...1.7.0

@AlexSkrypnyk, @govindmaloo, @joshua-salsadigital, and Joshua Fernandes

1.6.2

🧩 UI Kit

New features

None

Fixes

• Fixed UI Kit version in package.json.
• Fixed Group filter rendering incorrectly on mobile. Filters now will stack vertically.
• Added slots prop for Group Filter Storybook story.
• Fixed Item Grid calculating columns classes incorrectly for when the number of items is greater than the number of columns.
• Removed incorrect, CMS-only Editor content component. This functionality is implementation-specific and is now handled in CMS.
• [CIVIC-1244] Added a11y fixes for mobile menu. (#1149)

💧 Drupal theme

New features

• Issue #3409009 by alex.skrypnyk: Add summary settings for Snippet component. This allows to set the number of characters for the Snippet's component Sunmary field.
• [CIVIC-1295] Added content components support for CKEditor. (#1156) 🚨 See update notes below.

Fixes

• Fixed double inclusion of assets during compilation. This was resulting if CSS styles applying in the incorrect order. 🚨 See update notes below.
• Fixed Navigation card override example.
• Removed CKEditor4 as a require dependency.
• Updated CivicTheme dependencies versions to use the latest ones.
• Added optional limit for the update helper. This allows to re-use the update helper with a set limit to avoid running of all updates in "lower" environments.
• Issue #3404794 by Toby Wild, alex.skrypnyk: Documentation suggestions
• [CIVIC-1521] Fixed issue #1147: catch InvalidArgumentException in civictheme_url_is_external() (#1167)
• [CIVIC-1449] Fixed Automated list filters not being hidden when selected in UI. (#1157)

Other

• Updated copyright year in the example demo content.
• Updated demo generated content list to use Snippet component.
• Updated containers to 23.12.0.
• Updated Drush 12 and Search API 1.31

---

🚨 Update notes:

Follow the update process described at https://docs.civictheme.io/update

Additionally, if using a sub-theme:

1. Copy file civictheme_starter_kit/assets/sass/theme.editor.scss to <yourtheme>/assets/sass/theme.editor.scss.
2. Remove <yourtheme>/assets/sass/editor directory.
3. Remove @import 'editor'; line from <yourtheme>/assets/sass/theme.scss.
4. Replace in your sub-theme info file:

ckeditor_stylesheets:
  - dist/styles.editor.css

with

ckeditor5-stylesheets:
  - dist/styles.editor.css
  - dist/styles.variables.css

5. Copy file (overwrite) civictheme_starter_kit/webpack/editor_css.js to webpack/editor_css.js.
6. Copy file (overwrite) civictheme_starter_kit/webpack/assets.js to webpack/assets.js.
7. npm run build
8. drush cr

---

Full Changelog: 1.6.1...1.6.2

Drupal 10.1, GovCMS 3 and strict typing

This release is primarily focused on compatibility with Drupal 10.1, GovCMS 3 and strict typing.

🧩 UI Kit

New features

• Added icons for instagram, message, x, youtube. @BrianGilbert @AlexSkrypnyk (#1144)

Fixes

• Fixed TOC header tag. @AlexSkrypnyk (#1143)
• Fixed Twig coding standards. @AlexSkrypnyk (#1136)
• Added Playwright as a dev dependency for UI kit. @AlexSkrypnyk (#1121)

💧 Drupal theme

New features

• Added strict types. @AlexSkrypnyk (#1137)
• Added support for Drupal 10.1. @AlexSkrypnyk (#1122)
• Updated copatibility with GovCMS 3. @AlexSkrypnyk (#1130)

Fixes

• Issue #3398934 by amjad1233, alex.skrypnyk: Undefined array key error when specifying path in CivicTheme subtheme creation script. @amjad1233 @AlexSkrypnyk (#1139)
• Fixed conflicting config for content_moderation. @AlexSkrypnyk (#1129)
• Fixed CKEditor 5 Paragraphs overal in Claro. @joshua-salsadigital (#1131)
• Fixed error when the logo type is not defined. @AlexSkrypnyk (#1127)
• Fixed site slogan in theme settings to be not required. @AlexSkrypnyk (#1125)
• Fixed re-generating colour CSS file still uses the old dummy query string, which causes browsers to serve cached version of the asset. @barbun

🧨 Breaking changes:

This release introduces PHP strict typing.

This means that you will have to update your custom PHP code if you were using any of the CivicTheme functions. The updates only required for function arguments and return types.

Other

• Fixed Linkit tests and enabled more skipped tests. @AlexSkrypnyk (#1123)
• Removed D9 from theme CI and switched branches from master to main. @AlexSkrypnyk (#1134)
• Update DrevOps to the latest version. @AlexSkrypnyk (#1133)
• Updated dependencies. @AlexSkrypnyk (#1126)
• Simplified CI jobs. @AlexSkrypnyk (#1124)

---

Full Changelog: 1.5.3...1.6.0

Search, automated updates, fixes

This release was primarily focused on addressing technical debt and enhancing the stability of the development platform.

We have also created a new documentation site https://docs.civictheme.io/.

🧩 UI Kit

New features

• Updated NodeJS version requirement to 18. Make sure to use nvm use to switch to the correct version when working on the theme.
• Added Snippet component.

Fixes

• Fixed desktop primary navigation sub-menu items receive focus while visually hidden when tabbing through page links. (a11y)
• Fixed List component's Storybook props not using random values.
• Fixed Slider slide image position not being applied when it should appear right from the slide content.
• Removed outdated whitespace/storybook-addon-html plugin from Storybook configuration. Consumer sites should do the same.

💧 Drupal theme

New features

• Added SVG support for Logos. 🚀
• Added new Snippet and Snippet reference paragraph components.
• Added support for database search based on Search API. The results are displayed using Snippet component.
• Added and ability for a user with Site Administrator role to update site slogan without having access to Basic site settings configuration page.
• Added automated configuration schema and content updates system and updates for schema changes in previous CivicTheme versions. 🚀🚀🚀
• Added tests for install with the following matrix (runs on every change in CI):
  • Drupal 9 and Drupal 10
  • fresh or previous versions
  • minimal and govcms profiles
  • with and without sub-theme

Fixes

• Updated dependencies to be contained and fixed the namespace. 🚀
• Fixed non-expanded menu item becomes expanded when active.
• Fixed form element showing error on empty value.

🧨 Breaking changes:

Starting from this version, CivicTheme provides automated content updates for any schema changes.
This means that when the new version of CivicTheme is deployed, the content will be automatically updated to match the new schema.

Note that you must run this locally first to ensure that the update is successful.

• Renamed Banner Blend mode field for nodes and blocks (an automated update is provided):
  • field_c_n_blend_mode -> field_c_n_banner_blend_mode
  • field_c_b_blend_mode -> field_c_b_banner_blend_mode

Other

• Added GH action to send newly opened issues and comments to JIRA. This allows to keep the project truly open-source while still using JIRA for internal project management.
• Moved to direct publishing from this monorepo to all repositories on every change to develop branch.
  Previously, only publishing on release. This allows to use development versions in code.
• Enabled config linting in CI.
  This makes sure that all configuration shipped with the Drupal theme is consistent with the required dependencies.
• Added support for building with and without optional Drupal modules (like Search API) that CivicTheme provides optional configuration for, but not depends on.
• Added example composer.json for Drupal 10 consumer sites to use as a scaffold.
• Removed in-code docs after they being moved to external docs site https://docs.civictheme.io/

A11y and link extraction fixes

• Fixed [DEFECT] A11y: Invalid extra double quotes on side navigation aria-expanded attribute (#1047)
• Fixed [DEFECT] Email links not converting correctly (#963)
• Added [FEATURE] Opt-out system for features (currently includes only links and emails in links) which makes it possible to disable CivicTheme's features from UI without code changes. (#1054)