Vadimages-nextjs-image-optimizer NPM

Vadimages Next.js image optimizer

This is a simple image optimizer for Next.js projects. It uses the sharp library to optimize images and the next/image component to display them.

Installation

npm install vadimages-nextjs-image-optimizer

Requirements

Node.js 16 or higher
Next.js 12 or higher
Set meta tag <meta name="viewport" content="width=device-width, initial-scale=1"> in your layout head

Usage

1. Set environment variables

// In your next.config.js file
module.exports = {
    env: {
        vadImage_imagesPath: "public/assets",
        vadImage_buildFolderPath: "build",
        vadImage_quality: "92",
        vadImage_formats: ['webp', 'avif'].join(','),
        vadImage_optimizationDirName: "/opt/",
        vadImage_imagesSizes: [320, 480, 512, 640, 787, 1024, 1280, 1440, 1920].join(','),
        vadImage_pixelRatio: [1, 2, 3].join(','),

        vadImage_enableUpload: "true",
        vadImage_upload_accessKey: "YOUR_CF_ACCESS_KEY",
        vadImage_upload_secretKey: "YOUR_CF_SECRET_KEY",
        vadImage_upload_endpoint: "https://YOUR_CF_ACCOUNT_ID.r2.cloudflarestorage.com",
        vadImage_upload_domain: "https://pub-YOUR_CF_ACCOUNNT_ID.r2.dev/",
        vadImage_upload_bucket: "R2_BUCKET_NAME",
    },
}

Variable	Description
`vadImage_imagesPath`	The path to the images folder in your project.
`vadImage_buildFolderPath`	The path to the build folder in your project.
`vadImage_quality`	The quality of the optimized images.
`vadImage_formats`	The formats of the optimized images.
`vadImage_optimizationDirName`	The name of the folder where the optimized images will be stored.
`vadImage_imagesSizes`	The sizes of the optimized images.
`vadImage_pixelRatio`	The pixel ratios of the optimized images.
`vadImage_enableUpload`	Enable or disable image upload to Cloudflare.
`vadImage_upload_accessKey`	The access key for the Cloudflare account.
`vadImage_upload_secretKey`	The secret key for the Cloudflare account.
`vadImage_upload_endpoint`	The endpoint for the Cloudflare account.
`vadImage_upload_domain`	The domain for the Cloudflare account.
`vadImage_upload_bucket`	The bucket name for the Cloudflare account.

2. Setup and run images build command

// In your package.json file
{
  "scripts": {
    "build:images": "vadimages-nextjs-image-optimizer --nextConfigPath ./next.config.js"
  }
}

npm run build:images

3. Use the VadImage component

import VadImage from 'vadimages-nextjs-image-optimizer';

export default function Home() {
    return (
        <VadImage
            src="/assets/image.jpg"
            alt="Image"
            width={1920}
            height={1080}
            mobileSrc="/assets/mobile-image.jpg"
            mobileWidth={640}
            mobileHeight={360}
        />
    );
}

The VadImage component has all the same props as the next/image component, plus the following additional props: