All work

Web App — 2023 — Present

Compatio SB3 / Guide.

Multi-tenant, embeddable e-commerce product configurator serving enterprise storefronts across four commerce platforms.

ReactTypeScriptApollo GraphQLPreactWebpack / CRACOSCSSJest + RTLGA4ShopifyMagentoBigCommerceOptimizely

Role

Lead Full Stack Developer — Sole Architect

Timeline

2023 — Present · 2+ years

Team

Sole architect (~95% of codebase)

Type

Web App

01

The Problem

Enterprise retailers run storefronts on Shopify, Magento, BigCommerce, and Optimizely — each with different APIs, auth models, and cart semantics. Compatio needed a product-configurator widget that embeds into any of them, handles per-client customization without redeploys, and stays fast enough to ship inside someone else's page.

02

What I Built

I designed the full request path from embedded widget to backend: a config-driven, container-based UI builder on the front end, an Apollo GraphQL + REST integration layer, and platform middleware that normalizes all four storefront APIs behind one interface. A ServiceWrapper abstraction handles model-spec fetching, price-engine calls, and per-instance session provisioning, while AuthManager manages multi-source token retrieval and platform-specific auth (Optimizely bill-to/ship-to headers, token-expiry re-login flows). A JavaScript middleware system plus admin-panel integration lets each client customize runtime behavior with zero redeploys.

03

The Outcome

In production for multiple enterprise clients. A multi-phase performance overhaul — React context split into independently-memoized slices, O(n) scans replaced with O(1) Set/Map lookups on hot paths, and sub-50KB entry-point budgets enforced via code-splitting, lazy themes, and Preact substitution — keeps the embedded bundle lean. An end-to-end GA4 pipeline gives clients conversion attribution down to widget and recommender instance.

— Architecture

The request path, from embedded widget to backend

  1. Host storefront page

    The widget is embedded in someone else's store, on any of four commerce platforms.

    ShopifyMagentoBigCommerceOptimizely
    embeds
  2. Configurator widget

    A container-based, config-driven UI held to a sub-50 KB entry bundle via code-splitting, lazy themes and Preact. The admin panel and a JavaScript middleware system change per-client behaviour at runtime — no redeploy.

    splits into two paths
  3. Data & pricing — Apollo GraphQL + REST

    ServiceWrapper is the single client for model-spec fetching, price-engine calls and per-instance session provisioning against the Compatio backend.

    in parallel
  4. Cart & catalog — platform middleware

    One interface over all four storefront APIs, with AuthManager handling multi-source tokens and re-login on expiry. Writes variant-aware SKU + quantity payloads into the host cart and checkout.

    both paths emit
  5. GA4 event pipeline

    Widget and recommender instance IDs are carried through to conversion attribution.

The configurator ships inside somebody else's storefront, so the request path splits in two: Compatio's own data path over Apollo GraphQL and REST, and the platform middleware that hides the differences between four storefront APIs behind a single interface. Per-client behaviour is configured at runtime rather than redeployed.
04

Key Decisions & Challenges

01

Platform middleware unifying Shopify, Magento, BigCommerce & Optimizely cart, checkout, and catalog APIs — including variant-aware SKU+quantity payloads and platform-specific cart-sync event bridges.

02

AuthManager abstraction for multi-source token retrieval and per-platform auth quirks, including token-expiry re-login flows.

03

Sub-50KB entry budgets via Webpack code-splitting, lazy-loaded themes, and Preact substitution for embedded builds.

04

JavaScript middleware system enabling per-client runtime customization without redeploys.

05

Owned the staged release pipeline (release → stage → prod-stage → prod) with bundle-analysis gates on dependency changes.

06

Established the testing strategy (Jest + RTL) and a semantic SCSS architecture enabling no-code client theming.

Have a project in mind?

I'm open to freelance work and full-time roles. Let's talk about what we could build together.

Get in touch