OpticWorks Store Overview

The OpticWorks store repo powers the e-commerce site and backend APIs.

Verified Summary

From opticworks-store/README.md:

• Storefront: Next.js 15 + React 19 + Tailwind 4
• Backend: Medusa v2 on PostgreSQL + Redis
• Payments: Stripe (deferred intent pattern)
• Fulfillment: EasyPost
• Hosting: Cloudflare Workers + Hetzner

Quick Start

pnpm install
pnpm run secrets:pull
pnpm run dev

Sources

• opticworks-store/README.md
• opticworks-store/docs/SECRETS.md

Diagrams

Store Topology

Browser -> optic.works (Workers)
   |            |
   |            +--> api.optic.works (Medusa)
   |                    |
   |                    +--> Postgres + Redis (Hetzner)
   |
Stripe + EasyPost -> Hookdeck -> webhooks

Deploy Flow

push main
   |
Cloudflare (storefront)
   |
Ansible (Medusa backend)

Checkout Flow (Simplified)

Cart -> Payment collection -> Stripe -> Order