Strapi Release: 3.1.2

TL;DR

Strapi v3.1.2 is a maintenance release that includes numerous bug fixes and enhancements. Key improvements include fixes for database operations, admin routes, file uploads, and content management validations. The release also features documentation updates, UI improvements, and several developer experience enhancements.

Highlight of the Release

• Fixed database operations including count with sort parameter and core_store initialization
• Resolved conflicts between admin routes and user controllers
• Fixed Input Number component and date/datetime validation issues
• Improved file upload error messages and fixed invalid local uploads path
• Added Japanese translation to media library
• Updated documentation with improved docker-compose examples

Migration Guide

This is a patch release (v3.1.1 → v3.1.2) with no breaking changes. You can upgrade safely by following these steps:

1. Update your package.json dependencies:

   npm install [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]
   

   Or with yarn:

   yarn upgrade [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]
   

2. If you're using the GraphQL plugin and have customized Apollo server configuration, be aware that this release adds engine configuration to Apollo server parameters.

3. If you're using the mailgun provider, note that the documentation has been updated to specify the required domain parameter.

4. If you're using docker-compose, you may want to review the updated examples in the documentation for improved configurations.

Upgrade Recommendations

This is a recommended upgrade for all Strapi v3.1.x users as it contains important bug fixes and enhancements that improve stability and user experience.

Priority: Medium

The update addresses several critical issues:

• Database operation fixes
• Admin route conflicts
• Content validation problems
• File upload path issues

Users experiencing any of these specific issues should prioritize this update. The upgrade process is straightforward with no breaking changes, making it a safe update for production environments.

Bug Fixes

Core Framework

• Fixed count with sort parameter in database operations
• Fixed core_store initialization order
• Fixed admin routes and user controllers conflicts
• Fixed server accessibility during bootstrap

Admin Panel

• Fixed issue #7139 related to UI rendering
• Fixed pluginsSectionLinks in plugin generator
• Fixed Input Number component issues by reverting biginteger back to text input

Content Management

• Fixed date and datetime required validations
• Fixed timestamp-related issues (#7189)

File Upload

• Fixed invalid local uploads path
• Improved error messages for file uploads by adding examples

Users & Permissions

• Fixed custom populate state by moving it to its own service to avoid population issues
• Removed unnecessary console.log from users-permissions API

New Features

• Added CheatSheet link in the admin panel for easier reference
• Added Japanese translation to the media library
• Added engine configuration to Apollo server parameters for GraphQL plugin
• Updated documentation with improved docker-compose examples for SQLite, PostgreSQL, and MongoDB

Security Updates

• Updated lodash dependency from 4.17.15 to 4.17.19 to address security vulnerabilities
• Bumped pluralize from 7.0.0 to 8.0.0

Performance Improvements

• Improved server startup by fixing accessibility issues during bootstrap
• Enhanced database operations with fixes for core_store initialization
• Optimized GraphQL performance by adding engine configuration to Apollo server parameters

Impact Summary

Strapi v3.1.2 is a maintenance release that focuses on bug fixes and quality-of-life improvements across the platform. The update addresses several important issues in the core framework, admin panel, and plugins.

Key improvements include fixes for database operations, admin route conflicts, and content validation. The release also enhances the developer experience with better error messages, documentation updates, and UI improvements.

For content managers, the fixes to date/datetime validations and the Input Number component will improve the content editing experience. Administrators will benefit from the added CheatSheet link and improved plugin generation.

The update to dependencies like lodash addresses security vulnerabilities, making this an important update for security-conscious users. Overall, this release improves stability and user experience without introducing breaking changes, making it a recommended update for all Strapi v3.1.x users.

Full Release Notes