Strapi Release: 3.0.0-beta.6

TL;DR

Strapi v3.0.0-beta.6 brings important bug fixes and enhancements to improve stability and user experience. This release addresses several critical issues in the framework and plugins, including fixes for configuration loading, query handling, and crash prevention. Notable improvements include the ability to configure Mailgun API hosts, better documentation, and enhanced CLI support. This update is recommended for all beta users to ensure a more stable development experience.

Highlight of the Release

• Fixed environment configuration loading to allow different environment names
• Added support for configuring Mailgun API host (EU or default)
• Fixed critical crash in users-permissions plugin when connecting to marketplace
• Improved bootstrap.js loading to support global modules like dotenv
• Enhanced documentation with better examples and fixed typos

Migration Guide

No breaking changes were introduced in this release that would require migration steps. This is primarily a bug fix and enhancement release that maintains compatibility with previous beta versions.

If you're using the Mailgun plugin and wish to use the EU endpoint, you can now configure it according to the updated documentation.

Upgrade Recommendations

It is highly recommended to upgrade to v3.0.0-beta.6, especially if you:

• Use different environment names in your configuration
• Rely on global modules like dotenv that need to be loaded early
• Use the users-permissions plugin and connect to the marketplace
• Perform delete operations with strapi.query.delete
• Use the documentation plugin
• Use the Mailgun plugin and need to specify an EU endpoint

The upgrade process should be straightforward as this release focuses on bug fixes and enhancements without introducing breaking changes. Simply update your dependencies to the latest version:

npm install [email protected] --save

Or if using Yarn:

yarn upgrade [email protected]

Bug Fixes

Framework Fixes

• Environment Configuration: Fixed an issue that prevented using different environment names when loading configurations (#3459)
• Bootstrap Loading: Resolved a problem by requiring bootstrap.js before config loading, enabling the use of global modules like dotenv (#3453)
• Query Deletion: Fixed a bug in strapi.query.delete that was passing invalid properties to Bookshelf (#3438)

Plugin Fixes

• Users-Permissions: Fixed a critical crash that occurred when connecting to the marketplace (#3469)
• Documentation Plugin:
  • Fixed documentation settings loading issues (#3443)
  • Resolved an issue where documentation files were not being created correctly by ensuring only keys from settings.json are used (#3460)
• File Upload: Fixed curl request example for file uploads that was causing errors with the actual file parameter (#3439)

New Features

Mailgun API Host Configuration

Users can now configure which Mailgun API endpoint to use. Previously, only the default endpoint (api.mailgun.net) was available, but now users can also specify the EU endpoint (api.eu.mailgun.net) as needed for compliance with EU data regulations. This enhancement provides more flexibility for users who need to ensure their email services operate within specific geographic regions.

Security Updates

No specific security fixes were included in this release. However, the stability improvements, particularly the fix for the users-permissions plugin crash, help prevent potential denial of service scenarios that could occur when connecting to the marketplace.

Performance Improvements

Query Handling Improvements

The fix to strapi.query.delete passing invalid properties to Bookshelf not only resolves a bug but also improves performance by preventing unnecessary processing of invalid data. This change ensures that database operations are more efficient and reduces potential overhead in delete operations.

Configuration Loading Optimization

The improvements to environment configuration loading and bootstrap.js handling contribute to a more efficient startup process, particularly for applications that use environment-specific configurations or global modules like dotenv.

Impact Summary

Strapi v3.0.0-beta.6 is a stability-focused release that addresses several important bugs and adds useful enhancements. The most significant impacts include:

1. Improved Stability: Critical fixes for the users-permissions plugin prevent crashes when connecting to the marketplace, and fixes to query deletion ensure proper database operations.

2. Enhanced Configuration: Support for different environment names and proper bootstrap.js loading improves flexibility for development workflows, especially for teams using environment-specific setups.

3. Better Documentation: Multiple documentation improvements make it easier for new users to get started and for existing users to properly implement features like file uploads.

4. Mailgun Enhancement: The ability to configure Mailgun API hosts provides important flexibility for users who need to comply with EU data regulations.

Overall, this release significantly improves the developer experience while using Strapi beta by addressing pain points and adding quality-of-life improvements without introducing breaking changes.

Full Release Notes