Printful Store Sync

Environment and auth

Expect these variables when working on the integration:

• PRINTFUL_API_KEY or PRINTFUL_TOKEN
• PRINTFUL_STORE_ID
• PRINTFUL_WEBHOOK_SECRET
• CRON_SECRET
• NEXT_PUBLIC_SUPABASE_URL
• SUPABASE_SERVICE_ROLE_KEY

Typical workflow

1. Inspect the current sync and webhook route behavior.
2. Trace the shared helper in lib/printful.ts before adding new fetch logic.
3. Prefer additive changes that preserve current storefront and admin data.
4. Validate auth and signature checks for cron and webhook routes.
5. When product sync changes are involved, confirm the logic does not create fake business metadata.
6. If deployment is part of the task, verify the live production flow on https://tsgabrielle.us after deploy.

Good prompts

• Audit the Printful webhook security flow for tsgabrielle.
• Extend the Printful catalog sync without overwriting admin-managed fields.
• Help wire a new Printful product import path into the existing Supabase schema.