Can I vibe code Returnly?

Build a headless Shopify Returns Portal using Remix, TypeScript, Tailwind CSS, and the Shopify GraphQL Admin API (version 2024-01 or later).

CORE REQUIREMENTS:
1. Customer Authentication & Lookup:
   - Allow shoppers to authenticate using Order Number (#1001) and Zip Code or Email.
   - Fetch the order details via the Shopify Admin GraphQL API (`order` query).
   - Enforce a configurable return window (e.g., 30 days from order fulfillment date). Block items marked as final sale (`lineItem.customAttributes` or tagged `final-sale`).

2. Return Workflow & Exchange Logic:
   - Display eligible line items with quantity selectors, return reason dropdowns (e.g., "Too Small", "Defective", "Changed Mind"), and photo upload capabilities for damaged goods (upload to AWS S3 or Supabase Storage).
   - Offer three resolution pathways:
     a) Instant Store Credit (generate a Shopify Gift Card or Customer Credit using `discountCodeBasicCreate` or `giftCardCreate`).
     b) Variant Exchange (fetch available product variants for the same product ID via GraphQL; if in stock, allow 1-click swap).
     c) Refund to Original Payment Method (calculate restock fees if enabled).

3. Shipping Label Generation:
   - Integrate the EasyPost API (`/v2/shipments`).
   - Upon return submission, create a return shipment using pre-configured merchant warehouse address and shopper shipping address.
   - Return a printable PDF shipping label URL and tracking number to the shopper, and send a confirmation email via Resend/SendGrid.

4. Admin Webhook Listener & State Machine:
   - Expose a webhook endpoint `/api/webhooks/easypost` to listen for carrier scan events (`tracker.updated`).
   - When the shipment status transitions to `in_transit` or `delivered`:
     - Update the Shopify Return object status using `returnApprove` / `returnReopen`.
     - Automatically trigger store credit issuance or variant order creation (`draftOrderCreate` + `draftOrderComplete`) upon the first carrier scan.

OUT OF SCOPE:
- Financial underwriting/risk scoring engines for unreturned items.
- Physical Return Bar / drop-off location network integrations.
- Multi-currency cross-border tax recalculation.

DATA MODELS:
- ReturnRequest: id, order_id, customer_id, line_items (json), status (pending, approved, label_generated, scanned, refunded), resolution_type (credit, exchange, refund), tracking_code, label_url.
- ReturnPolicy: merchant_id, return_window_days, allow_exchanges, restocking_fee_cents, auto_approve_threshold_cents.

FAILURE MODES TO HANDLE:
- Partial returns where only 1 out of 3 items in an order is returned.
- Shopify API rate limiting (implement exponential backoff for GraphQL queries).
- Carrier label generation failures (fallback to manual admin review flag).

$ each button prefixes agent-specific run instructions · build your own product, never copy proprietary code, trademarks or designs