Skip to main content

Webround

Webround is an API-first headless platform for e-commerce and websites.

It supports two development modes:

  • No-code — visual editor for non-technical users
  • Custom React code — full React components injected into the runtime as Web Components

For anything not covered here, refer to the full documentation: https://docs.webround.com


Core concepts

Draft — the base project. A draft is where you configure design, pages, translations, custom code and the starting point for your e-commerce. Publishing a draft deploys it to a global CDN.

Store — the headless commerce entity linked to the draft. Holds all transactional and catalog data (products, orders, customers, checkout). A draft is natively linked to a store, and you always generate a store from a draft, but the two systems are independent and communicate via standardized APIs.


Architecture

  • Runtime — React + Vite application that interprets JSON configurations for no-code sections and mounts custom Web Components when displaying React code.
  • Commerce Engine — handles products, variants, pricing, tax, orders, checkout, and customer auth
  • Edge Router — serves the deployed site, executes page hooks and checkout hooks

Extensibility

  • Custom React components — inject frontend logic via the WR SDK (wr prop)
  • Checkout Hooks — server-side middleware to recalculate prices, taxes, or integrate external systems at checkout
  • Page Hooks — inject dynamic data or scripts before page rendering
  • Webhooks — notify external systems (ERP, CRM) on events like new orders or signups
  • App Extensions — extend the Webround admin panel with custom tools