Home

>

Tools

>

Payload CMS

>

Releases

>

3.0.0-beta.86

Payload CMS Release: 3.0.0-beta.86

Pre Release

Tag Name: v3.0.0-beta.86

Release Date: 8/20/2024

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

PayloadCMS v3.0.0-beta.86 brings significant performance improvements by pre-compiling UI components with React compiler, particularly enhancing rich text editor performance. This release also fixes several bugs including type generation for block fields, useField error message initialization, and PostgreSQL migration arguments. These changes improve both developer experience and admin panel performance.

Highlight of the Release

    • Pre-compilation of UI components with React compiler for improved performance
    • Fixed type generation for block fields with no blocks
    • Corrected useField error message initialization
    • Fixed PostgreSQL migration arguments

Migration Guide

No specific migration steps are required for this release. The performance improvements and bug fixes should work automatically after upgrading.

If you're using PostgreSQL migrations in your project, note that the MigrateUpArgs and MigrateDownArgs exports have been replaced, which may require updates if you're directly importing these types.

Upgrade Recommendations

This beta release is recommended for all PayloadCMS users who:

  1. Are already using the v3.0.0 beta series
  2. Want improved admin panel performance, especially with rich text editors
  3. Need the specific bug fixes included in this release

To upgrade:

npm install [email protected]
# or
yarn add [email protected]
# or
pnpm add [email protected]

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

Bug Fixes

This release includes several important bug fixes:

  • Type Generation for Block Fields: Fixed an issue with TypeScript type generation for block fields that have no blocks defined (#7765)

  • useField Error Message Initialization: Corrected how the useField hook initializes error messages during updates, ensuring more reliable form validation feedback (#7756)

  • PostgreSQL Migration Arguments: Fixed the export of MigrateUpArgs and MigrateDownArgs from the db-postgres module, improving the reliability of database migrations (#7766)

New Features

Pre-compilation with React Compiler

The most significant feature in this release is the pre-compilation of UI components and the rich text editor (Lexical) with React compiler. This optimization:

  • Noticeably improves performance in the admin panel
  • Particularly enhances scenarios with multiple rich text editors on a single page
  • Required adding 'use client' directives to components for proper optimization
  • Includes careful handling of components that don't work well with the compiler (with specific opt-outs where needed)

This addresses a long-standing performance issue (#7366) and should result in a smoother admin experience.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

The major performance enhancement in this release comes from pre-compiling UI components and the rich text editor with React compiler:

  • Admin Panel Responsiveness: The admin interface now responds more quickly, especially in complex layouts
  • Rich Text Editor Performance: Multiple rich text editors on a single page now load and operate more efficiently
  • React Compiler Optimizations: The implementation leverages React compiler's ability to optimize component rendering and reduce unnecessary re-renders

These improvements should be particularly noticeable for content-heavy admin interfaces and when working with multiple rich text fields simultaneously.

Impact Summary

This release significantly improves the performance of the PayloadCMS admin panel through React compiler optimizations, with particular benefits for rich text editing. The bug fixes address issues with TypeScript type generation, form field error handling, and PostgreSQL migrations.

The performance improvements should be immediately noticeable to content editors working with complex forms or multiple rich text fields. Developers will benefit from more accurate TypeScript types and more reliable database migrations with PostgreSQL.

While this is still a beta release, it represents an important step forward in optimizing the admin experience and fixing key issues reported by the community.

Full Release Notes

Statistics:

File Changed215
Line Additions1,100
Line Deletions651
Line Changes1,751
Total Commits5

User Affected:

  • Benefit from improved type generation for block fields with no blocks
  • Fixed PostgreSQL migration arguments for better database management
  • More accurate error handling with useField component

Contributors:

JarrodMFleschAlessioGrpaulpopusjmikrutdenolfe