Webshop

Exploratory beta storefront, being replaced by store-rebuild.

Stack

Next.js 16 · React 19 · Square SDK · Drizzle ORM · PostgreSQL · Sacred design system · PostHog · Railway

Architecture

Square is source of truth. Postgres caches catalog data for fast reads. Server-side API routes protect Square credentials.

Browser → Next.js (Railway) → Square APIs (catalog, inventory, orders, payments)
              ↕
         PostgreSQL (cache, sessions, events)

Design

Terminal-inspired minimalist aesthetic using Sacred component library. Monospace typography (GeistMono), warm dark palette (deep charcoal #221f1d, cream #ece3d0, golden yellow #f7d256).

Why It’s Being Replaced

• No customer accounts or wishlists
• No CMS for editorial content
• Heavy frontend lift for every feature (no pre-built storefront)
• Cart sessions only (no persistent state)
• Manual sync trigger needed (no webhooks)
• See saleor-vs-medusa for the full evaluation

Preservation Notes

The webshop/docs/ directory contains valuable architecture explorations:

• medusa-exploration.md — Medusa v2 feasibility analysis
• saleor-vs-medusa-exploration.md — comprehensive platform comparison (initial analysis; superseded by platform-eval-comparison)