orican-printify

Backend for the ORICAN tee customizer. Printify's API rejects browser requests, so every Printify call goes through these Vercel functions and the token stays in Vercel.

Endpoints

Endpoint	Who calls it	What it does
GET / or /admin	you (browser)	Operations Command Center: Bold black-and-white admin dashboard for live pipeline monitoring, order simulations, blanks & mockup explorer, and theme patching.
GET /api/catalog	you (x-admin-key)	Read-only: Printify shops + EU providers for candidate blanks.
POST /api/setup	you (x-admin-key)	Creates/reuses one unpublished draft per blank in Printify shop 7881083; returns variant mapping, costs, mockups. GET = report only.
POST /api/upload	storefront	Issues a Vercel Blob client-upload token for the design PNG (PNG only, max 40 MB, designs/).
POST /api/shopify-order	Shopify webhook	On "Order payment", sends ORICAN line items (SKU PFY-… + _design_url property) to Printify. Orders wait for your approval in Printify unless AUTO_PRODUCTION=true.
GET/POST /api/models	storefront (GET) / you (POST)	3D model catalogue in Blob under models/<slug>/. GET lists it publicly; POST issues admin upload tokens or deletes a model. Managed from the dashboard's 3D Models tab.
GET /api/status	you (x-admin-key)	Real-time environment checklist and recent webhook fulfillment runs.
POST /api/test-order	you (x-admin-key)	Simulates full order pipeline with placeholder design in Paris.
POST /api/theme-build	you (x-admin-key)	Validates and compiles patched Shopify Liquid layout into Vercel Blob.

Environment variables

Name	Value
PRINTIFY_TOKEN	Printify personal access token
ADMIN_KEY	Your own random string (admin endpoints)
BLOB_READ_WRITE_TOKEN	Added automatically when you connect a Blob store (Storage tab → Create → Blob → connect to this project)
ALLOWED_ORIGINS	https://orican-41i0abev.myshopify.com (+ your custom domain later, comma-separated)
SHOPIFY_WEBHOOK_SECRET	Signing secret from Shopify admin → Settings → Notifications → Webhooks
AUTO_PRODUCTION	Optional. true to send orders straight to production

Commands (PowerShell)

npm install
vercel env add ALLOWED_ORIGINS production
vercel deploy --prod

# run setup (creates the Printify drafts) and save the report
$h = @{ "x-admin-key" = "<ADMIN_KEY>" }
Invoke-RestMethod -Method Post -Uri "https://orican-printify.vercel.app/api/setup" -Headers $h -TimeoutSec 180 |
  ConvertTo-Json -Depth 10 | Out-File setup.json -Encoding utf8

Shopify webhook

Shopify admin → Settings → Notifications → Webhooks → Create webhook: event Order payment, format JSON, URL https://orican-printify.vercel.app/api/shopify-order. Copy the signing secret shown on that page into SHOPIFY_WEBHOOK_SECRET, then redeploy.