Strapi Release: 3.0.0-beta.12

TL;DR

Strapi v3.0.0-beta.12 brings important documentation improvements, bug fixes for API generation and relational data handling, and updates the rate limiting package. This release enhances developer experience with clearer documentation on model associations, admin customization, and upload functionality while fixing critical issues with field naming and relation updates.

Highlight of the Release

• Fixed issue with underscores being removed from field names in API generation
• Improved relational data handling by ensuring relation updates complete before main model updates
• Enhanced documentation for model associations, admin customization, and upload functionality
• Updated koa2-ratelimit package to the latest version

Migration Guide

No specific migration steps are required for this beta release. As this is a beta version (v3.0.0-beta.12), users should be aware that APIs and functionality may still change before the final 3.0.0 release.

If you're using custom API generation or have models with underscores in field names, this update will fix issues you may have been experiencing, but no manual migration steps are needed.

Upgrade Recommendations

This beta release contains important bug fixes for API generation and relational data handling, along with documentation improvements. If you're currently using Strapi v3.0.0-beta.11, upgrading to beta.12 is recommended, especially if you:

• Use field names with underscores in your models
• Work with relational data that requires precise update ordering
• Need the latest rate limiting functionality

As this is still a beta release, it's recommended to test thoroughly in a development environment before deploying to production.

Bug Fixes

• Fixed field name handling in API generation: Resolved an issue where strapi-generate-api was incorrectly removing underscores from field names, which could cause unexpected behavior and data inconsistencies (#3590).

• Improved relational data handling: Fixed a critical issue by ensuring that relational updates are completed before the main model update, preventing potential data integrity problems (#3607).

• Fixed plugin route object documentation: Corrected errors in the documentation regarding plugin route configuration (#3610).

New Features

No significant new features were introduced in this beta release. The focus was primarily on documentation improvements, bug fixes, and dependency updates.

Security Updates

No explicit security fixes were mentioned in this release. However, updating the koa2-ratelimit package to the latest version may include security improvements, as rate limiting is an important security feature to prevent abuse of API endpoints.

Performance Improvements

No specific performance improvements were highlighted in this release. The update to the koa2-ratelimit package may provide some performance benefits, but these were not explicitly mentioned in the release notes.

Impact Summary

This release primarily impacts developers working with Strapi by fixing two important bugs and improving documentation clarity. The fix for underscore handling in field names ensures that developers can use standard naming conventions without unexpected behavior. The improvement to relational data handling ensures data integrity when updating models with relationships.

Documentation improvements make it clearer how model associations work across projects and plugins, how to customize the admin interface, and how to work with the upload functionality. These changes should reduce confusion and improve developer experience.

The update to the koa2-ratelimit package ensures that rate limiting functionality is current and reliable, which benefits both developers implementing APIs and the end users consuming those APIs by providing more consistent behavior.

Overall, while this is an incremental beta release, it addresses important quality-of-life improvements for Strapi developers.

Full Release Notes