Strapi Release: 3.1.1

TL;DR

Strapi v3.1.1 is a maintenance release that fixes several bugs in the framework and plugins while adding some enhancements. Key improvements include fixing webhook RegExp to allow underscores, resolving upload API issues, improving users-permissions confirmation links, upgrading apollo-server-koa, and setting up GitHub Dependabot for better dependency management.

Highlight of the Release

• Fixed webhook RegExp to allow underscores in URLs (resolving issue #5543)
• Fixed upload API functionality for more reliable file handling
• Improved users-permissions plugin with better confirmation links
• Added GitHub Dependabot for automated dependency management
• Upgraded apollo-server-koa for better GraphQL performance

Migration Guide

No complex migration is required for this release. This is a patch release (v3.1.0 → v3.1.1) focused on bug fixes and minor enhancements.

To upgrade:

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

Or if using Yarn:

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

If you're using GraphQL, make sure to also update:

yarn upgrade [email protected]

Upgrade Recommendations

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

• Use webhooks with underscores in URLs
• Rely on the upload API functionality
• Use the users-permissions plugin for authentication
• Use GraphQL with apollo-server-koa

The release contains important bug fixes and enhancements that improve stability and functionality. Since this is a patch release (3.1.0 → 3.1.1), the upgrade should be straightforward with minimal risk of breaking changes.

Bug Fixes

• Webhook RegExp Fix: Updated webhook RegExp to properly allow underscores in URLs (#7079), resolving issue #5543
• Upload API Fix: Resolved issues with the upload API functionality (#7136)
• Users-Permissions Improvements:
  • Added localhost in confirmation links when server URL is not set
  • Updated documentation for better clarity
  • (#7054)
• Missing Telemetry Event: Fixed a missing event in the telemetry system (#7146)

New Features

This release doesn't introduce major new features but does include enhancements:

• GitHub Dependabot Integration: Added official GitHub Dependabot setup to automate dependency updates and security patches.
• Apollo Server Upgrade: Updated apollo-server-koa to improve GraphQL performance and stability.

Security Updates

No specific security fixes were mentioned in this release. However, the upgrade of apollo-server-koa and the addition of GitHub Dependabot will help maintain better security practices by keeping dependencies updated with the latest security patches.

Performance Improvements

• GraphQL Performance: Upgraded apollo-server-koa package (#7087), which brings performance improvements to GraphQL API responses and query handling.
• Dependency Management: Added GitHub Dependabot integration (#7103) to keep dependencies up-to-date automatically, which helps maintain optimal performance and security.

Impact Summary

Strapi v3.1.1 is a maintenance release that addresses several important bugs and adds useful enhancements to improve the overall stability and developer experience.

The webhook RegExp fix resolves a longstanding issue (#5543) that prevented using underscores in webhook URLs, which is particularly important for developers integrating with external services. The upload API fix improves reliability for a core functionality that many Strapi applications depend on.

For user management, the users-permissions plugin now handles confirmation links better when server URL is not configured, defaulting to localhost, which improves the development experience.

The addition of GitHub Dependabot represents a step forward in maintaining project dependencies, while the apollo-server-koa upgrade enhances GraphQL performance.

Overall, this release focuses on stability and quality-of-life improvements rather than introducing new features, making it a recommended upgrade for all Strapi v3.1.0 users.

Full Release Notes