> ## 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.

# Wprowadzenie

> Twórz niestandardowe szablony sklepu z biblioteką klienta Komerza

## Czym jest rozwój sklepu internetowego?

Komerza pozwala tworzyć w pełni niestandardowe sklepy internetowe przy użyciu dowolnej preferowanej technologii webowej. Twórz swój sklep w HTML, CSS i JavaScript—lub używaj frameworków takich jak React, Vue lub Svelte—i hostuj go bezpośrednio na infrastrukturze Komerza.

Twój sklep importuje **Bibliotekę Klienta Komerza**, lekki skrypt obsługujący wszystkie funkcje e-commerce:

* **Sklep i Produkty** - Pobieranie informacji o sklepie, produktach, wariantach i recenzjach
* **Koszyk** - Zarządzanie stanem koszyka, ilościami i wyborami
* **Płatność** - Tworzenie zamówień i przekierowanie na hostowane strony płatności
* **Analityka** - Automatyczne śledzenie wyświetleń i konwersji (bez kodu)

## Dlaczego budować na Komerza?

<CardGroup cols={2}>
  <Card title="Pełna swoboda projektowania" icon="palette">
    Żadnych szablonów ani motywów do walki. Kontrolujesz każdy piksel.
  </Card>

  <Card title="Brak backendu" icon="code">
    Biblioteka klienta obsługuje całą komunikację API. Tylko HTML, CSS i JS.
  </Card>

  <Card title="Natychmiastowy hosting" icon="rocket">
    Wdróż na infrastrukturę Komerza lub umieść na rynku motywów.
  </Card>

  <Card title="Szybka wydajność" icon="bolt">
    Pliki statyczne ładują się natychmiastowo z globalną dostawą CDN.
  </Card>

  <Card title="Ochrona DDoS klasy enterprise" icon="shield-halved">
    Twój sklep pozostaje online przy dowolnym obciążeniu. Zbudowany na
    Cloudflare dla niezrównanej odporności.
  </Card>

  <Card title="Automatyczne kopie zapasowe" icon="clock-rotate-left">
    Każda zmiana i wdrożenie są automatycznie archiwizowane. Przechowuj do 20
    kopii zapasowych na wybranych planach.
  </Card>
</CardGroup>

## Szybki przykład

```html theme={null}
<!DOCTYPE html>
<html>
  <head>
    <title>Mój Sklep</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('twoje-id-sklepu');

      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}')">
                Dodaj do koszyka
              </button>
            </div>
          \`;
        });
      });
    </script>
  </body>
</html>
```

## Rynek motywów

Twórz sklepy, z których mogą korzystać inni sprzedawcy Komerza. Twoje szablony mogą być:

* Udostępniane na rynku motywów dla innych sklepów
* Dostosowywane opcjami konfiguracji
* Wdrażane natychmiastowo przez sprzedawców
* Zarabiające poprzez rynek

## Biblioteka klienta vs Dokumentacja API

|              | Biblioteka klienta             | Dokumentacja API      |
| ------------ | ------------------------------ | --------------------- |
| **Dla**      | Sklepy dla klientów            | Zarządzanie sklepem   |
| **Auth**     | Publiczne (ID sklepu)          | Prywatne (klucze API) |
| **Działa**   | Po stronie klienta             | Po stronie serwera    |
| **Operacje** | Przeglądanie, koszyk, płatność | Pełny CRUD, analityka |
