printful-pod

End-to-end Printful POD pipeline — takes a design PNG through file validation, upload, mockup generation, visual QA, and product listing. For selling merch online via Printful’s catalog.

Model	Source
sonnet	pack: merch

Full Reference

┏━ 🔧 printful-pod ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ [one-line description of Printful product task] ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Overview

Full pipeline from design PNG to sellable Printful product. Handles file validation, upload, mockup generation, visual QA, and sync product creation. Loads printful-api for API reference.

Reference Index

File	Contents
`reference/workflow.md`	Step-by-step pipeline with API calls, validation checks, error handling
`reference/garments.md`	Blank recommendations by use case — budget, standard, premium with specs

Pipeline Flow

Design PNG
  ↓
1. Validate print file specs
   → Resolution check (150+ DPI apparel, 300+ DPI accessories)
   → Dimension check against product print area
   → Transparent background for DTG
   ↓
2. Upload to Printful file library
   → POST /v2/files with design URL
   → Store file_id for reuse
   ↓
3. Generate mockups
   → Invoke mockup-generator (Printful provider)
   → Multiple colors in one request
   → Poll or webhook for completion
   ↓
4. Visual QA (merch-qa)
   → Invoke merch-qa with product_type=apparel_mockup
   → Verify design placement, color contrast, realism
   → Pass: continue | Fail: flag issues, revise
   ↓
5. Create sync product (if e-commerce connected)
   → POST /v2/sync-products with variants + pricing
   ↓
6. Present results with QA report
   → Mockup images + QA pass/fail + product URL if created

Dependencies

Dependency	Required	Purpose
`PRINTFUL_TOKEN` in .env	Yes	API authentication
`printful-api` skill	Yes (loaded)	API reference for all endpoints
`mockup-generator` skill	Yes (invoked)	Mockup generation
`merch-qa` skill	Yes (invoked)	Visual quality gate

Supported Products

Category	Examples	DPI Requirement
T-shirts	Bella+Canvas 3001, Comfort Colors 1717, Gildan 5000	150 DPI
Hoodies	Bella+Canvas 3719, Independent Trading	150 DPI
Sweatshirts	Comfort Colors 1566	150 DPI
Hats	Yupoong, Otto Cap	150 DPI
Stickers (kiss-cut)	3x3”, 4x4”, 5x5”	300 DPI
Tote bags	ATC Canvas	150 DPI

Garment Selection

See reference/garments.md for detailed blank recommendations. Quick guide:

Use Case	Recommended Blank	Base Cost
Budget events/giveaways	Gildan 5000	$2-3
Standard merch (best DTG)	Bella+Canvas 3001	$5-7
Premium feel	Comfort Colors 1717	$6-9

Pricing Guidance

Printful base cost + your markup = retail price. Common markups:

Product Type	Base Cost Range	Suggested Retail	Margin
Unisex tee	$5-9	$25-35	65-80%
Hoodie	$18-25	$45-60	55-65%
Kiss-cut sticker	$2.72-6.35	$4-8	30-50%

Integration

Routed by: merch-pimp for Printful/POD requests
Loads: printful-api reference skill for API details
Calls: mockup-generator with Printful provider
Calls: merch-qa with product_type=apparel_mockup (mandatory before delivery)