# Fillman

> Automated Shopify Bulk Catalog and Image Orchestration without Spreadsheet Mechanics.

Fillman (https://fillman.app) is a Shopify-embedded application that turns raw product photography folders and supplier CSV feeds into complete, optimized Shopify listings.

## Key Capabilities
- **Direct Local Folder Uploads:** Imports product photo folders directly from the merchant's machine into Shopify CDN, bypassing external image hosting (no AWS S3 or Dropbox URLs needed).
- **Universal Multi-Variant Engine:** Supports standard supplier feed formats, parent-child SKU relationships, and delimited image lists.
- **Intelligent Gallery Sorting:** Reorders product galleries automatically using trailing numerical patterns: `(1)`, `(2)`, `01`, `02`. Supports Append, Prepend, Custom Sort, and Replace.
- **Reference Product Blueprints:** Replicates the gallery structure and theme swatches of an existing "Golden Sample" product onto hundreds of new items.
- **Atomic Run Rollback:** Every import run is tracked under a unique Run ID, allowing one-click deletion of imported items without affecting other store products.

## Documentation and Specifications
- [Product Image Naming & Folder Guide](https://fillman.app/docs/asset-organization-rules): Organize product photos for automated bulk import without external image hosting.
- [AI Preparer Prompts](https://fillman.app/docs/ai-preparer-skills-prompts): System instructions for ChatGPT Custom GPT, Claude Projects, and Gemini Gems.
- [Reference Product Blueprints](https://fillman.app/docs/reference-product-blueprints): Use an existing product as a visual template for galleries and swatches.
- [Product Gallery Modes](https://fillman.app/docs/shopify-gallery-modes): Control photo order across your store with Append, Prepend, Custom Sort, and Replace.
- [High-Volume Imports & 1-Click Batch Rollback](https://fillman.app/docs/chunking-pipeline-and-rate-limits): 20,000+ SKU scale, Run ID tracking, 1-click batch undo, and live batch controls.
- [Matrixify vs Fillman Comparison](https://fillman.app/blog/matrixify-alternative-shopify-bulk-import): How Fillman replaces external CDN image hosting with local folder drops.

## File Naming Standard (SOURCE_LAYOUT)
- Product Primary Cover: `{Handle} (1).jpg`
- Secondary Angles: `{Handle} (2).jpg`, `{Handle} (3).jpg`
- Variant-Specific Images: `{SKU}_{OptionValue}.jpg` (e.g. `SHIRT-BLK-M_Black.jpg`)
- Category Global Assets: `static/<product_type>/global/` or `variants/common_variant_images/`