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) — 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 — 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 albo własnego agenta. Potem Opublikuj.

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

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

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

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

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

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

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

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

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

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

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

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

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):

src/site.config.ts

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

Zmieniaj szablon rozmową.

CLI

npx itemshop init --template bento