Skip to content
ecommerce

Shareable Product Configurator

Built a step-by-step product configurator on a Shopware storefront with URL-serialized state, PDF export and editable share links

Client
Sports-Equipment Retailer
Duration
Ongoing
Year
2026
Category
ecommerce

Key Results

Customers can configure a custom product, share it by link or PDF, and edit a shared configuration, with tests covering the share, edit and PDF flows.

URL-based
Share State
whole configuration restored from a ?cfg= parameter
Server-side
PDF Export
cached privately, keyed on shop context and configuration
Built
Edit Shared
URL follows edits without extra analytics page views
Tested
Verification
unit tests plus browser checks and stage testing

Technologies Used

ShopwareNuxtVueTypeScriptPHPDompdfRedis

Challenges

  • Sharing state with people who have no session
  • Shared links outliving assets such as an uploaded logo
  • Untrusted input in the URL and in the PDF endpoint
  • Letting users edit a shared configuration without breaking reload and share consistency

Solutions

  • Serialized choices into a size-capped URL parameter and referenced assets by media id
  • Dedicated logo endpoint and an explicit "logo unavailable" state
  • Validated decoded input like a request body and stripped unknown cfg keys from cart line items
  • Debounced history.replaceState sync that keeps other query parameters and avoids router navigations

Overview

Implemented a custom-product configurator for a sports-equipment retailer's Shopware storefront, starting from a Confluence concept. The full configuration lives in a ?cfg= URL parameter, so it survives reloads, can be shared, and is exported as a server-rendered PDF. After stage testing I added editing of shared configurations, including keeping the URL in sync without inflating analytics page views. The entry landing page was assembled from existing CMS elements and reproduced via a migration.