Fusion Framework — The React 19 Release 🚀

[odinr]

Fusion Framework — The React 19 Release 🚀

This is the big one. The one where React 17 gets a tasteful retirement party, React 19 moves in, and routing in Fusion finally has one opinionated story instead of three competing ones. Also: your auth flow got smarter, the CLI grew some muscle, and lodash got shown the door.

Let's break it down.

---

🎯 The Headlines

React 19 is here (#3820)

The entire framework now targets React 19 with a minimum floor of React 18. React 17 is officially unsupported — if you're still there, it's time to move. No clever workaround, sorry 🙃.

What this means in practice:

• All @equinor/fusion-framework-react-* packages require react ^18.0.0 || ^19.0.0
• Internal rendering uses createRoot — the old ReactDOM.render path is gone
• renderApp / renderComponent are no longer deprecated; they now use createRoot under the hood, so you can delete some boilerplate and pretend it was always this clean ✨
• EDS packages and fusion-react-styles are updated to React 19-compatible releases (Material-UI v4 dependencies removed)
• Vitest upgraded to v4 across the board

Migration: Bump to React 18+ (or ideally 19), update all @equinor/fusion-framework-* dependencies, and test. Existing React 18 code should Just Work™.

---

Fusion React Router — a real routing story (#3765, part of #3820)

New package: @equinor/fusion-framework-react-router

Fusion finally has a first-class, Fusion-aware routing DSL built on React Router v7 — instead of the previous "three ways to maybe do routing" situation. The DSL is small, composable, and typed:

import { Router } from '@equinor/fusion-framework-react-router';
import { layout, index, route, prefix } from '@equinor/fusion-framework-react-router/routes';

export const pages = layout(import.meta.resolve('./MainLayout.tsx'), [
  index(import.meta.resolve('./HomePage.tsx')),
  prefix('products', [
    index(import.meta.resolve('./ProductsPage.tsx')),
    route(':id', import.meta.resolve('./ProductPage.tsx')),
  ]),
]);

export default function AppRouter() {
  return <Router routes={pages} />;
}

Key bits:

• Fusion context injection — fusion.modules and fusion.context are automatically available in loaders, actions, and components. No more prop-threading your HTTP client through seven layers of React context.
• Route schemas — toRouteSchema generates manifest-compatible route metadata from your route definitions. Single source of truth from code to docs to app manifest.
• Backward compatible — plain RouteObject[] arrays still work. Migrate incrementally.
• Vite plugin — optional static analysis and optimized route tree generation via @react-router/dev.
• NavigationProvider.createRouter() is deprecated — it still works but emits telemetry warnings. New work should use the DSL.
• Navigation module refactored: navigator → history, new events (NavigateEvent, NavigatedEvent).

Migration: New apps should start with the DSL from day one. Existing apps can keep using RouteObject[] and migrate incrementally. Updated cookbooks (app-react-charts, app-react-people, app-react-bookmark-advanced) show the recommended patterns.

---

🔐 Auth / MSAL

MSAL got a handful of genuinely useful improvements beyond the v4 upgrade that shipped in #3727:

• Backend-issued auth code exchange (#4000) — eliminates the double-login problem for SPAs. If your backend hands out an auth code, the MSAL module can now consume it directly.
• Configurable login hint (#4049) — set a default login hint on the configurator for silent SSO, no per-call boilerplate needed.
• Reset authCode (#4141) — MsalConfigurator now lets you clear a previously set auth code.
• Hardened token defaults (#4067) — safer fallback behavior when requesting tokens.

---

📊 Analytics

• BatchLogProcessor replaces SimpleLogProcessor (#4103) — less noise, better batching.
• trackFeature now accepts optional data (#3849) — pass additional key-value context with analytics events.
• appKey on context-change events (#4119) ⚠️ breaking — ContextSelectedCollector now correlates context changes with the active app.
• ConsoleAnalyticsAdapter (#3900) — enable fusionLogAnalytics feature flag in dev-portal to see analytics events in your browser console. Handy for debugging.
• Zod schema compliance (#4149) — extractContextMetadata now plays nicely with the Zod context schema.

---

💾 CLI

The CLI had a genuinely productive few months:

• Snapshot versions (#3953) — app pack --snapshot and app publish --snapshot generate timestamped preview versions without touching source. Great for PR previews.
• Artifact-based validation (#3974) — app publish can now validate from built bundles, no source code required. Build once, deploy many.
• --config for publish (#3990) — point to a specific config file when publishing.
• app serve command — serve built apps with the dev-portal locally.
• Custom tags (#3978, #3923) — tag apps/portals with arbitrary strings in build schema and manifests.
• Raw imports — ?raw imports for markdown files work out of the box in CLI builds.
• Node.js 24 LTS recommended (#3899).
• Portal manifest annotation fixes (#4160, #4167).

---

📦 Other Notable Stuff

• AG Grid v35 + AG Charts v13 (#4062) — AG Charts extracted into standalone @equinor/fusion-framework-react-ag-charts. Theme shim added for mixed v34/v35 scenarios (#4087).
• AI Module (#3757) — POC for Azure OpenAI integration with embeddings and a plugin-based CLI architecture. Still early, but it's in the box.
• Service discovery overrides (#3961, #3995, #4105) — override endpoint keys per environment, with session-based overrides for non-browser contexts.
• People module — updated PersonController with new suggest/resolve methods (#4095).
• Lodash removed (#3963) — lodash.mergewith and lodash.clonedeep replaced with native alternatives. One fewer supply-chain worry.
• AG Grid license key in dev-portal (#3922).

---

⚠️ Breaking Changes at a Glance

What	Why	Migration
React 17 dropped	React 19 is the target; 18+ is the floor	Upgrade to React 18 or 19
react-router-dom v5 patterns removed	Unified on React Router v7	Use @equinor/fusion-framework-react-router or react-router v7
navigation.navigator deprecated	Replaced by navigation.history	Swap to .history
NavigationProvider.createRouter() deprecated	Replaced by router DSL	Use <Router> from @equinor/fusion-framework-react-router
Module-event mutation removed (#3994)	Simplified event model	Remove originalDetail / updateDetails / allowEventDetailsMutation usage
Analytics ContextSelectedCollector (#4119)	Now includes appKey	Constructor requires appProvider argument

---

📚 Docs & Cookbooks

All 18 cookbook READMEs were rewritten with real code examples and inline explanations. Several cookbooks migrated to the new router DSL as reference implementations. New styling cookbook demonstrates React 19-compatible fusion-react-styles without Material-UI. VuePress docs gained a dedicated React Router module page.

---

🔗 Key Links

• React 19 PR (#3820)
• Router DSL PR (#3765)
• React 19 Pre-Release Discussion
• MSAL v4 Release Discussion

---

🤖 Beep Bopp – Release notes assembled by Fusion Assistant. Chuck Norris could have upgraded to React 19 without a build step, but he chose to let us mortals do it properly.