> ## 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.
# Instalación y configuración
> Instala la biblioteca cliente de Komerza e inicializa tu tienda
## Instalación
Incluye la biblioteca cliente de Komerza via CDN. Agrega esta etiqueta de script a tu HTML:
```html theme={null}
```
La biblioteca está disponible globalmente como `globalThis.komerza` después de que se cargue el script.
### Beneficios del CDN
* **No requiere paso de compilación** - Funciona con HTML/CSS/JS simple
* **Siempre actualizado** - Última versión entregada automáticamente
* **Carga rápida** - Almacenado en caché globalmente via CDN
* **Ligero** - Impacto mínimo en el tiempo de carga de la página
## Inicialización
Inicializa la biblioteca con el ID de tu tienda antes de usar otras funciones:
```javascript theme={null}
komerza.init("tu-id-de-tienda");
```
**Debes** llamar a `init()` antes de usar cualquier otra función de `komerza`.
Todas las demás funciones fallarán si la biblioteca no ha sido inicializada.
### Encontrar tu ID de tienda
El ID de tu tienda está disponible en tu panel de Komerza. Es un identificador único para tu tienda, generalmente en formato UUID.
### Ejemplo
```html theme={null}
Mi Tienda
```
## Cuándo inicializar
Llama a `init()` una vez cuando se carga tu página, antes de usar otros métodos de `komerza`:
**✅ Bien - Inicializar al cargar la página:**
```javascript theme={null}
```
**❌ Mal - Usar métodos antes de init:**
```javascript theme={null}
```
## Integración con frameworks
### JavaScript Vanilla
```html theme={null}
```
### React
```jsx theme={null}
import { useEffect } from "react";
function App() {
useEffect(() => {
// Inicializar cuando el componente se monta
if (globalThis.komerza) {
globalThis.komerza.init("tu-id-de-tienda");
}
}, []);
return Mi Tienda
;
}
```
### Vue
```vue theme={null}
```
### Svelte
```svelte theme={null}
```