> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Créez des modèles de boutique personnalisés avec la bibliothèque client Komerza

## Qu'est-ce que le développement de boutique ?

Komerza vous permet de créer des boutiques entièrement personnalisées en utilisant la technologie web de votre choix. Créez votre boutique avec HTML, CSS et JavaScript—ou utilisez des frameworks comme React, Vue ou Svelte—et hébergez-la directement sur l'infrastructure de Komerza.

Votre boutique importe la **bibliothèque client Komerza**, un script léger qui gère toutes les fonctionnalités e-commerce :

* **Boutique & Produits** - Récupérez les infos de la boutique, les produits, variantes et avis
* **Panier** - Gérez l'état du panier, les quantités et les sélections
* **Paiement** - Créez des commandes et redirigez vers des pages de paiement hébergées
* **Analyses** - Suivi automatique des vues et conversions (aucun code requis)

## Pourquoi construire sur Komerza ?

<CardGroup cols={2}>
  <Card title="Liberté de design complète" icon="palette">
    Pas de modèles ni de thèmes à combattre. Vous contrôlez chaque pixel.
  </Card>

  <Card title="Pas de backend requis" icon="code">
    La bibliothèque client gère toutes les communications API. Juste HTML, CSS
    et JS.
  </Card>

  <Card title="Hébergement instantané" icon="rocket">
    Déployez sur l'infrastructure Komerza ou listez sur la marketplace de
    thèmes.
  </Card>

  <Card title="Performance rapide" icon="bolt">
    Les fichiers statiques se chargent instantanément avec une livraison CDN
    mondiale.
  </Card>

  <Card title="Protection DDoS de niveau entreprise" icon="shield-halved">
    Votre boutique reste en ligne sous n'importe quelle charge. Construit sur
    Cloudflare pour une résilience inégalée.
  </Card>

  <Card title="Sauvegardes automatiques" icon="clock-rotate-left">
    Chaque modification et déploiement est automatiquement sauvegardé. Stockez
    jusqu'à 20 sauvegardes sur les plans sélectionnés.
  </Card>
</CardGroup>

## Exemple rapide

```html theme={null}
<!DOCTYPE html>
<html>
  <head>
    <title>Ma Boutique</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('votre-id-boutique');

      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}')">
                Ajouter au panier
              </button>
            </div>
          \`;
        });
      });
    </script>
  </body>
</html>
```

## Marketplace de thèmes

Créez des boutiques que d'autres marchands Komerza peuvent utiliser. Vos modèles peuvent être :

* Listés sur la marketplace de thèmes pour d'autres boutiques
* Personnalisés avec des options de configuration
* Déployés instantanément par les marchands
* Monétisés via la marketplace

## Bibliothèque client vs Référence API

|                | Bibliothèque client        | Référence API          |
| -------------- | -------------------------- | ---------------------- |
| **Pour**       | Boutiques pour clients     | Gestion de la boutique |
| **Auth**       | Public (ID boutique)       | Privé (clés API)       |
| **Exécution**  | Côté client (navigateur)   | Côté serveur           |
| **Opérations** | Parcours, panier, paiement | CRUD complet, analyses |
