Case file · I·01

The issue
YOSI Archive home page: a full-bleed photo of vintage band tees under the YOSI ARCHIVE wordmark
Home01 / 07

I·01 · Live

YOSI ARCHIVE

“Every piece is one of one, so the store is built around it.”
Role
Independent Technical Consultant & Developer
Year
2026
Discipline
Headless Commerce · Client Consulting
Stack
Next.js · React · TypeScript · Tailwind CSS · Shopify Storefront API · GraphQL · Vercel

YOSI Archive sells one-of-one vintage and archival pieces through Instagram drops; sales used to run through DMs. I built it a storefront of its own: a brutalist Next.js front end on Vercel, with Shopify handling products, inventory, payments and checkout through the Storefront API. Scoped, built and launched on a custom domain on October 10, 2026, as an independent client engagement.

System notes

  1. Headless architecture

    A server-only GraphQL client reads products from the Shopify Storefront API, so the access token never reaches the browser. The catalog uses incremental revalidation, so new and sold pieces update within about a minute without a redeploy.

  2. Built for one-of-ones

    Quantity is locked to one, sold pieces stamp SOLD and can't be added, and a piece that sells while it sits in someone's bag is caught before checkout. The bag runs on Shopify's Cart API through server actions, with the cart ID in an httpOnly cookie.

  3. Shareable product drawer

    Intercepting and parallel routes open a piece in a quick-view drawer inside the catalog, while a shared link lands on a full, statically generated product page with its own preview image.

  4. Launch

    Before launch, a real-card test order was paid, refunded and verified end to end: the SOLD flip, the confirmation email and the admin order. Checkout stays Shopify's, with Shop Pay, PayPal, Google Pay, Venmo and local pickup; hosting costs nothing per month.