Skip to main content

​
What is Storefront Development?

Komerza lets you build fully custom storefronts using any web technology you prefer. Create your store with HTML, CSS, and JavaScript—or use frameworks like React, Vue, or Svelte—and host it directly on Komerza’s infrastructure. Your storefront imports the Komerza Client Library, a lightweight script that handles all the e-commerce functionality:
  • Store & Products - Fetch store info, products, variants, and reviews
  • Shopping Cart - Manage cart state, quantities, and selections
  • Checkout - Create orders and redirect to hosted payment pages
  • Analytics - Automatic tracking for views and conversions (no code required)

​
Why Build on Komerza?

Complete Design Freedom

No templates or themes to fight against. You control every pixel.

No Backend Required

The client library handles all API communication. Just HTML, CSS, and JS.

Instant Hosting

Deploy to Komerza infrastructure or list on the theme marketplace.

Fast Performance

Static files load instantly with global CDN delivery.

Enterprise-Grade DDoS Protection

Your storefront stays online under any load. Built on Cloudflare for unmatched resilience.

Automatic Backups

Every change and deployment is automatically backed up. Store up to 20 backups on selected plans to keep your storefront code safe.

​
Quick Example

<!DOCTYPE html>
<html>
  <head>
    <title>My Store</title>
    <script src="https://cdn.komerza.com/komerza.min.js"></script>
  </head>
  <body>
    <h1 id="store-name"></h1>
    <div id="products"></div>

    <script>
      komerza.init('your-store-id');

      // Load store and display products
      komerza.getStore().then(response => {
        if (!response.success) return;

        const store = response.data;
        document.getElementById('store-name').textContent = store.name;

        store.products.forEach(product => {
          const variant = product.variants[0];
          document.getElementById('products').innerHTML += \`
            <div class="product">
              <h2>\${product.name}</h2>
              <p>\${variant.cost}</p>
              <button onclick="komerza.addToBasket('\${product.id}', '\${variant.id}')">
                Add to Cart
              </button>
            </div>
          \`;
        });
      });
    </script>
  </body>
</html>

​
Theme Marketplace

Build storefronts that other Komerza merchants can use. Your templates can be:
  • Listed on the theme marketplace for other stores
  • Customized with configuration options
  • Deployed instantly by merchants
  • Monetized through the marketplace

​
Client Library vs API Reference

Client LibraryAPI Reference
ForCustomer storefrontsStore management
AuthPublic (store ID)Private (API keys)
RunsClient-side (browser)Server-side
OperationsBrowse, cart, checkoutFull CRUD, analytics
The client library is for customer-facing storefronts. For admin operations like creating products or managing orders, use the API Reference.

​
Get Started

Installation

Install the client library and initialize your store

Store Information

Fetch store details, logo, banner, and products

Basket Management

Add, remove, and manage cart items

Checkout

Process orders and handle payments