ts-images

A powerful image optimization and manipulation toolkit for modern web development. This is the core library package of the imgx project.

Installation

bun add ts-images -d
# or
npm install ts-images --save-dev

Usage

Library

import { optimizeImage, processImage } from 'ts-images'

// Optimize a single image
await optimizeImage('input.jpg', {
  quality: 80,
  format: 'webp',
  output: 'output.webp',
})

// Process with advanced options
await processImage('photo.png', {
  resize: { width: 800, height: 600 },
  format: 'avif',
  quality: 75,
})

CLI

# Optimize an image
imgx optimize input.jpg --quality 80 --format webp

# Batch process images
imgx batch ./images --format webp --quality 80

# Generate app icons
imgx app-icon logo.png --output ./icons

# Generate favicons
imgx favicon logo.svg --output ./public

# Optimize SVGs
imgx svg-optimize ./svgs

Features

• Format Conversion - Convert between JPEG, PNG, WebP, AVIF, GIF, BMP
• Image Optimization - Lossy and lossless compression with smart quality settings
• Batch Processing - Process multiple images with configurable pipelines
• App Icon Generation - Generate iOS, macOS, and Android app icons from a single source
• Favicon Generation - Generate all required favicon sizes and formats
• SVG Optimization - Minify and optimize SVG files via SVGO
• Image Placeholders - Generate ThumbHash and BlurHash placeholders
• Responsive Images - Generate multiple sizes for responsive web design
• Watermarking - Add text or image watermarks
• Image to SVG - Convert raster images to SVG using potrace

Supported Formats

License

MIT