Web App — 2023 — Present
Compatio SB3 / Guide.
Multi-tenant, embeddable e-commerce product configurator serving enterprise storefronts across four commerce platforms.
Role
Lead Full Stack Developer — Sole Architect
Timeline
2023 — Present · 2+ years
Team
Sole architect (~95% of codebase)
Type
Web App
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.
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.
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
Host storefront page
The widget is embedded in someone else's store, on any of four commerce platforms.
ShopifyMagentoBigCommerceOptimizelyembedsConfigurator 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 pathsData & 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 parallelCart & 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 emitGA4 event pipeline
Widget and recommender instance IDs are carried through to conversion attribution.
Key Decisions & Challenges
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.
AuthManager abstraction for multi-source token retrieval and per-platform auth quirks, including token-expiry re-login flows.
Sub-50KB entry budgets via Webpack code-splitting, lazy-loaded themes, and Preact substitution for embedded builds.
JavaScript middleware system enabling per-client runtime customization without redeploys.
Owned the staged release pipeline (release → stage → prod-stage → prod) with bundle-analysis gates on dependency changes.
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