Social Media Image Sizes

.DS_Store
.pi/
node_modules/
.pnpm-store/
pnpm-lock.yaml
package-lock.json
skills-lock.json

# installed skill directories (created by npx skills add)
.agents/
.claude/
.codex/
.codebuddy/
.commandcode/
.continue/
.crush/
.cursor/
.factory/
.goose/
.junie/
.kilocode/
.kiro/
.kode/
.mcpjam/
.mux/
.neovate/
.openhands/
.pochi/
.qoder/
.qwen/
.roo/
.trae/
.vibe/
.windsurf/
.zencoder/

MIT License

Copyright (c) 2025 Branding5

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

{
  "name": "@branding5/social-media-image-sizes",
  "version": "1.0.0",
  "description": "Check and resize images for social media platforms. CLI tools for AI agents.",
  "license": "MIT",
  "author": "Branding5 (https://www.branding5.com)",
  "homepage": "https://github.com/Branding5/social-media-image-sizes",
  "repository": {
    "type": "git",
    "url": "https://github.com/Branding5/social-media-image-sizes"
  },
  "scripts": {
    "check":  "node scripts/check.js",
    "resize": "node scripts/resize.js"
  },
  "dependencies": {
    "sharp": "^0.33.0"
  },
  "engines": {
    "node": ">=18"
  }
}

#!/usr/bin/env node
/**
 * check.js — validate an image against social media platform specs
 *
 * Usage:
 *   node check.js <image-path> [--platform <slug>] [--filter perfect|close|usable|too-small]
 *
 * Examples:
 *   node check.js photo.jpg
 *   node check.js banner.png --platform linkedin
 *   node check.js story.jpg --filter perfect
 */

const fs   = require('fs');
const path = require('path');
const { getAllSpecs } = require('./platform-data');

// ─── argument parsing ──────────────────────────────────────────────────────────

const args    = process.argv.slice(2);
const imgPath = args.find(a => !a.startsWith('--'));

if (!imgPath) {
  console.error('Usage: node check.js <image-path> [--platform <slug>] [--filter perfect|close|usable|too-small]');
  process.exit(1);
}

if (!fs.existsSync(imgPath)) {
  console.error(`File not found: ${imgPath}`);
  process.exit(1);
}

const platformFlag = args.includes('--platform') ? args[args.indexOf('--platform') + 1] : null;
const filterFlag   = args.includes('--filter')   ? args[args.indexOf('--filter')   + 1] : null;

// ─── read image dimensions ─────────────────────────────────────────────────────

let sharp;
try {
  sharp = require('sharp');
} catch {
  console.error('sharp is not installed. Run: npm install');
  process.exit(1);
}

async function run() {
  const meta     = await sharp(imgPath).metadata();
  const { width, height } = meta;
  const fileSize = fs.statSync(imgPath).size;
  const aspect   = (width / height).toFixed(2);

  // ─── classify ───────────────────────────────────────────────────────────────

  function classify(imgW, imgH, specW, specH) {
    const wRatio = imgW / specW;
    const hRatio = imgH / specH;
    if (Math.abs(wRatio - 1) <= 0.02 && Math.abs(hRatio - 1) <= 0.02) return 'perfect';

    const imgAsp  = imgW / imgH;
    const specAsp = specW / specH;
    const aspDiff = Math.abs(imgAsp - specAsp) / specAsp;
    if (aspDiff <= 0.03 && wRatio >= 0.9 && hRatio >= 0.9) return 'close';

    if (imgW >= specW && imgH >= specH) return 'usable';
    return 'too-small';
  }

  const LEVEL_ORDER = { perfect: 0, close: 1, usable: 2, 'too-small': 3 };
  const LEVEL_ICON  = { perfect: '✅', close: '🟡', usable: '🔄', 'too-small': '❌' };
  const LEVEL_LABEL = { perfect: 'PERFECT', close: 'CLOSE (scale only)', usable: 'USABLE (will crop)', 'too-small': 'TOO SMALL' };

  let specs = getAllSpecs();
  if (platformFlag) specs = specs.filter(s => s.slug === platformFlag);

  const results = specs
    .map(s => ({ ...s, level: classify(width, height, s.width, s.height) }))
    .filter(s => !filterFlag || s.level === filterFlag)
    .sort((a, b) => LEVEL_ORDER[a.level] - LEVEL_ORDER[b.level]);

  // ─── output ─────────────────────────────────────────────────────────────────

  const bar = '─'.repeat(60);
  console.log(`\n${bar}`);
  console.log(`  📐  ${path.basename(imgPath)}`);
  console.log(`      ${width} × ${height} px  (${aspect}:1)  •  ${formatSize(fileSize)}`);
  console.log(bar);

  if (results.length === 0) {
    console.log('\n  No matches found.\n');
  } else {
    let lastLevel = null;
    for (const r of results) {
      if (r.level !== lastLevel) {
        console.log(`\n  ${LEVEL_ICON[r.level]}  ${LEVEL_LABEL[r.level]}`);
        lastLevel = r.level;
      }
      const sizeStr  = `${r.width}×${r.height}`;
      const noteStr  = r.notes ? `  · ${r.notes}` : '';
      const resizeHint = r.level !== 'perfect'
        ? `  → node scripts/resize.js ${imgPath} "${r.platform} ${r.name}"`
        : '';
      console.log(`     ${r.platform.padEnd(12)} ${r.category.padEnd(20)} ${r.name.padEnd(28)} ${sizeStr.padEnd(12)} ${r.aspect}${noteStr}${resizeHint}`);
    }
  }

  // counts
  const counts = {};
  for (const l of ['perfect','close','usable','too-small']) counts[l] = results.filter(r => r.level === l).length;
  console.log(`\n${bar}`);
  console.log(`  ✅ ${counts.perfect} perfect   🟡 ${counts.close} close   🔄 ${counts.usable} usable   ❌ ${counts['too-small']} too small`);
  console.log(`  Full reference → branding5.com/tools/social-media-cheat-sheet`);
  console.log(`${bar}\n`);
}

function formatSize(bytes) {
  if (bytes < 1024)          return `${bytes} B`;
  if (bytes < 1024 * 1024)   return `${(bytes / 1024).toFixed(1)} KB`;
  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
}

run().catch(e => { console.error(e.message); process.exit(1); });

// Social media platform specs — matches branding5.com/tools/social-media-cheat-sheet
// Updated 2025

const platforms = [
  {
    name: 'Instagram', slug: 'instagram',
    categories: [
      { name: 'Profile', sizes: [
        { name: 'Profile Photo', width: 320, height: 320, aspect: '1:1', notes: 'Displays as 110×110 on mobile' }
      ]},
      { name: 'Feed Posts', sizes: [
        { name: 'Portrait Post',  width: 1080, height: 1350, aspect: '4:5',    maxFileSize: '30MB', notes: 'Best for engagement' },
        { name: 'Square Post',    width: 1080, height: 1080, aspect: '1:1',    maxFileSize: '30MB' },
        { name: 'Landscape Post', width: 1080, height: 566,  aspect: '1.91:1', maxFileSize: '30MB' }
      ]},
      { name: 'Stories & Reels', sizes: [
        { name: 'Story',                 width: 1080, height: 1920, aspect: '9:16',   notes: 'Keep text in safe zone (center 1080×1420)' },
        { name: 'Reel',                  width: 1080, height: 1920, aspect: '9:16',   notes: 'Cover photo: 1080×1920' },
        { name: 'Reel Cover Thumbnail',  width: 420,  height: 654,  aspect: '1:1.55', notes: 'Shown in grid as 1:1 crop' }
      ]},
      { name: 'Carousel', sizes: [
        { name: 'Carousel Square',   width: 1080, height: 1080, aspect: '1:1', notes: 'Up to 10 slides' },
        { name: 'Carousel Portrait', width: 1080, height: 1350, aspect: '4:5', notes: 'Up to 10 slides; best engagement' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Feed Ad (Square)',    width: 1080, height: 1080, aspect: '1:1' },
        { name: 'Feed Ad (Landscape)', width: 1200, height: 628,  aspect: '1.91:1' },
        { name: 'Story Ad',            width: 1080, height: 1920, aspect: '9:16' }
      ]}
    ]
  },
  {
    name: 'Facebook', slug: 'facebook',
    categories: [
      { name: 'Profile & Cover', sizes: [
        { name: 'Profile Photo', width: 170,  height: 170, aspect: '1:1',    notes: 'Displays 176×176 on desktop, 196×196 on smartphones' },
        { name: 'Cover Photo',   width: 820,  height: 312, aspect: '2.63:1', notes: 'Min 400×150. Displays at 820×312 on desktop, 640×360 on mobile' }
      ]},
      { name: 'Feed Posts', sizes: [
        { name: 'Image Post (Landscape)', width: 1200, height: 630,  aspect: '1.91:1' },
        { name: 'Image Post (Square)',    width: 1200, height: 1200, aspect: '1:1' },
        { name: 'Image Post (Portrait)',  width: 1080, height: 1350, aspect: '4:5' }
      ]},
      { name: 'Stories & Reels', sizes: [
        { name: 'Story', width: 1080, height: 1920, aspect: '9:16', notes: 'Leave 14% top & 20% bottom for UI' },
        { name: 'Reel',  width: 1080, height: 1920, aspect: '9:16' }
      ]},
      { name: 'Events & Groups', sizes: [
        { name: 'Event Cover', width: 1920, height: 1005, aspect: '1.91:1' },
        { name: 'Group Cover', width: 1640, height: 856,  aspect: '1.91:1' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Feed Ad',         width: 1200, height: 628,  aspect: '1.91:1' },
        { name: 'Carousel Ad',     width: 1080, height: 1080, aspect: '1:1',    notes: '2–10 cards' },
        { name: 'Right Column Ad', width: 1200, height: 628,  aspect: '1.91:1' },
        { name: 'Marketplace Ad',  width: 1200, height: 628,  aspect: '1.91:1' }
      ]}
    ]
  },
  {
    name: 'X (Twitter)', slug: 'twitter',
    categories: [
      { name: 'Profile & Header', sizes: [
        { name: 'Profile Photo', width: 400,  height: 400, aspect: '1:1', notes: 'Displayed as circle, 200×200' },
        { name: 'Header Image',  width: 1500, height: 500, aspect: '3:1' }
      ]},
      { name: 'Posts', sizes: [
        { name: 'Single Image', width: 1600, height: 900, aspect: '16:9',   notes: 'Min 600×335. Max 5MB (images), 15MB (GIFs)' },
        { name: 'Two Images',   width: 700,  height: 800, aspect: '7:8',    notes: 'Per image in 2-image post' },
        { name: 'Card Image',   width: 800,  height: 418, aspect: '1.91:1', notes: 'Link preview cards' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Single Image Ad', width: 1200, height: 675, aspect: '16:9' },
        { name: 'Carousel Ad',     width: 800,  height: 800, aspect: '1:1',    notes: '2–6 cards' },
        { name: 'Website Card',    width: 800,  height: 418, aspect: '1.91:1' }
      ]}
    ]
  },
  {
    name: 'LinkedIn', slug: 'linkedin',
    categories: [
      { name: 'Profile & Cover', sizes: [
        { name: 'Profile Photo',    width: 400,  height: 400, aspect: '1:1',    notes: 'Min 200×200, max 8MB' },
        { name: 'Background Photo', width: 1584, height: 396, aspect: '4:1' },
        { name: 'Company Logo',     width: 300,  height: 300, aspect: '1:1' },
        { name: 'Company Cover',    width: 1128, height: 191, aspect: '5.91:1' }
      ]},
      { name: 'Feed Posts', sizes: [
        { name: 'Image Post (Landscape)', width: 1200, height: 627,  aspect: '1.91:1' },
        { name: 'Image Post (Square)',    width: 1200, height: 1200, aspect: '1:1' },
        { name: 'Image Post (Portrait)',  width: 1080, height: 1350, aspect: '4:5', notes: 'Best engagement on feed' }
      ]},
      { name: 'Articles & Newsletters', sizes: [
        { name: 'Article Cover',    width: 1920, height: 1080, aspect: '16:9' },
        { name: 'Newsletter Cover', width: 1920, height: 1080, aspect: '16:9' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Sponsored Content', width: 1200, height: 627,  aspect: '1.91:1' },
        { name: 'Carousel Ad',       width: 1080, height: 1080, aspect: '1:1',    notes: '2–10 cards' },
        { name: 'Spotlight Ad Logo', width: 100,  height: 100,  aspect: '1:1' }
      ]}
    ]
  },
  {
    name: 'TikTok', slug: 'tiktok',
    categories: [
      { name: 'Profile', sizes: [
        { name: 'Profile Photo', width: 200, height: 200, aspect: '1:1' }
      ]},
      { name: 'Videos', sizes: [
        { name: 'Video (Full Screen)', width: 1080, height: 1920, aspect: '9:16', notes: 'Min 720×1280. Max 10 min.' },
        { name: 'Video Thumbnail',     width: 1080, height: 1920, aspect: '9:16', notes: 'Custom thumbnail from video' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'In-Feed Ad', width: 1080, height: 1920, aspect: '9:16', notes: '5–60 seconds' },
        { name: 'TopView Ad', width: 1080, height: 1920, aspect: '9:16', notes: 'Up to 60 seconds' },
        { name: 'Spark Ad',   width: 1080, height: 1920, aspect: '9:16', notes: 'Boosted organic content' }
      ]}
    ]
  },
  {
    name: 'YouTube', slug: 'youtube',
    categories: [
      { name: 'Channel Art', sizes: [
        { name: 'Profile Photo', width: 800,  height: 800,  aspect: '1:1',  notes: 'Displays as 98×98' },
        { name: 'Channel Banner', width: 2560, height: 1440, aspect: '16:9', notes: 'Safe area: 1546×423 (center)' }
      ]},
      { name: 'Videos', sizes: [
        { name: 'Video Upload (1080p)', width: 1920, height: 1080, aspect: '16:9' },
        { name: 'Video Upload (4K)',    width: 3840, height: 2160, aspect: '16:9' },
        { name: 'Custom Thumbnail',     width: 1280, height: 720,  aspect: '16:9', notes: 'Min 640×360. Max 2MB' },
        { name: 'Shorts',               width: 1080, height: 1920, aspect: '9:16', notes: 'Up to 60 seconds' }
      ]},
      { name: 'Community & Ads', sizes: [
        { name: 'Community Post Image', width: 1200, height: 675, aspect: '16:9' },
        { name: 'Display Ad',           width: 300,  height: 250, aspect: '6:5' },
        { name: 'Overlay Ad',           width: 480,  height: 70,  aspect: '48:7' }
      ]}
    ]
  },
  {
    name: 'Pinterest', slug: 'pinterest',
    categories: [
      { name: 'Profile', sizes: [
        { name: 'Profile Photo', width: 165, height: 165, aspect: '1:1' },
        { name: 'Board Cover',   width: 222, height: 150, aspect: '3:2' }
      ]},
      { name: 'Pins', sizes: [
        { name: 'Standard Pin', width: 1000, height: 1500, aspect: '2:3',   notes: 'Optimal ratio for feed' },
        { name: 'Square Pin',   width: 1000, height: 1000, aspect: '1:1' },
        { name: 'Long Pin',     width: 1000, height: 2100, aspect: '1:2.1', notes: 'Max ratio 1:2.1' },
        { name: 'Idea Pin',     width: 1080, height: 1920, aspect: '9:16',  notes: 'Up to 20 pages' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Promoted Pin', width: 1000, height: 1500, aspect: '2:3' },
        { name: 'Carousel Ad',  width: 1000, height: 1500, aspect: '2:3', notes: '2–5 cards' },
        { name: 'Shopping Ad',  width: 1000, height: 1500, aspect: '2:3' }
      ]}
    ]
  },
  {
    name: 'Snapchat', slug: 'snapchat',
    categories: [
      { name: 'Content', sizes: [
        { name: 'Snap',      width: 1080, height: 1920, aspect: '9:16' },
        { name: 'Spotlight', width: 1080, height: 1920, aspect: '9:16', notes: '5–60 seconds' },
        { name: 'Story',     width: 1080, height: 1920, aspect: '9:16' }
      ]},
      { name: 'Ads', sizes: [
        { name: 'Single Image/Video Ad', width: 1080, height: 1920, aspect: '9:16' },
        { name: 'Collection Ad',         width: 1080, height: 1920, aspect: '9:16',   notes: 'Up to 4 tappable tiles' },
        { name: 'Filter/Lens',           width: 1080, height: 2340, aspect: '9:19.5', notes: 'Full device screen' }
      ]}
    ]
  },
  {
    name: 'Threads', slug: 'threads',
    categories: [
      { name: 'Profile', sizes: [
        { name: 'Profile Photo', width: 320, height: 320, aspect: '1:1', notes: 'Same as Instagram profile' }
      ]},
      { name: 'Posts', sizes: [
        { name: 'Image Post (Square)',    width: 1080, height: 1080, aspect: '1:1' },
        { name: 'Image Post (Landscape)', width: 1080, height: 566,  aspect: '1.91:1' },
        { name: 'Image Post (Portrait)',  width: 1080, height: 1350, aspect: '4:5' }
      ]}
    ]
  }
];

// Flat list of all specs with platform/category context — useful for check.js
function getAllSpecs() {
  const specs = [];
  for (const platform of platforms) {
    for (const category of platform.categories) {
      for (const size of category.sizes) {
        specs.push({ platform: platform.name, slug: platform.slug, category: category.name, ...size });
      }
    }
  }
  return specs;
}

// Generate a slug-style key for resize.js targeting, e.g. "instagram-portrait-post"
function getSpecKey(platformName, sizeName) {
  return `${platformName}-${sizeName}`.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
}

module.exports = { platforms, getAllSpecs, getSpecKey };

#!/usr/bin/env node
/**
 * resize.js — resize an image to a named social media spec
 *
 * Usage:
 *   node resize.js <image-path> "<Platform> <Size Name>" [options]
 *   node resize.js <image-path> --list            # list all available spec names
 *
 * Options:
 *   --fit cover    Center-crop to fill exact dimensions (default)
 *   --fit contain  Letterbox — scale to fit, pad with background color
 *   --bg <hex>     Background color for contain mode (default: ffffff)
 *   --out <path>   Output file path (default: auto-named alongside input)
 *
 * Examples:
 *   node resize.js photo.jpg "Instagram Portrait Post"
 *   node resize.js photo.jpg "YouTube Custom Thumbnail"
 *   node resize.js banner.png "LinkedIn Background Photo" --fit contain --bg 000000
 *   node resize.js photo.jpg "Instagram Portrait Post" --out ./exports/ig-portrait.jpg
 */

const fs   = require('fs');
const path = require('path');
const { getAllSpecs } = require('./platform-data');

// ─── argument parsing ──────────────────────────────────────────────────────────

const args    = process.argv.slice(2);
const imgPath = args[0];

if (!imgPath || imgPath.startsWith('--')) {
  printUsage();
  process.exit(1);
}

if (args.includes('--list')) {
  listSpecs();
  process.exit(0);
}

const specQuery = args[1];
if (!specQuery || specQuery.startsWith('--')) {
  printUsage();
  process.exit(1);
}

if (!fs.existsSync(imgPath)) {
  console.error(`File not found: ${imgPath}`);
  process.exit(1);
}

const fitRaw   = args.includes('--fit')   ? args[args.indexOf('--fit') + 1]   : 'cover';
const fitMode  = ['cover', 'contain'].includes(fitRaw) ? fitRaw : (() => { console.error(`Invalid --fit value: "${fitRaw}". Use "cover" or "contain".`); process.exit(1); })();
const bgColor  = args.includes('--bg')    ? args[args.indexOf('--bg') + 1]     : 'ffffff';
const outArg   = args.includes('--out')   ? args[args.indexOf('--out') + 1]    : null;

// ─── helpers ───────────────────────────────────────────────────────────────────

function listSpecs() {
  const specs = getAllSpecs();
  console.log('\nAvailable specs (use as second argument):\n');
  let lastPlatform = null;
  for (const s of specs) {
    if (s.platform !== lastPlatform) {
      console.log(`  ${s.platform}`);
      lastPlatform = s.platform;
    }
    console.log(`    "${s.platform} ${s.name}"  →  ${s.width}×${s.height}  (${s.aspect})`);
  }
  console.log('');
}

function findSpec(query) {
  const specs = getAllSpecs();
  const q     = query.toLowerCase().trim();

  // exact match first
  let match = specs.find(s => `${s.platform} ${s.name}`.toLowerCase() === q);
  if (match) return match;

  // partial match
  match = specs.find(s => `${s.platform} ${s.name}`.toLowerCase().includes(q));
  if (match) return match;

  // fuzzy: all words present
  const words = q.split(/\s+/);
  match = specs.find(s => {
    const hay = `${s.platform} ${s.category} ${s.name}`.toLowerCase();
    return words.every(w => hay.includes(w));
  });
  return match || null;
}

function buildOutputPath(inputPath, spec) {
  const ext    = path.extname(inputPath) || '.jpg';
  const base   = path.basename(inputPath, ext);
  const suffix = `${spec.platform}-${spec.name}`.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
  const dir    = path.dirname(inputPath);
  return path.join(dir, `${base}-${suffix}${ext}`);
}

function printUsage() {
  console.log('Usage: node resize.js <image-path> "<Platform> <Size Name>" [--fit cover|contain] [--bg hex] [--out path]');
  console.log('       node resize.js <image-path> --list');
}

function hexToRgb(hex) {
  let h = hex.replace(/^#/, '');
  if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
  if (!/^[0-9a-fA-F]{6}$/.test(h)) {
    console.error(`Invalid --bg hex color: "${hex}". Use a 3- or 6-digit hex value (e.g. fff or f0f0f0).`);
    process.exit(1);
  }
  return {
    r: parseInt(h.substring(0, 2), 16),
    g: parseInt(h.substring(2, 4), 16),
    b: parseInt(h.substring(4, 6), 16)
  };
}

// ─── main ──────────────────────────────────────────────────────────────────────

let sharp;
try {
  sharp = require('sharp');
} catch {
  console.error('sharp is not installed. Run: npm install');
  process.exit(1);
}

async function run() {
  const spec = findSpec(specQuery);
  if (!spec) {
    console.error(`\nSpec not found: "${specQuery}"`);
    console.error('Run: node resize.js <image> --list\n');
    process.exit(1);
  }

  const outPath = outArg || buildOutputPath(imgPath, spec);
  const outDir = path.dirname(outPath);
  if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
  const { width: W, height: H } = spec;

  let pipeline = sharp(imgPath);

  if (fitMode === 'contain') {
    const rgb = hexToRgb(bgColor);
    pipeline = pipeline.resize(W, H, {
      fit:        'contain',
      background: { r: rgb.r, g: rgb.g, b: rgb.b, alpha: 1 }
    });
  } else {
    // default: cover (center crop)
    pipeline = pipeline.resize(W, H, {
      fit:      'cover',
      position: 'centre'
    });
  }

  // preserve format from extension
  const ext = path.extname(outPath).toLowerCase();
  if      (ext === '.png')  pipeline = pipeline.png({ quality: 90 });
  else if (ext === '.webp') pipeline = pipeline.webp({ quality: 85 });
  else                      pipeline = pipeline.jpeg({ quality: 90, mozjpeg: true });

  await pipeline.toFile(outPath);

  const outSize = fs.statSync(outPath).size;
  console.log(`\n✅  ${path.basename(outPath)}`);
  console.log(`    ${W} × ${H} px  (${spec.aspect})  •  ${formatSize(outSize)}`);
  console.log(`    ${spec.platform} — ${spec.category} — ${spec.name}`);
  if (spec.notes) console.log(`    💡 ${spec.notes}`);
  console.log(`    Saved to: ${outPath}\n`);
}

function formatSize(bytes) {
  if (bytes < 1024)         return `${bytes} B`;
  if (bytes < 1024 * 1024)  return `${(bytes / 1024).toFixed(1)} KB`;
  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
}

run().catch(e => { console.error(e.message); process.exit(1); });