Strapi Release: 3.0.0-alpha.12

TL;DR

Strapi v3.0.0-alpha.12 introduces major new features including a WYSIWYG editor, GraphQL queries support, and Cloudinary upload provider. The release also includes a redesigned dashboard, polymorphic relationship handling in the content manager, and Russian language support. Several critical bugs have been fixed, including issues with one-to-one relations, file uploads, and database connections.

Highlight of the Release

• New WYSIWYG editor for improved content creation experience
• GraphQL queries support for more flexible data retrieval
• Cloudinary upload provider integration
• Redesigned dashboard with improved user interface
• Polymorphic relationship handling in content manager
• Russian language support added to admin interface
• Fixed one-to-one relation issues in content manager

Migration Guide

Upgrading to v3.0.0-alpha.12

1. Update your dependencies:

   npm install [email protected] [email protected] [email protected] --save
   

   Also update any Strapi plugins you're using to the same version.

2. GraphQL Plugin Setup: If you want to use the new GraphQL functionality, install the plugin:

   strapi install graphql
   

3. WYSIWYG Editor: The new WYSIWYG editor is included by default. No additional setup is required.

4. Cloudinary Provider: To use the Cloudinary upload provider:

   npm install strapi-upload-provider-cloudinary --save
   

   Then update your ./config/plugins.js file:

   module.exports = {
     upload: {
       provider: 'cloudinary',
       providerOptions: {
         cloud_name: 'your-cloud-name',
         api_key: 'your-api-key',
         api_secret: 'your-api-secret'
       }
     }
   }
   

5. Default Values: You can now set default values in the Content Type Builder for your fields.

6. Restart your server after completing the updates.

Upgrade Recommendations

This release contains significant new features and improvements that enhance both the developer and content editor experience. The addition of the WYSIWYG editor and GraphQL support are major enhancements that provide substantial value.

Who should upgrade immediately:

• Teams who need rich text editing capabilities
• Developers looking to use GraphQL for data querying
• Projects requiring Cloudinary integration
• Anyone affected by the one-to-one relation bug or other fixed issues

Considerations:

• This is still an alpha release (v3.0.0-alpha.12), so production use should be approached with caution
• Test thoroughly in a development environment before upgrading production instances
• The new features, especially GraphQL and WYSIWYG, may require adjustments to your workflow

Overall, the benefits of this release make it a recommended upgrade for most Strapi users, particularly those who would benefit from the new editor or GraphQL capabilities.

Bug Fixes

Fixed Issues

• One-to-One Relations: Fixed issue where one-to-one relations were being lost in the content manager (#892)
• Database Connection Settings: Resolved issues with SSL property in database connection settings (#928)
• Project Setup: Fixed npm run setup command to properly initialize projects (#934)
• File Upload: Fixed issue with uploaded files on entry creation (#956)
• WYSIWYG Editor: Fixed various bugs including:
  • Space handling and tab key behavior
  • Selection offsets and cursor positioning
  • Backspace behavior
  • Pasted text handling
  • Preview mode display issues
• GraphQL: Fixed babel-polyfill issues in GraphQL setup

New Features

WYSIWYG Editor

The new WYSIWYG (What You See Is What You Get) editor provides a rich text editing experience with features like:

• Text formatting controls (bold, italic, strikethrough)
• List creation (ordered and unordered)
• Media embedding with drag and drop file upload
• Link creation and management
• Code block and quote formatting
• Full-screen preview mode
• HTML preview capabilities
• Markdown toggle functionality

GraphQL Queries Support

A new GraphQL plugin has been added with comprehensive query capabilities:

• Auto-generated schema based on your content types
• Support for basic queries (find, findOne)
• Filtering, sorting, and pagination parameters
• Relationship handling including polymorphic associations
• Query arguments on nested association queries
• Support for Users & Permissions models

Cloudinary Upload Provider

Integration with Cloudinary as a file upload provider, allowing:

• Cloud-based media management
• Image optimization and transformation
• Secure asset delivery
• Simplified media workflow

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Performance Enhancements

• Optimized GraphQL queries with Bookshelf
• Improved file upload handling in the WYSIWYG editor
• Better loading states when uploading files
• Added shouldComponent checks to WYSIWYG for better rendering performance
• Improved handling of polymorphic relationships for better data retrieval

Impact Summary

Strapi v3.0.0-alpha.12 represents a significant enhancement to the platform with two major new features: a full-featured WYSIWYG editor and GraphQL query support. These additions substantially improve both the content editing experience and the developer API options.

The WYSIWYG editor transforms content creation with rich formatting, media embedding, and preview capabilities that make it much easier for content editors to create and visualize their work. This addresses a long-standing need in the Strapi ecosystem for better content editing tools.

The GraphQL implementation provides a modern, flexible way to query Strapi data with support for filtering, relationships, and complex data structures. This opens up new possibilities for front-end integration and makes Strapi a more powerful option for headless CMS use cases.

Additional improvements like polymorphic relationship handling, Cloudinary integration, and Russian language support further enhance the platform's capabilities and reach. The dashboard redesign improves the overall user experience.

Bug fixes for one-to-one relations, file uploads, and database connections address important stability issues that users have encountered.

Overall, this release significantly advances Strapi's capabilities as both a content management system and a developer platform.

Full Release Notes