Skip to content

🖼️ Generate imgproxy url in browser and Node easily. Lightweight and Fast!

License

Notifications You must be signed in to change notification settings

misaon/imgproxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

48a240b · Mar 2, 2023

History

11 Commits
Mar 1, 2023
Mar 2, 2023
Mar 2, 2023
Mar 2, 2023
Mar 1, 2023
Mar 2, 2023
Mar 2, 2023
Mar 1, 2023
Mar 2, 2023
Mar 1, 2023
Mar 2, 2023
Mar 2, 2023
Mar 2, 2023
Mar 1, 2023
Mar 2, 2023

Repository files navigation

🖼️ @misaon/imgproxy

npm version npm downloads Github Actions Codecov

Generate imgproxy url in browser and Node easily. Lightweight and Fast!

Features

  • 👌  Zero configuration
  • 🪄  Modern, tiny and tree shaken code
  • ⚙️  Written in TypeScript
  • 🕒  Async-less methods and crypto computing
  • 🚀  Browser and Node support
  • 📦  Extendable and customizable
  • 📰  Compatible with the latest version of imgproxy
  • 🧪  Covered by tests >99%

Usage

Install package:

# npm
npm install @misaon/imgproxy

# yarn
yarn add @misaon/imgproxy

# pnpm
pnpm install @misaon/imgproxy

then in your code:

import { getImageUrl } from "@misaon/imgproxy";

const imageUrl = getImageUrl("https://example.com/my-image.jpg", {
  baseURL: "https://my-imgproxy.com", // optional
  secret: "imgproxy-secret-key",
  salt: "imgproxy-salt",
  modifiers: {
    width: "100",
    height: "75",
    // other modifiers... (see below)
  },
});

console.log(imageUrl);

That's all! 🥂


If you like use CommonJS, you can import like this:

const { getImageUrl } = require("misaon/imgproxy");

Modifiers

The list of modifiers that you can use is well typed and can be found here or in imgproxy docs.

Development

  • Clone this repository
  • Install latest LTS version of Node.js
  • Enable Corepack using corepack enable
  • Install dependencies using pnpm install
  • Run interactive tests using pnpm dev

License

Made with 🧡 by @misaon

Published under MIT License.