Changelog

v6.0.0

Overview

This is one of the more substantial updates since the launch of Next Cloudinary which updates and fixes an underlaying mechanism in how the CldImage component works.

The CldImage component dynamically generates not only a single URL, but multiple Cloudinary URLs through responsive sizing to provide as performant of an experience as possible. To do this, we take advantage of Cloudinary's on-the-fly cropping and resizing.

While doing this, previous versions of the CldImage component used a 2-stage resize process to provide an intuitive developer experience in how cropping was applied to images, but this created a problem where resulting images would be limited to the defined "rendered size" of an image, even if it was larger.

To resolve this, the 2-stage resizing is removed by default, but now available to use as an opt-in mechanism behind the now advanced crop prop.

Learn more over on the RFC: https://github.com/cloudinary-community/next-cloudinary/discussions/432 (opens in a new tab)

Beyond that, there are a few type and prop deprecations with replacements as necessary and bug fixes that required a slight breaking change.

Changes

• Migrates project to pnpm (#419 (opens in a new tab))

CldImage, getCldImageUrl, CldOgImage, getCldOgImageUrl

• Removes default 2-stage resizing to avoid low resolution images for larger source images (#431 (opens in a new tab))
  • Learn more about cropping
  • Learn more about responsive images
  • See the RFC with more details behind the change: https://github.com/cloudinary-community/next-cloudinary/discussions/432 (opens in a new tab)

CldImage

• Deprecates transformations in favor of namedTransformations

getCldImageUrl

• Removes types GetCldImageUrl and GetCldOgImageUrl

CldUploadWidget

• Add Content-Type to CldUploadWidget signature endpoint (#379 (opens in a new tab))
• Deprecates some CldUploadWidget types in favor of natively defined types from @cloudinary-util/types (opens in a new tab)
  • CldUploadWidgetInfo, CldUploadWidgetPropsOptions, CldUploadWidgetResults
• Updates onError and onClose callbacks to have a consistent API with the rest of the callbacks (#424 (opens in a new tab))
• Deprecates onUpload in favor of onSuccess, matching the native Cloudinary Upload Widget API (#424 (opens in a new tab))

CldVideoPlayer

• Removes autoPlay in favor of autoplay
• Video Player: CldVideoPlayerPropsColors
• Deprecates some CldVideoPlayer types in favor of natively defined types from @cloudinary-util/types (opens in a new tab)
  • CldVideoPlayerPropsColors