diff --git a/docs/home/releases/compatibility-v5.md b/docs/home/releases/compatibility-v5.md new file mode 100644 index 000000000..e077e5eaa --- /dev/null +++ b/docs/home/releases/compatibility-v5.md @@ -0,0 +1,52 @@ +--- +title: Compatibility matrix +sidebar_label: Compatibility matrix +description: 'Compatibility matrix for Siemens Industrial Experience Version 5.' +--- + +# Compatibility matrix + +**Status:** Next · **Released:** ~ May 2026 + +## Required packages + +| Package | Version | +| --- | --- | +| `@siemens/ix` | 5.x | +| `@siemens/ix-icons` | ^3.2.0 | + +## Framework wrappers + +| Package | Version | Framework requirement | +| --- | --- | --- | +| `@siemens/ix-react` | 5.x | React ^18 \|\| ^19 | +| `@siemens/ix-angular` | 5.x | Angular >=20 | +| `@siemens/ix-vue` | 5.x | Vue >=3.2.45 | + +## Third-party integrations + +| Package | Version | Library requirement | +| --- | --- | --- | +| `@siemens/ix-aggrid` | 5.x | AG Grid ^33 | +| `@siemens/ix-echarts` | 3.x | ECharts ^5.3.3 | + +## Runtime + +| Requirement | Version | +| --- | --- | +| Node.js | 22.x | +| TypeScript | ~5.4 – ~5.8 | + +## Tested in CI + +We validate these library versions in the monorepo’s test applications using automated CI pipelines. + +| Framework / Library | Tested version | +| --- | --- | +| React | ^19.1.0 | +| Angular | ^20.x | +| Vue | ^3.4.34 | +| Next.js | ^16.1.7 | +| Ionic (React) | ^8.7.4 | +| AG Grid | ^33.1.1 | +| ECharts | ^5.5.1 | diff --git a/docs/home/releases/release-version.md b/docs/home/releases/release-version.md index f1d910162..2165a91f4 100644 --- a/docs/home/releases/release-version.md +++ b/docs/home/releases/release-version.md @@ -51,3 +51,5 @@ We recommend always following the active release. When a version moves from the | V4.0.0 | Maintenance | November 2025 | May 2026 | November 2026 | | V3.0.0 | End of life | May 2025 | November 2025 | May 2026 | | V2.0.0 | End of life | September 2023 | May 2025 | November 2025 | +For detailed framework and dependency requirements per package, see the [compatibility matrix](compatibility-v5.md). +For detailed framework and dependency requirements per package, see the [Compatibility matrix](compatibility-v5.md). \ No newline at end of file diff --git a/sidebars.ts b/sidebars.ts index 3f2669f88..ac728466d 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -96,6 +96,7 @@ const sidebars: SidebarsConfig = { items: [ 'home/releases/roadmap', 'home/releases/release-version', + 'home/releases/compatibility-v5', { type: 'link', href: 'https://github.com/siemens/ix/releases',