Manually upgrading DS2

Step 1 — Download the source file from the DAM

1. Open the design system record in your DAM (Vault or Aprimo).

2. Locate the download option — typically labelled Download Source File or similar.

3. Download the file. It will arrive as a .zip archive.

Step 2 — Unpack the archive locally

Extract the .zip to a location on your machine. This gives you the full shared resource folder structure, including src/, fusion/, assets/, and supporting config files.

Step 3 — Fetch the latest Fusion Library

Download the latest Fusion Library package from: https://cdn.activator.cloud/shared-samples/

The page lists available versions. It is recommended to use the latest version unless you have a specific compatibility requirement. Extract the downloaded archive locally.

Step 4 — Replace the fusion folder

In your unpacked shared resource, delete the existing src/fusion/ folder in its entirety. Copy the src/fusion/ folder from the freshly downloaded Fusion Library into its place.

⚠️ If you have previously made custom changes to files inside the src/fusion/ folder, make a note of those changes before deleting it. The replacement will overwrite them, and you will need to reapply any customisations manually after this step.

Step 5 — Update the version in config.json

Open package.json in a text editor. Locate the version field and update its value to match the version of the Fusion Library you downloaded in Step 3:

"version": "x.x.x"

The correct version number is stated on the Fusion Library download page and in the release notes for the version you fetched.

Step 6 — Rebuild

From the root of the shared resource folder, run:

npm install

Then compile the production build:

npm run prod

Then export the compiled package:

npm run export

This generates a shared.zip inside the exports/ folder. You can optionally pass a name to label the export:

npm run export [name]

Step 7 — Upload the new version to the DAM

In your DAM (Vault or Aprimo), open the existing design system record and upload shared.zip as a new version of the document.

Do not create a new record. Version the existing one so that all documents with a relationship to this shared resource retain that relationship.

Step 8 — Re-import to Activator

Once the new version is live in the DAM, trigger the Open in Activator webhook (pagehook) on the design system record. This pulls the updated shared resource into Activator and makes it available to all related documents.

Verification

After re-import, confirm the upgrade was successful:

1. Open a document in Activator that uses this design system.

2. Check that the design system version displayed matches the version you uploaded.

3. Confirm that components render as expected in the editor.

4. Open the browser developer console and verify there are no errors relating to missing or unresolved Fusion components.

If errors are present, cross-check that fusionVersion in src/config.json matches the folder you replaced in Step 4, and that the build completed without errors in Step 6.