Strapi Release: 3.0.0-alpha.14.1

TL;DR

Strapi v3.0.0-alpha.14.1 is a maintenance release that brings significant improvements to the framework and plugins. It introduces support for MongoDB SRV URIs, adds the ability to specify upload file directories and MIME types, and enhances the developer experience with automatic browser opening on startup. This release also includes numerous bug fixes for content management, file handling, and authentication, along with documentation improvements and UI enhancements. The update focuses on stability, usability, and developer experience.

Highlight of the Release

• Added support for MongoDB SRV URIs
• Added ability to specify upload-file field's directory and MIME type
• Automatic browser opening when starting Strapi in development mode
• Added basic global proxy support
• Fixed numerous file upload and validation issues
• Fixed content type generation with Bookshelf
• Improved auto-reload functionality
• Enhanced error handling with ability to emit errors to Koa

Migration Guide

No breaking changes were introduced in this release, so migration from v3.0.0-alpha.14 to v3.0.0-alpha.14.1 should be straightforward.

To upgrade:

1. Update your Strapi dependencies in your package.json:

{
  "dependencies": {
    "strapi": "3.0.0-alpha.14.1",
    "strapi-admin": "3.0.0-alpha.14.1",
    "strapi-utils": "3.0.0-alpha.14.1",
    "strapi-plugin-content-manager": "3.0.0-alpha.14.1",
    "strapi-plugin-content-type-builder": "3.0.0-alpha.14.1",
    "strapi-plugin-users-permissions": "3.0.0-alpha.14.1",
    "strapi-plugin-email": "3.0.0-alpha.14.1",
    "strapi-plugin-upload": "3.0.0-alpha.14.1",
    "strapi-plugin-settings-manager": "3.0.0-alpha.14.1"
  }
}

2. Run npm install or yarn install to update the dependencies.

3. Restart your Strapi server.

If you're using MongoDB with SRV URIs, you can now update your database configuration to use the SRV format.

Upgrade Recommendations

This release contains important bug fixes and enhancements that improve stability and user experience. We recommend all users upgrade to v3.0.0-alpha.14.1, especially if you are experiencing any of the following issues:

• Problems with file uploads or validation
• Issues with content type generation using Bookshelf
• Auto-reload functionality not working correctly
• Date format issues in the content manager
• Authentication problems with email providers

The upgrade process is straightforward with no breaking changes, making it a low-risk update that provides significant improvements.

Bug Fixes

Framework Fixes

• Fixed build issues that were causing problems with application deployment
• Fixed auto-reload functionality on file changes, ensuring changes are properly detected and applied
• Fixed relation handling in the database layer
• Improved handling of subchildren processes in test scripts for better test reliability
• Fixed issues with MongoDB SRV URI parsing

Plugin Fixes

• Fixed date format issues in the content manager
• Fixed unique email validation with authentication providers
• Fixed image preview reset functionality - now properly clears label and icon previews
• Fixed content type generation with Bookshelf ORM
• Fixed layout issues when deleting content types
• Fixed file upload issues:
  • Resolved problems with repeated file attachments
  • Fixed required file validation
  • Fixed issues when removing all files and adding new ones
  • Added proper handling for canceled file selections
• Fixed auto-reload functionality in plugins
• Fixed enumeration field validation for attribute names
• Added proper checks for user existence before blocking users

New Features

MongoDB SRV URI Support

Strapi now supports MongoDB SRV URIs, allowing for more flexible and secure MongoDB connections. This feature enables developers to use MongoDB Atlas and other MongoDB services that provide connection strings in the SRV format.

Upload File Directory and MIME Type Specification

You can now specify the directory and MIME type for upload file fields, giving you more control over how and where files are stored in your application.

Automatic Browser Opening

When starting Strapi in development mode, the admin panel will automatically open in your default browser, streamlining the development workflow.

Global Proxy Support

Added basic global proxy support, allowing Strapi to work behind corporate proxies or in environments where direct internet access is restricted.

Error Emission to Koa

Developers can now emit errors to Koa, providing better error handling capabilities and more control over how errors are processed and displayed.

Security Updates

Authentication Improvements

• Fixed unique email validation with providers, preventing potential account takeover issues
• Implemented email lowercase conversion on local authentication registration to prevent duplicate accounts with different case variations
• Added proper checks for user existence before blocking users, preventing potential denial of service

Proxy Configuration Security

The new global proxy support includes proper configuration options in the Settings Manager, allowing for secure proxy usage while maintaining application integrity.

Performance Improvements

Auto-reload Improvements

The auto-reload functionality has been significantly improved, ensuring faster and more reliable reloading when files are changed. This enhances development speed and reduces waiting time between changes.

File Handling Optimization

Several optimizations have been made to file handling processes, including:

• More efficient file validation
• Improved file upload and deletion workflows
• Better handling of file input clearing after events

Process Management

Enhanced handling of subchildren processes in test scripts, which improves test execution performance and reliability. The system now properly kills children and sub-children processes simultaneously from the main test process.

Impact Summary

Strapi v3.0.0-alpha.14.1 is a maintenance release that focuses on stability, usability improvements, and developer experience enhancements. The addition of MongoDB SRV URI support expands database connectivity options, while the ability to specify upload file directories and MIME types gives administrators more control over file management.

The automatic browser opening feature streamlines the development workflow, and the numerous bug fixes address issues across file handling, content management, and authentication. Global proxy support improves deployment flexibility in corporate environments.

This release represents Strapi's commitment to quality and user experience, with significant contributions from the community addressing real-world usage scenarios. The improvements to error handling, validation, and UI components make this a worthwhile update for all Strapi users, regardless of project size or complexity.

Full Release Notes