alfresco-content-app/docs/upgrade-guide/upgrade741-750.md

Title

Title
Upgrading from ACA v7.4.1 to v7.5.0

Upgrading from ACA v7.4.1 to v7.5.0

This guide provides instructions on how to upgrade your Alfresco Content Application (ACA) v7.4.1 project to v7.5.0.

This is a minor release on the Angular 19 / ADF 8 line: it moves ADF 8.4.1 → 8.5.0 and @alfresco/js-api 9.4.1 → 9.5.0. Angular (19.2), Node (.nvmrc 24.13.0), TypeScript, zone.js and NgRx are all unchanged. The headline is the Material Design 3 (MD3) migration — the biggest source of visual change in this release — plus a new Link document capability and multivalued-property support in folder rules. The corresponding ADF guide is:

• ADF — Upgrading from v8.4.1 to v8.5.0

Because of the MD3 migration, budget time to re-audit any custom theme or Material style overrides. Read the breaking changes.

Before you begin

Always perform upgrades on a "clean" project state, back up your changes or make a project backup. The Angular 19 / TypeScript 5.8 platform and Node 24 (.nvmrc) are unchanged from 7.4.1. Budget time to re-theme (MD3) and re-test.

Contents

• Library updates
• Aligning with ADF 8.5
• Breaking changes
  • Material Design 3 (MD3) migration
  • minimatch-browser dependency removed
  • Library public API
• New components and features
• Behavioural changes

Library updates

Update the package.json file with the latest library versions:

{
    "dependencies": {
        "@alfresco/adf-core": "8.5.0",
        "@alfresco/adf-content-services": "8.5.0",
        "@alfresco/adf-extensions": "8.5.0",
        "@alfresco/js-api": "9.5.0"
    }
}

@alfresco/adf-cli and @alfresco/eslint-plugin-eslint-angular move to 8.5.0 too, and mermaid moves 11.12 → 11.15. The minimatch-browser runtime dependency was removed. Angular (19.2.20), @angular/material (19.2), TypeScript (5.8.2), @ngrx/* (19.2.1), zone.js (0.15.0) and Node (.nvmrc 24.13.0) are unchanged. Clean node_modules and the lockfile, then reinstall.

Aligning with ADF 8.5

See the ADF 8.4.1 → 8.5.0 guide for the underlying library changes. Beyond adopting ADF 8.5.0 / js-api 9.5.0, the ADF-aligned work in ACA is the Material Design 3 theming migration below.

Breaking changes

Material Design 3 (MD3) migration

ACA (and ADW / ACC) migrated their theming to Angular Material 3 (MD3) — ACS-10449. This reworked the theme across roughly 70 files: theme.scss, custom-theme.scss, variables.scss, the ADF override partials (adf-style-fixes.theme.scss, adf-variables.scss, adf-pagination.theme.scss, …), new mixins.scss / mat-selectors.scss, and many component SCSS files. MD3 changes Material's design tokens, component styling and CSS custom properties.

If your fork defines a custom theme or overrides Material component styles, you must re-audit them against MD3. This is the largest source of visual breakage in this upgrade.

minimatch-browser dependency removed

The minimatch-browser runtime dependency was removed from package.json. If your fork imported it transitively through ACA, add it to your own dependencies.

Library public API

The published API is additive — @alfresco/aca-content now exports the NodeActionsService (ACS-9765), which also gained copy/move/link support (see New components and features). No exports were removed or renamed.

Non-change (informational): a change to how sharable links handle redirects to the login page (ACS-11861) was merged and then reverted before 7.5.0, so that behaviour is unchanged. No action is needed — this is only noted in case you diff the intermediate commits.

New components and features

• Link document (MNT-25522) — you can now create a link to a document in another location. This adds a new node store action and extends the now-public NodeActionsService; linked nodes display N/A for size and number of files in the Information dialog.
• NodeActionsService (@alfresco/aca-content) — the copy / move / link service is now part of the public API (copyNodes(), moveNodes(), and the new link action), so extensions can drive those actions directly.
• Folder rules — multivalued properties (MNT-25149 / MNT-25558) — folder-rule property conditions and actions now support multivalued properties.

Behavioural changes

Area	Change
Accessibility	Focus is handled correctly after collapsing the sidenav menu (ACS-11350), and the info-drawer tabs show a proper focus indicator during keyboard navigation (ACS-11980).
Styling	General style updates accompanied the MD3 migration (ACS-11158).
Info dialog	Links display N/A for size and number of files (MNT-25522).