Release Notes

Stay up to date with the latest Fluid Framework releases, new features, bug fixes, and breaking changes.

Latest Release

v2.1.0 - September 2024

New Major Release

This release includes significant performance improvements and new collaboration features.

🚀 New Features

Enhanced Performance: 40% faster synchronization for large documents
Improved Offline Support: Better conflict resolution when reconnecting
New DDS Types: Experimental SharedTree for hierarchical data
React Hooks: Official React integration with custom hooks
TypeScript 5.0: Full support for latest TypeScript features

🔧 Improvements

Memory Usage: 25% reduction in memory footprint
Bundle Size: Optimized packages reduce bundle size by 15%
Error Handling: Better error messages and recovery mechanisms
Documentation: Comprehensive API documentation updates

🐛 Bug Fixes

Fixed race condition in container initialization
Resolved memory leak in long-running sessions
Corrected event ordering in high-concurrency scenarios
Fixed TypeScript definitions for generic DDS types

⚠️ Breaking Changes

IFluidContainer.services property removed (use container methods directly)
Updated event signatures for consistency across DDSes
Minimum Node.js version now 18.0

📦 Package Updates

# Update to latest versions
npm install @fluidframework/azure-client@^2.1.0
npm install @fluidframework/map@^2.1.0
npm install @fluidframework/sequence@^2.1.0

Previous Releases

v2.0.5 - August 2024

🔧 Improvements

Performance optimizations for SharedString operations
Improved Azure Fluid Relay connection stability
Enhanced debugging tools and logging

🐛 Bug Fixes

Fixed issue with large file attachments
Resolved timing issue in container disposal
Corrected metadata handling in complex scenarios

v2.0.4 - July 2024

🚀 New Features

Experimental Features: SharedTree early preview
Enhanced Telemetry: Better monitoring and diagnostics
Improved Testing: New test utilities for applications

🔧 Improvements

Faster container loading for existing documents
Better error recovery in network partition scenarios
Optimized memory usage for large SharedMaps

v2.0.3 - June 2024

🔧 Improvements

Enhanced cross-platform compatibility
Improved TypeScript definitions
Better performance for mobile devices

🐛 Bug Fixes

Fixed container reconnection edge cases
Resolved event listener memory leaks
Corrected SharedSequence ordering issues

v2.0.2 - May 2024

🔧 Improvements

Optimized network protocols for better performance
Enhanced security measures for production deployments
Improved documentation and examples

🐛 Bug Fixes

Fixed rare corruption issue in SharedString
Resolved timing issues in container creation
Corrected event propagation in nested data structures

v2.0.1 - April 2024

🔧 Improvements

Better error handling for network failures
Improved container lifecycle management
Enhanced logging and debugging capabilities

🐛 Bug Fixes

Fixed memory leak in event handling
Resolved issue with large operation sequences
Corrected metadata parsing edge cases

v2.0.0 - March 2024

Major Version

This major release includes breaking changes. See the migration guide for upgrade instructions.

🚀 Major Changes

New Architecture: Simplified container API
Improved Performance: Complete rewrite of synchronization engine
Enhanced Security: End-to-end encryption support
Modern Tooling: ESM support and improved bundling

⚠️ Breaking Changes

Container creation API simplified
Event signatures updated for consistency
Removed deprecated methods and properties
Updated TypeScript requirements (4.5+)

📖 Migration Guide

See our v2.0 Migration Guide for detailed upgrade instructions.

Release Schedule

Fluid Framework follows semantic versioning and has a regular release schedule:

Release Types

Major Releases: Every 6-12 months, may include breaking changes
Minor Releases: Every 1-2 months, new features and improvements
Patch Releases: As needed for critical bug fixes

Support Policy

Current Version: Full support with regular updates
Previous Major: Security updates for 12 months
Older Versions: Community support only

Beta and Preview Features

We regularly release beta and preview features for early feedback:

Currently in Beta

SharedTree: Advanced hierarchical data structure
Enhanced Presence: Rich user awareness features
Fluid Relay Edge: Global edge deployment

Experimental Features

Real-time Voice/Video: WebRTC integration
Advanced Permissions: Fine-grained access control
Fluid Sync: Cross-platform native synchronization

Upgrade Instructions

Automatic Updates

For patch releases, you can safely update automatically:

npm update @fluidframework/azure-client
npm update @fluidframework/map
npm update @fluidframework/sequence

Manual Updates

For major and minor releases, review the changelog and test thoroughly:

# Check current versions
npm list @fluidframework/azure-client

# Update to specific version
npm install @fluidframework/azure-client@2.1.0

# Update all Fluid packages
npm update @fluidframework/*

Testing Your Upgrade

Review Breaking Changes: Check the changelog for any breaking changes
Update Dependencies: Install new versions
Run Tests: Ensure your test suite passes
Test Collaboration: Verify multi-user scenarios work correctly
Performance Testing: Check for any performance regressions

Feedback and Bug Reports

Reporting Issues

Found a bug? Here's how to report it:

Check Existing Issues: Search GitHub Issues
Create Detailed Report: Include reproduction steps and environment details
Provide Code Sample: Minimal example that demonstrates the issue
Include Version Info: Specify exact package versions used

Feature Requests

Have an idea for a new feature?

Discuss on GitHub: Start a discussion in our repository
Join Community Calls: Monthly community calls for feedback
RFC Process: For major features, submit an RFC

Release Notes Archive

Security Updates

Security is a top priority. We provide security updates for:

Current Major Version: Immediate fixes
Previous Major Version: Security patches for 12 months
Critical Vulnerabilities: Backported to supported versions

Subscribe to our security advisories to stay informed about security updates.

Deprecation Policy

When deprecating features:

Deprecation Notice: Marked in documentation and code
Migration Path: Clear upgrade instructions provided
Transition Period: Minimum 6 months before removal
Community Support: Help with migration questions

Stay connected with the Fluid Framework community to get the latest updates and participate in shaping the future of collaborative applications!