Strapi Release: 3.0.0-alpha.14.4.0

TL;DR

Strapi v3.0.0-alpha.14.4.0 brings significant improvements to the documentation system with a migration to VuePress, enhances the admin interface with better authentication flows and multilingual support, and fixes numerous bugs across the framework and plugins. Key highlights include fixes for relation handling, GraphQL JSON types, AWS S3 file deletion, and SSO functionality. The release also includes extensive translation updates for multiple languages and improvements to the developer experience.

Highlight of the Release

• Migration to VuePress for documentation system
• Split Admin entry point between production and development environments
• Fixed deep delete relation for oneWay relations
• Added delete button in Edit view for content management
• Fixed JSON attribute types in GraphQL
• Improved SSO functionality across different environments
• Added and updated translations for multiple languages

Migration Guide

No specific migration guide is needed for this alpha release. This is an incremental update (v3.0.0-alpha.14.3 to v3.0.0-alpha.14.4.0) with bug fixes and enhancements that don't require special migration steps.

If you're using GraphQL with JSON attribute types, the fix in this release will now properly handle these types, so you may want to review any workarounds you might have implemented previously.

For developers using PostgreSQL, the addition of IF NOT EXISTS parameter for creating indexes will prevent errors when indexes already exist, which might affect your database initialization scripts if you were handling this case manually.

Upgrade Recommendations

This release contains important bug fixes and enhancements that improve the stability and functionality of Strapi. It's recommended to upgrade if you're experiencing any of the issues addressed in this release, particularly:

• Issues with relation handling for oneWay relations
• Problems with JSON attribute types in GraphQL
• SSO functionality not working in certain environments
• File deletion issues with AWS S3
• Firefox compatibility problems

Since this is an alpha release (v3.0.0-alpha.14.4.0), it's advisable to test thoroughly in a development environment before deploying to production. The upgrade should be straightforward as there are no breaking changes reported in this release.

To upgrade, update your Strapi dependencies to the latest version using your package manager:

npm install [email protected] --save

or

yarn upgrade [email protected]

Bug Fixes

Framework Fixes

• Fixed deep delete relation for oneWay relations and when there are no relations
• Fixed issues when performing 'IN' queries
• Fixed plugin installation version handling
• Fixed .gitignore in strapi-generate-admin

Plugin Fixes

• Fixed JSON attribute types in GraphQL
• Fixed error 500 when users try to sign in with incorrect credentials
• Fixed warning for controlled input without onChange handler in WYSIWYG
• Fixed hash filename usage as unique tag ID in File Upload section
• Fixed bugs related to Firefox compatibility
• Fixed SSO functionality in various environments
• Fixed file deletion from AWS S3

New Features

Documentation System Overhaul

• Migrated documentation from GitBook to VuePress
• Added version selector for documentation
• Added Google Analytics to documentation
• Updated documentation menu structure
• Added roadmap section to the README

Admin Interface Improvements

• Split Admin entry point between production and development environments for better performance
• Added delete button in Edit view for easier content management
• Improved admin authentication redirection flow

Internationalization Enhancements

• Added Japanese (JA) translations
• Updated translations for Turkish (TR), German (DE), Polish (PL), Spanish (ES), and Italian (IT)
• Fixed missing translation keys in multiple languages

Security Updates

No specific security fixes were mentioned in this release. The improvements to authentication handling, such as fixing the error 500 when signing in with incorrect credentials and improving SSO functionality, contribute to a more robust authentication system but were not explicitly labeled as security fixes.

Performance Improvements

Admin Performance

• Split Admin entry point between production and development environments for better loading times
• Cleaned up dependencies to reduce bundle size

Database Performance

• Added IF NOT EXISTS parameter for creating indexes in PostgreSQL to prevent errors on repeated operations

Documentation Performance

• Migrated to VuePress for better documentation performance and user experience
• Prevented lint from running in docs to speed up development workflow

Impact Summary

This release of Strapi (v3.0.0-alpha.14.4.0) brings significant improvements to the developer and user experience with a focus on bug fixes and enhancements across the framework and plugins.

The most notable change is the migration from GitBook to VuePress for the documentation system, providing a better documentation experience with features like version selection and improved navigation. This change will benefit all Strapi users looking for up-to-date information on how to use the CMS.

For developers, the release addresses several critical issues including fixes for relation handling, GraphQL JSON types, and database query operations. The addition of the IF NOT EXISTS parameter for PostgreSQL indexes improves database compatibility and prevents common errors.

Content managers will appreciate the new delete button in the Edit view and fixes to the WYSIWYG editor, making content management more efficient. Administrators benefit from improved authentication flows and fixed SSO functionality.

International users will find better support with updated translations for multiple languages, including the addition of Japanese translations.

Overall, this release enhances stability, usability, and developer experience across the Strapi ecosystem while laying groundwork for future improvements.

Full Release Notes