Skip to content

A tiny (346B), 0 dependency, fully-tested Cloudinary URL generator for JS

License

Notifications You must be signed in to change notification settings

peterpme/cloudinary-microurl

Repository files navigation

Cloudinary MicroURL

🗜 Cloudinary Micro URLnpm travis

A tiny (346B), 0 dependency, fully-tested library to generate Cloudinary URLs from an options object.

The official Cloudinary js library is ~600kb. This saves you 1700%. If this were a crypto coin, you wouldn't be here, would you?

Installation

yarn add cloudinary-microurl
npm install cloudinary-microurl

Usage

const cloudinaryUrl = require('cloudinary-microurl')
const url = cloudinaryUrl('twitter.jpg', {
  secure: true,
  cloud_name: 'demo',
  gravity: 'face',
  flags: 'progressive',
  quality: 80
})

const img = new Image();
img.src = url

Supported Features

This library supports the following Cloudinary features:

  • Fetch format
  • Crop
  • Effect
  • Flags
  • Gravity
  • Height
  • Radius
  • Quality
  • Width
  • Dpr

Here's what they look like in code:

fetch_format: "f",
crop: "c",
effect: "e",
flags: "fl",
gravity: "g",
height: "h",
radius: "r",
quality: "q",
width: "w",
dpr: "dpr"

Fetch mode

Set {source: 'fetch'} to activate cloundinary fetch mode. You need to enable it in the security options. The image name should be a full URL.

Contributions

If there's an effect thats missing, create an Issue or an PR. It's SUPER EASY!

Thanks to the original author

This library was originally created by josephg

About

A tiny (346B), 0 dependency, fully-tested Cloudinary URL generator for JS

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published