Compress Images

Iterative Compression Algorithm

IMPORTANT: Keep compressing until ALL images are under 100KB. Check sizes after each pass and re-compress any that exceed the target.

Step 1: Initial pass (q 70)

cwebp -q 70 -resize 1200 0 originals/image.jpg -o image.webp
ls -lh image.webp  # Check size

Step 2: If still over 100KB, reduce quality progressively

# Try these in order until under 100KB:
cwebp -q 60 -resize 1200 0 originals/image.jpg -o image.webp
cwebp -q 50 -resize 1200 0 originals/image.jpg -o image.webp
cwebp -q 45 -resize 1200 0 originals/image.jpg -o image.webp
cwebp -q 40 -resize 1200 0 originals/image.jpg -o image.webp
cwebp -q 35 -resize 1200 0 originals/image.jpg -o image.webp

Step 3: For stubborn images, also reduce dimensions

# If q 35 at 1200px is still over 100KB, reduce to 1000px:
cwebp -q 30 -resize 1000 0 originals/image.jpg -o image.webp
cwebp -q 25 -resize 1000 0 originals/image.jpg -o image.webp

Real-World Results (Reference)

From actual compression run on content images:

Key Insights

1. Most images (under 500KB source) compress fine with default settings (q 70, 1200px)
2. Large detailed images (500KB+) often need multiple passes
3. Very large images (700KB+) may need both lower quality AND smaller dimensions
4. Keyboard/tech photos with fine detail are hardest to compress - expect 4-5 passes
5. Soft/blurry images compress much better than sharp detailed ones

After Compression

1. Verify ALL files under 100KB: ls -lh *.webp - re-run compression on any exceeding target
2. Update content files referencing old extensions (.jpg, .png) to use .webp
3. Test that images render correctly in the application
4. Original files remain in originals/ folder for future reference or re-compression