Strapi Release: 4.10.2

TL;DR

Strapi v4.10.2 brings significant enhancements to the Review Workflow feature with color customization and stage reordering capabilities. The release also includes Git initialization for new projects, improved helper-plugin organization, and various bug fixes. An experimental automatic TypeScript type generation feature has been added for development mode. This update focuses on improving user experience and developer workflow with better visual management of content stages and more robust error handling.

Highlight of the Release

• Enhanced Review Workflow with customizable stage colors and drag-and-drop reordering
• Automatic Git initialization when creating new Strapi projects
• Experimental automatic TypeScript type generation for development mode
• Improved helper-plugin code organization for better developer experience
• Fixed SSO cookie domain configuration path

Migration Guide

No specific migration steps are required for this release. This is a minor update that should be compatible with existing Strapi v4.10.x installations.

If you're using the SSO feature and have configured a custom cookie domain, you may need to check your configuration to ensure it's using the correct path after the fix for the SSO domain configuration.

For the experimental TypeScript type generation feature, you can enable it by adding the following to your ./config/admin.js file:

module.exports = ({ env }) => ({
  // other config
  typescript: {
    // Enable the experimental automatic type generation feature
    autogenerate: true
  }
});

Note that this feature is marked as experimental and may change in future releases.

Upgrade Recommendations

This release contains valuable enhancements to the Review Workflow feature and several bug fixes that improve the overall stability and user experience of Strapi.

Recommendation: All users should upgrade to v4.10.2, especially if you:

• Use the Review Workflow feature and would benefit from color customization and reordering
• Need better SSO cookie domain configuration
• Are creating new projects and want automatic Git initialization
• Are using TypeScript and would benefit from the experimental automatic type generation

The upgrade should be straightforward with minimal risk as this is a minor release with no breaking changes. Follow the standard Strapi update procedure to upgrade from v4.10.1.

Bug Fixes

Configuration Fixes

• Fixed typo in configuration path for SSO domain, ensuring proper SSO cookie domain configuration
• Fixed issue where field named "conditions" was breaking role checkboxes

UI and Functionality Fixes

• Fixed AutoReload context value that had incorrect names for object properties
• Improved error handling when assets backup folder cannot be created
• Fixed issue where schema builder couldn't set collection names
• Renamed build directory to build-command so it doesn't get ignored by build tools

TypeScript and Testing

• Fixed generator tests by upgrading to TypeScript V5
• Fixed flaky tests in review workflows
• Removed unnecessary logs from tests

New Features

Review Workflow Enhancements

• Stage Colors: Added the ability to customize colors for workflow stages, making it easier to visually distinguish between different stages
• Stage Reordering: Implemented drag-and-drop functionality to reorder workflow stages
• Color Display: Added color indicators in both the list view and edit view sidebar for better visual workflow management
• Stage Name Handling: Improved display of stage names with proper truncation for long names

Git Initialization

• New Strapi projects now automatically initialize with Git, saving developers a manual step

TypeScript Improvements

• Experimental Automatic Type Generation: Added capability to automatically generate TypeScript types in development mode
• Migrated generators to TypeScript
• Converted admin-test-utils to TypeScript

Helper Plugin Reorganization

• Refactored helper-plugin code into features for better organization and maintainability
• Split DragLayer out of the Content Manager to make it available across the application

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Dependency Optimization

• Replaced the uuid package with native crypto.randomUUID() for better performance and reduced dependencies
• Updated several dependencies to their latest versions, including:
  • core-js from 3.28.0 to 3.30.1
  • react-intl from 6.3.2 to 6.4.1
  • better-sqlite3 from 8.0.1 to 8.3.0
  • ws from 8.11.0 to 8.13.0
  • jest-cli from 29.0.3 to 29.5.0

Impact Summary

Strapi v4.10.2 significantly enhances the Review Workflow feature with color customization and stage reordering capabilities, making content workflow management more intuitive and visually organized. Content managers will benefit from improved visual cues in both list and edit views, while administrators gain more control over workflow configuration.

Developers will appreciate the automatic Git initialization for new projects, experimental TypeScript type generation, and improved code organization in the helper-plugin. The release also addresses several bugs, including a fix for the SSO cookie domain configuration path and issues with the schema builder.

This update focuses on improving user experience and developer workflow without introducing breaking changes, making it a recommended upgrade for all Strapi users, particularly those utilizing the Review Workflow feature or working with TypeScript.

Full Release Notes