Strapi Release: 5.12.4

TL;DR

Strapi v5.12.4 brings several important improvements to the CMS platform. This release focuses on enhancing the relation input modal with a complete refactoring, fixing form reset issues when publishing content, adding tooltips for icons, and updating dependencies including Sharp and Axios. The update also addresses multiple unit test issues to improve stability and reliability of the testing suite.

Highlight of the Release

• Complete refactoring of the relation input modal for better user experience
• Fixed form reset when publishing content
• Added tooltips for icons to improve UI clarity
• Updated Sharp to v0.33.5 for better image processing
• Fixed Axios version to address potential vulnerabilities

Migration Guide

No specific migration steps are required for this release. This is a patch release (5.12.3 to 5.12.4) that focuses on bug fixes and enhancements without introducing breaking changes.

Simply update your Strapi version to 5.12.4 using your package manager:

npm install [email protected]
# or
yarn upgrade [email protected]

Upgrade Recommendations

This is a recommended upgrade for all Strapi users, especially those who:

1. Work extensively with relation fields and have experienced issues with the relation input modal
2. Have encountered problems with form resets when publishing content
3. Want to benefit from the latest dependency updates including Sharp v0.33.5 and fixed Axios version

As this is a patch release (5.12.4), it should be safe to upgrade without breaking changes to your existing Strapi implementation.

Bug Fixes

Form and Publishing Fixes

• Fixed form reset when publishing content
• Disabled publish button when publishing a relation change to prevent duplicate submissions
• Fixed issues with review workflow showing roles

Unit Test Stability

• Fixed multiple flaky unit tests
• Improved test implementation for AssigneeSelect
• Updated test practices to use best practices for element retrieval
• Added additional assertions for more robust testing

Dependency Fixes

• Updated Axios version to address potential vulnerabilities
• Fixed Sharp to v0.33.5 for improved image processing
• Fixed issues with the Tooltip component

New Features

Relation Input Modal Refactoring

The relation input modal has been completely refactored to improve the user experience and code maintainability. Key improvements include:

• Removed the side editor future flag
• Introduced a new reducer for better state management
• Added a new useNewDocumentContext hook
• Moved the expand button and removed the footer for a cleaner interface
• Fixed issues with nested forms within the modal
• Improved handling of unsaved changes
• Better handling of relation modifications in the modal

UI Enhancements

• Added tooltips for icons to improve clarity and usability
• Updated Strapi Design System to v2.0.0-rc.21

Security Updates

No specific security fixes were mentioned in the release notes. However, the update to Axios and other dependencies may include security patches as part of their regular maintenance.

Performance Improvements

Relation Modal Performance

The refactored relation input modal should provide better performance when working with relations, especially when dealing with nested relations or multiple relation modifications.

Dependency Updates

• Updated Vite version for improved build performance
• Updated markdown-it from 12.3.2 to 13.0.2
• Updated Sharp to v0.33.5 which may provide performance improvements for image processing

Impact Summary

Strapi v5.12.4 delivers important improvements to the content editing experience, particularly around relation management. The complete refactoring of the relation input modal addresses several pain points in the previous implementation, making it more intuitive and reliable.

Content editors will benefit from a smoother publishing workflow with fixed form reset issues and improved relation handling. The addition of tooltips for icons enhances the UI clarity, making the platform more accessible to new users.

For developers, the update brings several dependency updates including Sharp v0.33.5, fixed Axios version, and updated markdown-it. These updates ensure better compatibility and security. The numerous fixes to unit tests also improve the stability of the testing suite, which is valuable for those extending or customizing Strapi.

While this is a patch release without breaking changes, the improvements to relation handling and content publishing workflows make it a worthwhile upgrade for most Strapi installations.

Full Release Notes