Strapi Release: 3.0.0-alpha.12.7

TL;DR

Strapi v3.0.0-alpha.12.7 brings significant enhancements including Yarn support, search functionality in generated APIs, and multiple language additions (Korean, Portuguese, Brazilian Portuguese). Performance improvements include better SQL table creation/update and MongoDB connection optimizations. Several relationship bugs were fixed, particularly for oneWay relations, and the UI received improvements for image previews. The release also includes better logging and temporary file handling.

Highlight of the Release

• Added Yarn support for Strapi projects
• Implemented search functionality in generated APIs
• Added support for Korean, Portuguese, and Brazilian Portuguese languages
• Improved SQL table creation/update performance
• Fixed oneWay relationship issues
• Enhanced MongoDB connection options
• Improved image preview in the content manager

Migration Guide

No major migration steps are required for this release. However, users should be aware of the following changes:

1. MongoDB Connection Options: If you're using MongoDB with a connection URI, the connection options in your configuration will now be properly merged with URI parameters.

2. Temporary Files: The system now uses OS-random paths for temporary files instead of a hardcoded "tmp" directory. This should be transparent to most users but might affect those who had custom scripts or processes that relied on the specific location of temporary files.

3. Yarn Support: If you want to use Yarn instead of npm, you can now do so without any special configuration. The system will detect and use Yarn if it's available.

Upgrade Recommendations

This alpha release (v3.0.0-alpha.12.7) includes several important bug fixes and performance improvements, particularly for relationship handling and database operations. If you're already using the alpha version of Strapi 3.0.0, upgrading is recommended to benefit from these fixes and enhancements.

For production environments, we generally recommend waiting for stable releases. However, if you're specifically affected by any of the fixed issues (especially oneWay relationship problems or MongoDB connection issues), upgrading may resolve those problems.

The upgrade process should be straightforward:

1. Update your Strapi dependencies to the latest version
2. Restart your Strapi application

No database migrations or configuration changes are required for this update.

Bug Fixes

Relationship Fixes

• Fixed issues with oneWay relationships where relations would be lost when updating content types
• Resolved problems with manyToMany relationships related to data refetching before attaching new entries
• Fixed oneToMany relationship handling

UI and Display Fixes

• Fixed image preview functionality in the InputFile component
• Resolved display issues with oneWay relations

MongoDB Connection Fixes

• Fixed handling of MongoDB connection options when using URI strings
• Added "useNewUrlParser" option to Mongoose connection to address deprecation warnings

File System Fixes

• Changed hardcoded "tmp" path to an OS-random one in the temporary directory, fixing potential permission and security issues (fixes #1463)

Documentation Fixes

• Fixed incorrect import reference for utils/request
• Fixed filename references in documentation

New Features

Search in Generated APIs

Added search functionality to generated APIs, allowing for easier data filtering and querying capabilities directly from the API endpoints.

Yarn Support

Strapi now fully supports Yarn as an alternative package manager to npm. This includes project creation, dependency management, and all related workflows.

Language Support Expansion

Added support for multiple new languages in the admin panel:

• Korean language support
• Portuguese language support
• Brazilian Portuguese language support

The language selector in the admin panel has also been updated to be scrollable, accommodating the growing list of supported languages.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

SQL Performance Enhancements

Improved SQL table creation and update performance, which significantly speeds up operations when working with SQL databases. Added options to disable auto table/column creation for more control over database schema changes.

Build and Development Improvements

• Implemented caching of dependencies for faster builds and tests
• Split tests by packages for more efficient test runs
• Improved performance when finding global Strapi installations

MongoDB Optimizations

Enhanced MongoDB connection handling with better URI parsing and connection options management.

Impact Summary

This release significantly improves Strapi's developer experience and internationalization capabilities. The addition of Yarn support provides developers with more flexibility in their workflow, while the search functionality in generated APIs enhances the platform's data querying capabilities without requiring custom code.

Performance improvements to SQL operations will benefit projects with large databases or frequent schema changes. The fixes to relationship handling address some of the most common pain points reported by users, particularly with oneWay relationships.

The expansion of language support (Korean, Portuguese, and Brazilian Portuguese) continues Strapi's commitment to internationalization, making the platform more accessible to global users.

For system administrators, the improved handling of temporary files and MongoDB connections provides more robust and secure operations, especially in containerized or multi-user environments.

Overall, this release represents an incremental but important step in Strapi's development, focusing on stability, performance, and user experience improvements rather than introducing major architectural changes.

Full Release Notes