Payload CMS Release: Release 0.13.3

TL;DR

Payload CMS v0.13.3 fixes an important compatibility issue for Apple M1 users by upgrading the Sharp image processing library to use prebuilt binaries for M1 architecture. This eliminates installation problems on M1 Macs and improves the developer experience for users on Apple Silicon hardware.

Highlight of the Release

• Upgraded Sharp image processing library to use prebuilt M1 binaries
• Improved installation experience for Apple Silicon users
• Fixed compatibility issues on M1 architecture

Migration Guide

No migration steps are required for this update. This is a drop-in replacement that improves compatibility with Apple M1 hardware.

To update to v0.13.3:

# Using npm
npm install [email protected]

# Using yarn
yarn add [email protected]

After updating, M1 users should experience a smoother installation process without compilation errors related to the Sharp library.

Upgrade Recommendations

• For Apple M1/Silicon users: Strongly recommended to upgrade immediately to resolve installation and compatibility issues with the Sharp library.
• For non-M1 users: This update is not critical but still recommended to keep your dependencies current.

This is a patch release with minimal changes focused on M1 compatibility, so the upgrade should be straightforward with no breaking changes.

Bug Fixes

Sharp Library Compatibility Fix

The primary fix in this release addresses compatibility issues with the Sharp image processing library on Apple M1/Silicon hardware:

• Upgraded Sharp dependency to a version that includes prebuilt binaries for Apple M1 architecture
• Previously, M1 users would need to compile Sharp from source during installation, which could lead to errors and installation failures
• The upgrade eliminates the need for compilation, making installation smoother and more reliable for M1 users

New Features

No new features were added in this release. This is a maintenance release focused on fixing compatibility issues for Apple M1 users.

Security Updates

No security fixes were included in this release. The update was focused on compatibility improvements for the Sharp image processing library on Apple M1 hardware.

Performance Improvements

Installation and Image Processing Performance

While not explicitly mentioned in the commit messages, this update brings performance improvements for M1 users:

• Faster installation times by using prebuilt binaries instead of compiling from source
• Potentially better image processing performance as the Sharp library can now use native M1-optimized code
• Reduced CPU and memory usage during image processing operations on M1 hardware

Impact Summary

This release has a moderate impact, primarily affecting developers using Apple M1/Silicon hardware. By upgrading the Sharp image processing library to use prebuilt M1 binaries, Payload CMS has eliminated a significant pain point for M1 users who previously encountered installation issues due to Sharp requiring compilation from source.

The change improves the developer experience by making installation faster and more reliable on M1 machines. It also potentially improves image processing performance by using native M1-optimized code instead of code running through Rosetta 2 translation.

While this update doesn't introduce new features or fix functional bugs in Payload itself, it removes an important barrier to entry for developers using the increasingly popular Apple Silicon hardware, ensuring broader compatibility across development environments.

Full Release Notes