> ## 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.
# Installation et configuration
> Installez la bibliothèque client Komerza et initialisez votre boutique
## Installation
Incluez la bibliothèque client Komerza via CDN. Ajoutez cette balise script à votre HTML :
```html theme={null}
```
La bibliothèque est disponible globalement en tant que `globalThis.komerza` après le chargement du script.
### Avantages du CDN
* **Aucune étape de build requise** - Fonctionne avec du HTML/CSS/JS simple
* **Toujours à jour** - Dernière version livrée automatiquement
* **Chargement rapide** - Mis en cache mondialement via CDN
* **Léger** - Impact minimal sur le temps de chargement de la page
## Initialisation
Initialisez la bibliothèque avec l'ID de votre boutique avant d'utiliser toute autre fonction :
```javascript theme={null}
komerza.init("votre-id-boutique");
```
Vous **devez** appeler `init()` avant d'utiliser toute autre fonction
`komerza`. Toutes les autres fonctions échoueront si la bibliothèque n'a pas
été initialisée.
### Trouver votre ID de boutique
L'ID de votre boutique est disponible dans votre tableau de bord Komerza. C'est un identifiant unique pour votre boutique, généralement au format UUID.
### Exemple
```html theme={null}
Ma Boutique
```
## Quand initialiser
Appelez `init()` une fois au chargement de votre page, avant d'utiliser toute autre méthode `komerza` :
**✅ Bien - Initialisation au chargement de la page :**
```javascript theme={null}
```
**❌ Mal - Utiliser des méthodes avant init :**
```javascript theme={null}
```
## Intégration avec les frameworks
### JavaScript Vanilla
```html theme={null}
```
### React
```jsx theme={null}
import { useEffect } from "react";
function App() {
useEffect(() => {
// Initialiser au montage du composant
if (globalThis.komerza) {
globalThis.komerza.init("votre-id-boutique");
}
}, []);
return Ma Boutique
;
}
```
### Vue
```vue theme={null}
```
### Svelte
```svelte theme={null}
```