cloudinary / cloudinary-js-base

Hey there!

This repository is a work in progress in a pre-alpha state. Needless to say it's not stable, all APIs and syntax are subject to change.

Feel free to peek around and play with our new API.

Interested in Cloudinary?

Feel free to visit our more mature SDKs:

• Javascript
• React
• Angular
• Vue
• Node

What is this project for?

This project comes to replace and modernize our existing JS offering, and it's part of a larger effort in Cloudinary.

You can read more about the project here:

• Cloudinary's Next Generation SDKs
• Cloudinary's next generation JS SDKs

Key Features

• ESM packages, import only what you need
• Declarative Syntax
• Fully typed for excellent IDE support
• Easy to write, easy to read.

Example Syntax

import {TransformableImage} from '@cloudinary/base';
import {scale} from '@cloudinary/base/actions/resize';
let tImage = new TransformableImage('sample')
  .setConfig({
    cloud: {
      cloudName:'demo'    
    }  
  })
  .resize(scale(100, 100))
 
let url = tImage.toURL()

// The above results in the following URL
// https://res.cloudinary.com/demo/image/upload/c_scale,h_100,w_100/sample

Progress report

We're currently working on implementing all the wide range of features and possible transformations.

We've created a progress report that visualizes our efforts:

https://cloudinary.github.io/cloudinary-js-base/public/progress/cloudinary-base-progress-report.html