> ## 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.
# Instalacja i konfiguracja
> Zainstaluj bibliotekę klienta Komerza i zainicjalizuj swój sklep
## Instalacja
Dołącz bibliotekę klienta Komerza przez CDN. Dodaj ten tag skryptu do swojego HTML:
```html theme={null}
```
Biblioteka jest dostępna globalnie jako `globalThis.komerza` po załadowaniu skryptu.
### Korzyści CDN
* **Nie wymaga kroku budowania** - Działa z czystym HTML/CSS/JS
* **Zawsze aktualne** - Najnowsza wersja dostarczana automatycznie
* **Szybkie ładowanie** - Buforowane globalnie przez CDN
* **Lekkie** - Minimalny wpływ na czas ładowania strony
## Inicjalizacja
Zainicjalizuj bibliotekę swoim ID sklepu przed użyciem jakichkolwiek innych funkcji:
```javascript theme={null}
komerza.init("twoje-id-sklepu");
```
**Musisz** wywołać `init()` przed użyciem jakiejkolwiek innej funkcji
`komerza`. Wszystkie inne funkcje zakończą się niepowodzeniem, jeśli
biblioteka nie została zainicjalizowana.
### Znajdowanie ID swojego sklepu
ID Twojego sklepu jest dostępne w panelu Komerza. Jest to unikalny identyfikator Twojego sklepu, zazwyczaj w formacie UUID.
### Przykład
```html theme={null}
Mój Sklep
```
## Kiedy inicjalizować
Wywołaj `init()` raz przy ładowaniu strony, przed użyciem jakichkolwiek innych metod `komerza`:
**✅ Dobrze - Inicjalizuj przy ładowaniu strony:**
```javascript theme={null}
```
**❌ Źle - Używaj metod przed init:**
```javascript theme={null}
```
## Integracja z frameworkami
### Vanilla JavaScript
```html theme={null}
```
### React
```jsx theme={null}
import { useEffect } from "react";
function App() {
useEffect(() => {
// Inicjalizuj przy montowaniu komponentu
if (globalThis.komerza) {
globalThis.komerza.init("twoje-id-sklepu");
}
}, []);
return Mój Sklep
;
}
```
### Vue
```vue theme={null}
```
### Svelte
```svelte theme={null}
```