Payload CMS Release: 3.0.0-beta.73

TL;DR

PayloadCMS v3.0.0-beta.73 brings important improvements to the admin UI and developer experience. This release fixes navigation styling issues, adds SQLite support to create-payload-app, introduces relationship thumbnails for uploads, and resolves a critical performance issue with RSC props that was causing excessive HTML size. These changes enhance both the visual experience and performance of the CMS.

Highlight of the Release

• Added SQLite support to create-payload-app for simpler database setup
• Fixed navigation styling to properly highlight active items
• Added thumbnails for upload relationship fields
• Resolved critical performance issue with RSC props that was causing excessive HTML size

Migration Guide

No migration steps are required for this release. All changes are backwards compatible and should work automatically after updating to v3.0.0-beta.73.

Upgrade Recommendations

This release is recommended for all users of Payload v3.0.0-beta.72, especially those experiencing performance issues with complex nested block structures or those who want to take advantage of the new SQLite option in create-payload-app. The navigation styling fix and upload relationship thumbnails also provide valuable UI improvements.

To upgrade:

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

Bug Fixes

Fixed Active Navigation Item Styling

Navigation items in the admin UI were not displaying the correct styling when active. This was due to a change from using NavLink to standard Link components, which required manually adding the active classname. This fix ensures that the currently active navigation item is properly highlighted, improving UI clarity and navigation.

Resolved Excessive HTML Size Issue

Fixed a critical performance issue where too many React Server Component (RSC) props were being passed in complex nested block configurations, causing the initial HTML size to grow to as much as 500MB in extreme cases. This fix significantly improves page load times and reduces resource usage, particularly for content structures with deeply nested blocks and rich text editors.

New Features

SQLite Support in create-payload-app

The create-payload-app tool now offers SQLite as a database option when setting up new Payload projects. This provides developers with a lightweight, file-based database alternative that requires minimal configuration, perfect for smaller projects or development environments.

Upload Relationship Thumbnails

Upload fields that are used in relationships now display thumbnails, making it easier to visually identify and select the correct media assets. This enhancement improves the content editing experience by providing visual context when selecting or viewing related uploads.

Security Updates

No security fixes were included in this release.

Performance Improvements

Reduced Initial HTML Size

A significant performance improvement has been made by fixing how React Server Component (RSC) props are handled. Previously, in complex nested block configurations (particularly with rich text editors and layout blocks), the initial HTML size could grow to extreme sizes (up to 500MB in some cases). This fix prevents unnecessary props from being passed down, resulting in much smaller HTML payloads, faster page loads, and reduced memory usage in the browser.

Impact Summary

This release focuses on improving both the developer and content editor experience with PayloadCMS. The addition of SQLite support in create-payload-app provides a simpler database option for developers, while the upload relationship thumbnails enhance the visual experience for content editors.

The bug fixes in this release address important UI and performance issues. The navigation styling fix ensures a more intuitive admin interface by properly highlighting active items. Most notably, the fix for excessive HTML size in complex nested block configurations resolves a potentially severe performance bottleneck that could affect sites with sophisticated content structures.

Overall, v3.0.0-beta.73 represents a solid improvement to the PayloadCMS beta, addressing key usability and performance concerns while adding valuable new features.

Full Release Notes