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

# Szablony

> Dziesięć gotowych stron sklepu open source (MIT) — wybierz, dopasuj i opublikuj.

Szablon to kompletny projekt strony sklepu: strona główna, lista produktów, karta produktu, koszyk i przejście do kasy. Wszystkie szablony są **open source na licencji MIT** ([repozytorium `itemshop-templates`](https://github.com/itemshop/itemshop-templates)) — możesz je zmieniać, kopiować i używać poza ItemShop.

Szablony różnią się wyłącznie wyglądem. Liczenie koszyka, bonusy pakietów, rabaty, dwie wymagane zgody w kasie, Turnstile, przekierowanie do bramki i śledzenie statusu zamówienia są wspólne i działają tak samo w każdym z nich. Produkty, ceny, metody płatności i widgety na żywo szablon pobiera ze [Storefront API](https://andcze.mintlify.site/pl/developers/storefront-api.md) — nie wpisujesz ich w kodzie.

## Wybór szablonu

**1. Otwórz galerię szablonów**

Przy tworzeniu strony (kreator albo **Workspace**) zobaczysz galerię z podglądem, opisem i wersją każdego szablonu.

**2. Kliknij Użyj szablonu**

ItemShop tworzy projekt strony z plików szablonu (rewizja nr 1) i buduje podgląd z Twoimi produktami.

**3. Dopasuj i opublikuj**

Zmień nazwę, logo, kolory i teksty w `src/site.config.ts` — w edytorze plików, prosząc [AI edytor](https://andcze.mintlify.site/pl/site/ai-editor.md) albo [własnego agenta](https://andcze.mintlify.site/pl/site/agents.md). Potem **Opublikuj**.

> [!WARNING]
>
> Wybór innego szablonu dla istniejącej strony tworzy nową rewizję z plikami nowego szablonu. Poprzednia wersja zostaje w historii rewizji i możesz do niej wrócić.

## Galeria

### Bento

![Bento](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/bento.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=45d831079b21cc6190a6d17d61ff1e50)

Domyślny sklep ItemShop: odważne kafelki, jasny i ciemny motyw, cel miesiąca, ostatnie zakupy i topka na żywo.

**Dla kogo:** Uniwersalny, na start — domyślny. `bento`

### Storefront

![Storefront](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/storefront.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=2e151fb2f28e421d2c93249f0fc1e7c6)

Uniwersalny sklep z produktami cyfrowymi (licencje, boty Discord, zasoby FiveM/Rust/Roblox, kursy, subskrypcje): kasa na jednym ekranie, a wszystko, co kupujesz, jest przepustką — karty produktów, kasa i potwierdzenie jako bilety z numerem seryjnym. Wyszukiwarka, filtry, strona produktu, jasny i ciemny motyw. Widgety serwerów gier opcjonalnie.

**Dla kogo:** Nie tylko Minecraft: produkty cyfrowe. `storefront`

### Portal

![Portal](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/portal.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=7abc480bea749eba6d4d839b8d7a32e5)

Klasyczna strona serwera ze sklepem: logo na środku nagłówka, hero z nazwą-echem, licznikiem graczy i renderem postaci, wybór trybu, aktualności, FAQ. Sklep trybu z kategoriami w panelu bocznym, osobna strona płatności. Jasny i ciemny motyw.

**Dla kogo:** Klasyczna strona serwera ze sklepem, wiele trybów. `portal`

### Arena

![Arena](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/arena.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=1ccc409948e3f752f6590cbfe49924b5)

Ciemny sklep PvP i gildii: rozmyty pikselowy zamek w hero z renderem postaci, „Skopiuj IP”, pasek ostatnich zakupów z główkami, kafle trybów z pikselowymi przedmiotami, karty rang z pikselowym logo, wstążką „Promocja” i osobną stroną płatności.

**Dla kogo:** PvP i gildie, ciemny. `arena`

### Vault

![Vault](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/vault.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=494289b4702b63457326bb216b59f23d)

Ciemny, premium sklep doładowań portfela: złote bokeh, hero z renderem na świetlistym okręgu i karta „Ile potrzebujesz doładować?” z kaflami kwot, bonusami i płatnością w tej samej karcie.

**Dla kogo:** Doładowania portfela, premium. `vault`

### Blocks

![Blocks](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/blocks.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=63131e72cc0685fa3badf0cf6839a42e)

Sieć serwerów z wieloma trybami: pełnoekranowy pikselowy krajobraz o zmierzchu, nazwa z emotkami, pigułki linków i duża siatka kafli trybów z pikselowymi blokami. Po wyborze trybu: kategorie, produkty z logo rang, ostatnie zakupy, cel miesiąca i topka; kasa w dużym oknie z kaflami płatności.

**Dla kogo:** Sieć serwerów z wieloma trybami. `blocks`

### Horizon

![Horizon](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/horizon.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=c885a64b142ebfda4847b36de9dd6e94)

Jasny, przyjazny sklep serwera MC: pływający nagłówek z licznikiem online, karta hero w kolorze marki z renderem na pasku statusu, kamienne „Skopiuj adres IP”, karty trybów z pikselowymi ikonami, podium topki i generowane logo rang.

**Dla kogo:** Jasny, przyjazny sklep serwera MC. `horizon`

### Wallet

![Wallet](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/wallet.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=b20b8c395cc1acf6b9f9f2864f45fc12)

Jasny, „fintechowy” sklep doładowań portfela (np. vPLN): karta doładowania z suwakiem i progami bonusu obok czterech kroków płatności, pasek doładowań na żywo, karta portfela w hero, gotowe pakiety, ranking wpłat jako pikselowe podium.

**Dla kogo:** Doładowania portfela w stylu fintech. `wallet`

### Arcade

![Arcade](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/arcade.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=25cff761e848461cb24be05701503984)

Jasny, pikselowo-retro sklep z koszykiem: kompaktowy ekran tytułowy automatu z HUD-em, produkty od razu pod nim, karty-kartridże na ekranikach, plansze trybów, tablica rekordów i jedna płatność za maks. 20 pozycji.

**Dla kogo:** Retro z koszykiem (wiele pozycji w jednej płatności). `arcade`

### Market

![Market](https://mintcdn.com/andcze/4Ez5zb9gOyIcqHY0/images/templates/market.png?fit=max\&auto=format\&n=4Ez5zb9gOyIcqHY0\&q=85\&s=343970979c52d2434c65829d3d1fd844)

Mocny, eventowy sklep z koszykiem: hero-plakat z odliczaniem eventu, adres serwera jako bilet, tryby z graczami online, kolorowe karty z metką ceny, szuflada koszyka i jedna płatność za wiele produktów.

**Dla kogo:** Eventowy sklep z koszykiem. `market`

Szablony **Arcade** i **Market** mają koszyk: kilka produktów (maks. 20 pozycji) kupujesz jedną płatnością. Pozostałe szablony sprzedają jedną pozycję naraz.

## Z terminala

```bash theme={null}
npx itemshop init moj-sklep --template horizon
```

Lista szablonów (`id`, nazwa, opis, podgląd, repozytorium, wersja) jest też dostępna przez API: `GET /templates`.

## Co jest w szablonie

```text theme={null}
itemshop.site.json      manifest (framework, build)
index.html
src/
  site.config.ts        nazwa, logo, kolory, linki, hero — zmieniasz najczęściej
  main.tsx
  App.tsx
  pages/ components/
  styles.css
package.json
```

`src/site.config.ts` to jedyny plik z wyglądem sklepu. Pola tekstowe przyjmują jeden napis albo mapę języków (brakujący język wraca do angielskiego, potem polskiego):

```ts src/site.config.ts theme={null}
export const siteConfig = defineSiteConfig<BentoConfig>({
  name: "",                       // pusty = nazwa z panelu
  logo: { text: "N", image: null },
  colors: { brand: "#d0423a", brandHover: "#b13530", accent: "#f5b942" },
  theme: { default: "light", toggle: true },
  hero: {
    title: { pl: "Sezon 7 już trwa!", en: "Season 7 is live!" },
    // …
  },
});
```

Pola wspólne dla wszystkich szablonów (`name`, `logo`, `colors`, `theme`, `serverAddress`, `nav`, `footer`, `languages`, `checkout`) są takie same, więc AI i agenci wiedzą, gdzie szukać. Sekcje specyficzne (hero, cel miesiąca, topka) różnią się między szablonami.

## Własny szablon

Szablon to zwykłe repozytorium z `itemshop.site.json`. Zasady zgłaszania szablonów do galerii opisuje `CONTRIBUTING.md` w repozytorium `itemshop-templates`.

> **[AI edytor](https://andcze.mintlify.site/pl/site/ai-editor.md)**
>
> Zmieniaj szablon rozmową.

> **[CLI](https://andcze.mintlify.site/pl/site/cli.md)**
>
> `npx itemshop init --template bento`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.