npm - appshot-cli - Versions diffs - 0.8.1 → 0.8.6 - Mend

appshot-cli 0.8.1 → 0.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/README.md +128 -4
package/dist/cli.js +6 -3
package/dist/cli.js.map +1 -1
package/dist/commands/backgrounds.d.ts +3 -0
package/dist/commands/backgrounds.d.ts.map +1 -0
package/dist/commands/backgrounds.js +323 -0
package/dist/commands/backgrounds.js.map +1 -0
package/dist/commands/build.d.ts.map +1 -1
package/dist/commands/build.js +35 -2
package/dist/commands/build.js.map +1 -1
package/dist/commands/check.d.ts.map +1 -1
package/dist/commands/check.js +60 -0
package/dist/commands/check.js.map +1 -1
package/dist/core/background.d.ts +31 -0
package/dist/core/background.d.ts.map +1 -0
package/dist/core/background.js +240 -0
package/dist/core/background.js.map +1 -0
package/dist/core/compose.d.ts +3 -2
package/dist/core/compose.d.ts.map +1 -1
package/dist/core/compose.js +38 -26
package/dist/core/compose.js.map +1 -1
package/dist/core/files.d.ts +1 -0
package/dist/core/files.d.ts.map +1 -1
package/dist/core/files.js +6 -0
package/dist/core/files.js.map +1 -1
package/dist/services/doctor.js +1 -1
package/dist/types.d.ts +17 -1
package/dist/types.d.ts.map +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -4,11 +4,13 @@
 [![CI](https://github.com/chrisvanbuskirk/appshot/actions/workflows/ci.yml/badge.svg)](https://github.com/chrisvanbuskirk/appshot/actions/workflows/ci.yml)
 [![npm version](https://badge.fury.io/js/appshot-cli.svg)](https://www.npmjs.com/package/appshot-cli)
+[![npm downloads](https://img.shields.io/npm/dm/appshot-cli.svg)](https://www.npmjs.com/package/appshot-cli)
+[![Node.js Version](https://img.shields.io/node/v/appshot-cli.svg)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-🆕 **Version 0.8.0** - **Frame-Only Mode**, apply device frames quickly to screenshots with transparent backgrounds - perfect for design workflows and quick exports!
+🆕 **Version 0.8.6** - **Background Images** - Replace gradients with custom static images, auto-detection, and dimension validation!
-> ⚠️ **NEW in v0.8.0**: `appshot frame` command for standalone device framing without gradients or captions. Auto-detects device types and supports batch processing with transparent PNG output.
+> ⚠️ **NEW in v0.8.6**: Use custom background images instead of gradients! Auto-detects `background.png` in device folders, supports multiple fit modes, and validates dimensions against App Store specs.
 > ⚠️ **BREAKING CHANGE in v0.4.0**: Output structure now always uses language subdirectories.
 > Single language builds now output to `final/device/lang/` instead of `final/device/`.
@@ -265,6 +267,129 @@ appshot gradients --sample
 }
 ```
+### Background System (NEW in v0.8.6)
+Replace gradients with custom static background images for a unique, branded look. Appshot supports automatic detection, multiple formats, and intelligent scaling.
+#### Background Locations
+Backgrounds are searched in priority order:
+1. **Device-specific**: `screenshots/<device>/background.png`
+2. **Global**: `screenshots/background.png`
+3. **Custom**: Path specified via config or CLI
+#### Background Commands
+```bash
+# Set background for a device
+appshot backgrounds set iphone ./backgrounds/sunset.jpg
+# Set global background for all devices
+appshot backgrounds set --global ./backgrounds/brand-bg.png
+# Validate dimensions against App Store specs
+appshot backgrounds validate
+# List all configured backgrounds
+appshot backgrounds list
+# Clear background configuration
+appshot backgrounds clear iphone
+```
+#### Build Options
+```bash
+# Auto-detect background.png in device folders
+appshot build --auto-background
+# Use specific background image
+appshot build --background ./assets/custom-bg.png
+# Set background fit mode
+appshot build --background-fit cover
+# Disable backgrounds (transparent)
+appshot build --no-background
+```
+#### Fit Modes
+- **`cover`** - Scale to cover entire area (may crop)
+- **`contain`** - Scale to fit within area (may add letterbox bars)
+- **`fill`** - Stretch to exact dimensions (may distort)
+- **`scale-down`** - Only scale down if larger, never scale up
+#### Creating Backgrounds with ImageMagick
+ImageMagick is a powerful CLI tool for creating custom backgrounds:
+```bash
+# Solid color background
+magick -size 1290x2796 canvas:navy background.png
+# Gradient background
+magick -size 1290x2796 gradient:blue-purple background.png
+# Radial gradient
+magick -size 1290x2796 radial-gradient:white-darkblue background.png
+# Plasma fractal pattern
+magick -size 1290x2796 plasma:fractal background.png
+# Blurred noise texture
+magick -size 1290x2796 xc: +noise Random -blur 0x10 background.png
+# Tiled pattern
+magick -size 100x100 pattern:checkerboard -scale 1290x2796 background.png
+# Multi-point color interpolation
+magick -size 1290x2796 xc: -sparse-color barycentric \
+  '0,0 skyblue 1290,0 white 645,2796 lightblue' background.png
+```
+#### Configuration
+```json
+{
+  "background": {
+    "mode": "image",
+    "image": "./backgrounds/global.png",
+    "fit": "cover"
+  },
+  "devices": {
+    "iphone": {
+      "background": {
+        "image": "./backgrounds/iphone.png",
+        "fit": "contain"
+      }
+    }
+  }
+}
+```
+#### Mixed Configurations
+You can mix backgrounds and gradients across devices:
+- iPhone uses a custom background image
+- iPad falls back to gradient
+- Mac uses a different background
+- Watch uses the global background
+This flexibility allows you to optimize each device's appearance independently.
+#### Dimension Validation
+Appshot validates background dimensions and warns about:
+- Images smaller than target resolution (will be upscaled)
+- Aspect ratio mismatches (may cause cropping/distortion)
+- Large file sizes (>10MB triggers optimization suggestion)
+Use `appshot backgrounds validate` to check all backgrounds before building.
 ### Font System
 Version 0.4.0 introduces comprehensive font management with intelligent fallbacks.
@@ -2042,8 +2167,7 @@ For security vulnerabilities, please see [SECURITY.md](SECURITY.md).
 ### NPM Package
 - 📦 [appshot-cli on NPM](https://www.npmjs.com/package/appshot-cli)
-- 🔄 Latest version: 0.8.0
-- ⬇️ Weekly downloads: ![npm](https://img.shields.io/npm/dw/appshot-cli)
+- 🔄 Latest version: 0.8.6
 ---

package/dist/cli.js CHANGED Viewed

@@ -12,6 +12,7 @@ import presetsCmd from './commands/presets.js';
 import validateCmd from './commands/validate.js';
 import styleCmd from './commands/style.js';
 import gradientsCmd from './commands/gradients.js';
+import backgroundsCmd from './commands/backgrounds.js';
 import fontsCmd from './commands/fonts.js';
 import migrateCmd from './commands/migrate.js';
 import { createCleanCommand } from './commands/clean.js';
@@ -23,12 +24,12 @@ import watchStatusCmd from './commands/watch-status.js';
 const program = new Command();
 program
     .name('appshot')
-    .description(`Generate App Store–ready screenshots with frames, gradients, and captions.
+    .description(`Generate App Store–ready screenshots with frames, backgrounds, and captions.
 ${pc.bold('Features:')}
   • Auto-detects portrait/landscape orientation
   • 8 embedded font families with italic & bold variants
-  • 24+ gradient presets with visual preview
+  • Custom background images or 24+ gradient presets
   • AI-powered translation to 25+ languages
   • Smart caption wrapping and positioning
   • All official App Store resolutions
@@ -44,6 +45,7 @@ ${pc.bold('Quick Start:')}
 ${pc.bold('Common Workflows:')}
   $ appshot fonts --set "Poppins Italic"     # Set italic font
   $ appshot gradients select                  # Pick gradient
+  $ appshot backgrounds set iphone bg.jpg     # Set background image
   $ appshot frame ./screenshots --recursive   # Batch frame images
   $ appshot build --preset iphone-6-9,ipad-13 # App Store presets
   $ appshot localize --langs es,fr,de        # Batch translate${platform() === 'darwin' ? `
@@ -51,7 +53,7 @@ ${pc.bold('Common Workflows:')}
   $ appshot watch start --process             # Auto-process new screenshots` : ''}
 ${pc.dim('Docs: https://github.com/chrisvanbuskirk/appshot')}`)
-    .version('0.8.1')
+    .version('0.8.6')
     .addHelpText('after', `\n${pc.bold('Environment Variables:')}
   OPENAI_API_KEY              API key for translation features
   APPSHOT_DISABLE_FONT_SCAN   Skip system font detection (CI optimization)
@@ -66,6 +68,7 @@ program.addCommand(initCmd());
 program.addCommand(captionCmd());
 program.addCommand(styleCmd());
 program.addCommand(gradientsCmd());
+program.addCommand(backgroundsCmd());
 program.addCommand(fontsCmd());
 program.addCommand(localizeCmd());
 program.addCommand(buildCmd());

package/dist/cli.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,YAAY,MAAM,yBAAyB,CAAC;AACnD,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,cAAc,MAAM,4BAA4B,CAAC;AAExD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC;;EAEb,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;;;;;;;;;;EAUpB,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC;;;;;;EAMvB,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC~~;;;;;gEAKkC~~,QAAQ,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC;;6EAEb,CAAC,CAAC,CAAC,EAAE;;EAEhF,EAAE,CAAC,GAAG,CAAC,kDAAkD,CAAC,EAAE,CAAC;KAC5D,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC;;;;EAI5D,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC;;;;;EAK/B,EAAE,CAAC,GAAG,CAAC,uDAAuD,CAAC,EAAE,CAAC,CAAC;AAErE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9B,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAE/B,8CAA8C;AAC9C,IAAI,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;IAC5B,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;AAE9D,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/backgrounds.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export default function backgroundsCommand(): Command;
+//# sourceMappingURL=backgrounds.d.ts.map

package/dist/commands/backgrounds.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"backgrounds.d.ts","sourceRoot":"","sources":["../../src/commands/backgrounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,CAAC,OAAO,UAAU,kBAAkB,IAAI,OAAO,CAmWpD"}

package/dist/commands/backgrounds.js ADDED Viewed

@@ -0,0 +1,323 @@
+import { Command } from 'commander';
+import { promises as fs } from 'fs';
+import path from 'path';
+import pc from 'picocolors';
+import { select, input } from '@inquirer/prompts';
+import { validateBackgroundDimensions, detectBestFit } from '../core/background.js';
+import { loadConfig, saveConfig } from '../core/files.js';
+export default function backgroundsCommand() {
+    const cmd = new Command('backgrounds')
+        .description('Manage background images for screenshots')
+        .addHelpText('after', `
+${pc.bold('Examples:')}
+  $ appshot backgrounds set iphone ./backgrounds/sunset.jpg
+  $ appshot backgrounds validate
+  $ appshot backgrounds preview
+  $ appshot backgrounds clear iphone
+  $ appshot backgrounds list
+${pc.bold('Background Locations:')}
+  Device-specific:  screenshots/<device>/background.png
+  Global:          screenshots/background.png
+  Custom:          Specified via config or command
+${pc.bold('Fit Modes:')}
+  cover      Scale to cover entire area (may crop)
+  contain    Scale to fit within area (may add bars)
+  fill       Stretch to exact dimensions (may distort)
+  scale-down Only scale down if larger, never scale up
+`);
+    // Set background for a device
+    cmd
+        .command('set')
+        .description('Set background image for a device')
+        .argument('[device]', 'Device type (iphone, ipad, mac, watch)')
+        .argument('[image]', 'Path to background image')
+        .option('-f, --fit <mode>', 'Fit mode: cover, contain, fill, scale-down', 'cover')
+        .option('--global', 'Set as global background for all devices')
+        .action(async (device, image, options) => {
+        try {
+            // Interactive mode if arguments not provided
+            if (!device && !options.global) {
+                device = await select({
+                    message: 'Select device type:',
+                    choices: [
+                        { name: 'iPhone', value: 'iphone' },
+                        { name: 'iPad', value: 'ipad' },
+                        { name: 'Mac', value: 'mac' },
+                        { name: 'Watch', value: 'watch' },
+                        { name: 'All Devices (Global)', value: 'global' }
+                    ]
+                });
+                if (device === 'global') {
+                    options.global = true;
+                    device = undefined;
+                }
+            }
+            if (!image) {
+                image = await input({
+                    message: 'Enter path to background image:',
+                    validate: async (value) => {
+                        try {
+                            await fs.access(value);
+                            return true;
+                        }
+                        catch {
+                            return 'File not found';
+                        }
+                    }
+                });
+            }
+            // Validate image exists
+            try {
+                await fs.access(image);
+            }
+            catch {
+                console.error(pc.red(`❌ Background image not found: ${image}`));
+                process.exit(1);
+            }
+            // Load config
+            const config = await loadConfig();
+            // Initialize background config if not exists
+            if (!config.background) {
+                config.background = {
+                    mode: 'image',
+                    warnOnMismatch: true
+                };
+            }
+            // Set background
+            if (options.global) {
+                config.background.image = image;
+                config.background.fit = options.fit;
+                console.log(pc.green(`✅ Set global background: ${image}`));
+            }
+            else {
+                // Device-specific background
+                if (!config.devices[device]) {
+                    console.error(pc.red(`❌ Device '${device}' not found in config`));
+                    console.log(pc.dim(`Available devices: ${Object.keys(config.devices).join(', ')}`));
+                    process.exit(1);
+                }
+                if (!config.devices[device].background) {
+                    config.devices[device].background = {};
+                }
+                config.devices[device].background.image = image;
+                config.devices[device].background.fit = options.fit;
+                console.log(pc.green(`✅ Set ${device} background: ${image}`));
+            }
+            // Save config
+            await saveConfig(config);
+            console.log(pc.dim('Configuration saved'));
+        }
+        catch (error) {
+            console.error(pc.red('Error setting background:'), error);
+            process.exit(1);
+        }
+    });
+    // Validate backgrounds
+    cmd
+        .command('validate')
+        .description('Validate background dimensions against App Store specs')
+        .option('-d, --device <type>', 'Validate specific device only')
+        .action(async (options) => {
+        try {
+            const config = await loadConfig();
+            let hasWarnings = false;
+            // Get devices to validate
+            const devices = options.device
+                ? [options.device]
+                : Object.keys(config.devices);
+            console.log(pc.bold('\n📐 Validating background dimensions...\n'));
+            for (const device of devices) {
+                const deviceConfig = config.devices[device];
+                if (!deviceConfig)
+                    continue;
+                // Find background image
+                let backgroundPath = null;
+                if (deviceConfig.background?.image) {
+                    backgroundPath = deviceConfig.background.image;
+                }
+                else if (config.background?.image) {
+                    backgroundPath = config.background.image;
+                }
+                else {
+                    // Check for auto-detected background
+                    const candidates = [
+                        path.join(deviceConfig.input, 'background.png'),
+                        path.join(deviceConfig.input, 'background.jpg'),
+                        path.join('screenshots', 'background.png'),
+                        path.join('screenshots', 'background.jpg')
+                    ];
+                    for (const candidate of candidates) {
+                        try {
+                            await fs.access(candidate);
+                            backgroundPath = candidate;
+                            break;
+                        }
+                        catch {
+                            // Continue checking
+                        }
+                    }
+                }
+                if (!backgroundPath) {
+                    console.log(pc.dim(`${device}: No background image found`));
+                    continue;
+                }
+                // Get target dimensions
+                const [width, height] = deviceConfig.resolution.split('x').map(Number);
+                // Validate
+                const validation = await validateBackgroundDimensions(backgroundPath, width, height);
+                // Display results
+                console.log(pc.cyan(`${device}:`));
+                console.log(pc.dim(`  Background: ${backgroundPath}`));
+                console.log(pc.dim(`  Source: ${validation.dimensions.source.width}x${validation.dimensions.source.height}`));
+                console.log(pc.dim(`  Target: ${validation.dimensions.target.width}x${validation.dimensions.target.height}`));
+                if (validation.warnings.length > 0) {
+                    hasWarnings = true;
+                    validation.warnings.forEach(warning => {
+                        console.log(pc.yellow(`  ⚠️  ${warning}`));
+                    });
+                    // Suggest best fit mode
+                    const bestFit = detectBestFit(validation.dimensions.source.width, validation.dimensions.source.height, validation.dimensions.target.width, validation.dimensions.target.height);
+                    console.log(pc.cyan(`  💡 Suggested fit mode: ${bestFit}`));
+                }
+                else {
+                    console.log(pc.green('  ✅ Dimensions OK'));
+                }
+                console.log();
+            }
+            if (hasWarnings) {
+                console.log(pc.yellow('⚠️  Some backgrounds have dimension warnings'));
+                console.log(pc.dim('Run "appshot backgrounds set" to adjust fit modes'));
+            }
+            else {
+                console.log(pc.green('✅ All backgrounds validated successfully'));
+            }
+        }
+        catch (error) {
+            console.error(pc.red('Error validating backgrounds:'), error);
+            process.exit(1);
+        }
+    });
+    // Preview backgrounds
+    cmd
+        .command('preview')
+        .description('Generate preview of screenshots with backgrounds')
+        .option('-d, --device <type>', 'Preview specific device only')
+        .option('-o, --output <dir>', 'Output directory', './preview')
+        .action(async (options) => {
+        try {
+            const config = await loadConfig();
+            const outputDir = options.output;
+            // Create output directory
+            await fs.mkdir(outputDir, { recursive: true });
+            console.log(pc.bold('\n🎨 Generating background previews...\n'));
+            // This would integrate with the compose system
+            // For now, just show what would be generated
+            const devices = options.device
+                ? [options.device]
+                : Object.keys(config.devices);
+            for (const device of devices) {
+                console.log(pc.cyan(`${device}:`));
+                console.log(pc.dim(`  Would generate preview in ${outputDir}/${device}/`));
+            }
+            console.log(pc.dim('\nNote: Full preview generation requires running "appshot build --preview"'));
+        }
+        catch (error) {
+            console.error(pc.red('Error generating preview:'), error);
+            process.exit(1);
+        }
+    });
+    // Clear background
+    cmd
+        .command('clear')
+        .description('Remove background configuration')
+        .argument('[device]', 'Device type to clear (or "all" for global)')
+        .action(async (device) => {
+        try {
+            if (!device) {
+                device = await select({
+                    message: 'Clear background for:',
+                    choices: [
+                        { name: 'iPhone', value: 'iphone' },
+                        { name: 'iPad', value: 'ipad' },
+                        { name: 'Mac', value: 'mac' },
+                        { name: 'Watch', value: 'watch' },
+                        { name: 'All Devices (Global)', value: 'all' }
+                    ]
+                });
+            }
+            const config = await loadConfig();
+            if (device === 'all') {
+                // Clear global background
+                if (config.background) {
+                    delete config.background.image;
+                    console.log(pc.green('✅ Cleared global background'));
+                }
+            }
+            else {
+                // Clear device-specific background
+                if (config.devices[device]?.background) {
+                    delete config.devices[device].background.image;
+                    console.log(pc.green(`✅ Cleared ${device} background`));
+                }
+            }
+            await saveConfig(config);
+            console.log(pc.dim('Configuration saved'));
+        }
+        catch (error) {
+            console.error(pc.red('Error clearing background:'), error);
+            process.exit(1);
+        }
+    });
+    // List backgrounds
+    cmd
+        .command('list')
+        .description('List configured backgrounds')
+        .action(async () => {
+        try {
+            const config = await loadConfig();
+            console.log(pc.bold('\n📋 Configured Backgrounds:\n'));
+            // Global background
+            if (config.background?.image) {
+                console.log(pc.cyan('Global:'));
+                console.log(pc.dim(`  Image: ${config.background.image}`));
+                console.log(pc.dim(`  Fit: ${config.background.fit || 'cover'}`));
+                console.log();
+            }
+            // Device-specific backgrounds
+            for (const [device, deviceConfig] of Object.entries(config.devices)) {
+                if (deviceConfig.background?.image) {
+                    console.log(pc.cyan(`${device}:`));
+                    console.log(pc.dim(`  Image: ${deviceConfig.background.image}`));
+                    console.log(pc.dim(`  Fit: ${deviceConfig.background.fit || 'cover'}`));
+                    console.log();
+                }
+            }
+            // Auto-detected backgrounds
+            console.log(pc.bold('Auto-detected backgrounds:'));
+            for (const [device, deviceConfig] of Object.entries(config.devices)) {
+                const candidates = [
+                    path.join(deviceConfig.input, 'background.png'),
+                    path.join(deviceConfig.input, 'background.jpg')
+                ];
+                for (const candidate of candidates) {
+                    try {
+                        await fs.access(candidate);
+                        console.log(pc.dim(`  ${device}: ${candidate}`));
+                        break;
+                    }
+                    catch {
+                        // Not found
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error(pc.red('Error listing backgrounds:'), error);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=backgrounds.js.map

package/dist/commands/backgrounds.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"backgrounds.js","sourceRoot":"","sources":["../../src/commands/backgrounds.ts"],"names":[],"mappings":"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"}

package/dist/commands/build.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,CAAC,OAAO,UAAU,QAAQ,~~YA4T~~/B"}
1	+ {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,CAAC,OAAO,UAAU,QAAQ,YA6V/B"}

package/dist/commands/build.js CHANGED Viewed

@@ -19,6 +19,10 @@ export default function buildCmd() {
         .option('--no-frame', 'skip device frames')
         .option('--no-gradient', 'skip gradient backgrounds')
         .option('--no-caption', 'skip captions')
+        .option('--background <image>', 'use specific background image')
+        .option('--no-background', 'disable background (transparent)')
+        .option('--background-fit <mode>', 'background fit mode: cover, contain, fill, scale-down', 'cover')
+        .option('--auto-background', 'auto-detect background.png in device folders')
         .option('--dry-run', 'show what would be rendered without generating images')
         .option('--verbose', 'show detailed rendering information')
         .addHelpText('after', `
@@ -41,6 +45,12 @@ ${pc.bold('Examples:')}
   ${pc.dim('# Frames only (no gradient/caption)')}
   $ appshot build --no-gradient --no-caption
+  ${pc.dim('# Use custom background image')}
+  $ appshot build --background ./assets/sunset.jpg
+  ${pc.dim('# Auto-detect background.png in device folders')}
+  $ appshot build --auto-background
   ${pc.dim('# Preview what would be built')}
   $ appshot build --dry-run
@@ -93,9 +103,10 @@ ${pc.bold('Language Detection:')}
                 }
                 // Create device output directory
                 await fs.mkdir(outputDir, { recursive: true });
-                // Get screenshots
+                // Get screenshots (excluding background images)
                 const screenshots = (await fs.readdir(inputDir))
                     .filter(f => f.match(/\.(png|jpg|jpeg)$/i))
+                    .filter(f => !f.match(/^background\.(png|jpg|jpeg)$/i))
                     .sort();
                 if (screenshots.length === 0) {
                     console.log(pc.yellow('⚠'), `No screenshots found in ${inputDir}`);
@@ -223,6 +234,27 @@ ${pc.bold('Language Detection:')}
                                     // Actual rendering
                                     let image;
                                     try {
+                                        // Configure background
+                                        let backgroundConfig = config.background;
+                                        // Override with command line options
+                                        if (opts.background) {
+                                            backgroundConfig = {
+                                                mode: 'image',
+                                                image: opts.background,
+                                                fit: opts.backgroundFit || 'cover',
+                                                warnOnMismatch: true
+                                            };
+                                        }
+                                        else if (opts.autoBackground) {
+                                            backgroundConfig = {
+                                                mode: 'auto',
+                                                fit: opts.backgroundFit || 'cover',
+                                                warnOnMismatch: true
+                                            };
+                                        }
+                                        else if (opts.noBackground) {
+                                            backgroundConfig = undefined;
+                                        }
                                         image = await composeAppStoreScreenshot({
                                             screenshot: screenshotBuffer,
                                             frame: frame,
@@ -237,7 +269,8 @@ ${pc.bold('Language Detection:')}
                                             } : undefined,
                                             caption: opts.caption !== false ? captionText : undefined,
                                             captionConfig: config.caption,
-                                            gradientConfig: config.gradient,
+                                            gradientConfig: opts.gradient === false ? undefined : config.gradient,
+                                            backgroundConfig: backgroundConfig,
                                             deviceConfig: deviceConfig,
                                             outputWidth: outWidth,
                                             outputHeight: outHeight,