Version Support and Release Policy - SAP/fundamental-ngx GitHub Wiki

This document outlines the version support policy, release cycles, and compatibility matrix for fundamental-ngx with Angular and UI5 Web Components.

TL;DR

• ✅ One LTS version per Angular major version - receives critical fixes (security & regressions)
• 🚀 Monthly releases aligned with UI5 Web Components (first week of each month)
• 🔒 LTS = Bug fixes only | Active Support = New features + fixes
• ⏰ Support ends when Angular version reaches End of Life
• 📞 Need help? File issues on GitHub

• Support Policy
• Bugs vs. Features: What Gets Fixed in LTS
• Release Cycle
• Current Version Matrix
• Documentation Versions
• Legend
• Migration Recommendations
• Additional Information

fundamental-ngx supports multiple Angular major versions by maintaining multiple fundamental-ngx minor versions. Each version is aligned with specific Angular releases and UI5 Web Components versions.

Versions under active support receive:

• ✨ New features and components
• 🔧 Bug fixes and improvements
• 🔒 Security vulnerability patches
• 📈 Performance enhancements
• 📚 Documentation updates

One version per Angular major version receives LTS with critical fixes only:

• 🔒 Security vulnerability patches
• 🐛 Regression fixes
• ♿ Accessibility fixes (critical issues affecting WCAG compliance)

LTS Policy: The latest fundamental-ngx version for each major Angular version that is in Angular's LTS mode will receive LTS support.

Versions that have reached End of Life:

• ❌ No longer receive any updates or fixes
• 📦 Remain available on npm for legacy projects
• ⚠️ Not recommended for new projects
• 🔴 Includes versions supporting Angular major versions that are no longer in Angular's active support or LTS

EOL Criteria:

• When the corresponding Angular major version reaches End of Life
• When a version is superseded by a newer LTS version for the same Angular major
• When critical dependencies are no longer maintained

Type	Definition	Example
Security Issue	Vulnerability that could be exploited	XSS in input component
Regression	Previously working functionality now broken	Dialog stopped opening after update
Critical Bug	Severe issue blocking core functionality	Component crashes, data loss
Accessibility (Critical)	WCAG compliance issue preventing usage	Screen reader cannot access critical functionality

Type	Definition	Example
Feature	New functionality or API	New property, method, or event
Enhancement	Improvement to existing functionality	Performance optimization, better UX
New Component	Component that didn't exist before	New Carousel component
Non-Critical Bug	Minor issues with workarounds	Visual inconsistency, edge case
Accessibility (Minor)	Non-blocking accessibility improvements	Design improvement

Bug = Existing functionality doesn't work as documented

• ✅ Button click doesn't fire → Bug
• ❌ Button needs a new "size" property → Feature

Regression = Previously working functionality broke after an update

• ✅ Table sorting worked in v0.56.0, fails in v0.56.1 → Regression
• ❌ Table needs faster rendering → Enhancement

Enhancement = Making something better, not fixing something broken

• ❌ Improving table performance by 20% → Enhancement
• ✅ Table crashes with large datasets → Bug

💡 To get features, enhancements, or new components, upgrade to the latest actively supported version.

fundamental-ngx follows the UI5 Web Components release schedule:

• 📅 UI5 Web Components typically releases in the first week of each month
• 🚀 fundamental-ngx releases shortly after each UI5 Web Components release
• 🔄 This ensures compatibility with the latest UI5 Web Components features and fixes
• 🎯 Angular major version support is added as new Angular versions are released

1. UI5 Web Components releases (first week of month)
2. fundamental-ngx updates dependencies and tests compatibility
3. fundamental-ngx releases new version (typically within few days)

For the latest UI5 Web Components release schedule, see the UI5 Web Components Release Information.

fundamental-ngx	Angular Version	UI5 Web Components	Support Status
0.62.0 🚧	21	TBD	🟢 PLANNED (MIDDLE OF MARCH)
0.61.0 🎉	21	2.20.x	🟢 ACTIVE
0.60.x	21	2.19.x	⚫ Superseded by 0.61.x
0.59.x	21	2.18.x	⚫ Superseded by 0.61.x
0.58.x 📍🎉	20	2.18.x	🟡 LTS (Last Angular 20 release)
0.57.x	20	N.A.	⚫ Superseded by 0.58.x
0.56.x 📍🎉	19.2	N.A.	🟡 LTS (Last Angular 19 release)
0.55.3	19.2	N.A.	⚫ Superseded by 0.56.x
0.55.y	19	N.A.	⚫ Superseded by 0.56.x

Older Versions (Limited or No Support)

fundamental-ngx	Angular Version	Support Status
0.54.y	18	🔴 End of Life (Last Angular 18 release)
0.53.y	18	⚫ Superseded by 0.54.y
0.52.y	18	⚫ Superseded by 0.54.y
0.51.y	18	⚫ Superseded by 0.54.y
0.50.y	17	🔴 End of Life (Last Angular 17 release)
0.49.y	17	⚫ Superseded
0.48.y	17	⚫ Superseded
0.47.y	16.2	🔴 End of Life (Last Angular 16 release)
0.46.y	16.2	⚫ Superseded
0.45.y	16.1	⚫ Superseded
0.44.y	16.1	⚫ Superseded
0.43.y	15	🔴 End of Life (Last Angular 15 release)
0.42.y	15	⚫ Superseded
0.41.y	15	⚫ Superseded
0.40.y	15	⚫ Superseded
0.39.y	15	⚫ Superseded
0.38.y	15	⚫ Superseded
0.37.y	14	⚫ Superseded
0.36.y	14	⚫ Superseded
0.35.y	13	⚫ Superseded
0.34.y	13	⚫ Superseded
0.33.y	13	⚫ Superseded
0.32.y	11	⚫ Superseded
0.31.y	11	⚫ Superseded
0.30.y	11	⚫ Superseded
0.29.y	11	⚫ Superseded
0.28.y	10	⚫ Superseded
0.27.y	10	⚫ Superseded
0.26.y	10	⚫ Superseded
0.25.y	10	⚫ Superseded
0.24.y	10	⚫ Superseded
0.23.y	10	⚫ Superseded
0.22.y	10	⚫ Superseded
0.21.y	10	⚫ Superseded
0.20.y	9	⚫ Superseded
0.19.y	9	⚫ Superseded
0.18.y	9	⚫ Superseded
0.17.y	9	⚫ Superseded
0.16.y	9	⚫ Superseded
0.15.y	8	⚫ Superseded
0.14.y	8	⚫ Superseded
0.13.y	8	⚫ Superseded
0.12.y	8 (IVY)	⚫ Superseded
0.11.x	7	⚫ Superseded
0.10.1	7	⚫ Superseded
0.10.0 (as fundamental-ngx)	7	⚫ Superseded

We maintain documentation for multiple versions of fundamental-ngx to support teams working with different Angular versions.

📚 Multiple API documentation versions are available on our documentation site.

To switch between documentation versions:

1. Visit the fundamental-ngx documentation
2. Look for the version selector in the shellbar (top navigation bar) on the right side
3. Select your desired version from the dropdown menu

• 🎉 Released - Available on npm
• 🚧 Planned - Scheduled for upcoming release

• 📍 Last release for that Angular major version (LTS candidate)
• 📌 Final release before major breaking changes

• 🟢 Active Support - Full feature development and all fixes
• 🟡 LTS - Critical fixes only (security & regressions) - One version per Angular major
• 🔴 End of Life - No support provided
• ⚫ Superseded - Replaced by LTS version for that Angular major

⚠️ Angular 20 and 19 (LTS): These versions are in LTS mode and receive only critical fixes. Please plan migration to Angular 21 or later for active support.

🚫 Angular 18 and lower: These versions are no longer supported. Please migrate your application to the latest Angular version.

1. Check your current Angular version - Run ng version in your project
2. Review the compatibility matrix - Find the appropriate fundamental-ngx version
3. Check the documentation - Switch to your target version's documentation using the version selector
4. Update Angular first - Follow Angular Update Guide
5. Update fundamental-ngx - Update to the corresponding version
6. Review breaking changes - Check the release notes for any breaking changes
7. Test thoroughly - Verify all components work as expected

• Angular Version Support: Angular Release Schedule
• UI5 Web Components: Release Information
• fundamental-ngx Releases: GitHub Releases
• Documentation: fundamental-ngx Docs
• Migration Guides: Available in the documentation for each version

• Version 0.12.* was compiled with Angular 8 with IVY enabled and can be used by applications running Angular 8 or higher
• For questions or issues, please visit our GitHub Issues
• Join our community discussions on GitHub Discussions