# GS Loom Playground

## Testowanie bez wgrywania na serwer

GS Loom Playground uruchamia szablony z katalogu na Twoim komputerze we wspólnym rendererze GrowSite. Nie wymaga API ani bazy danych. Nie importuje motywu do katalogu produkcyjnego i nie publikuje zmian na stronach klientów.

## Uruchom podgląd

W katalogu głównym repozytorium GrowSite, po zainstalowaniu zależności poleceniem `npm ci`, uruchom:

```bash
npm run loom:playground
```

Następnie [otwórz GS Loom Playground](http://127.0.0.1:5180/__loom). Link prowadzi do Twojego komputera i działa, gdy powyższy proces jest uruchomiony. Samo otwarcie dokumentacji nie uruchamia procesu. Zatrzymasz go skrótem Ctrl+C w terminalu.

Domyślnie dostępne są GrowSite Skeleton, Paylio i Victorie Vending. Wybierz motyw, stronę i szerokość podglądu: dostępną przestrzeń, desktop 1440 px, tablet 768 px lub telefon 390 px. Przycisk ponownego uruchomienia pozwala ponownie obejrzeć animacje wejścia.

## Otwórz własny szablon

Podaj katalog rozpakowanej paczki GS Loom zawierający `loom.json`:

```bash
npm run loom:playground -- "/pełna/ścieżka/do/mojego-szablonu"
```

Możesz podać kilka katalogów rozdzielonych spacjami; każdy motyw musi mieć unikalny klucz. Podanie katalogów zastępuje domyślną listę trzech motywów. Gotowy przykład z dokumentacji uruchomisz tak:

```bash
npm run loom:playground -- dev-site/examples/launch-theme
```

Edytuj HTML, schema, słowniki i zasoby w katalogu wskazanym w Playground. Po zapisaniu plików podgląd odświeża się automatycznie. Błędy kompilacji są wyświetlane w podglądzie. Nie musisz wykonywać importu ani przebudowywać rejestru motywów.

## Dane demonstracyjne i pluginy

Playground korzysta z wartości demonstracyjnych i domyślnych motywu. Dla motywów sekcyjnych dostępny jest wybór języka oraz scenariuszy: standardowych danych, długiego tekstu i pustego bloga. Przełącznik pluginów pozwala porównać stronę z włączonymi i wyłączonymi integracjami demonstracyjnymi. Formularze symulują odpowiedź sukcesu — nie wysyłają maili i nie zapisują zgłoszeń.

Wybór języka korzysta ze słowników i mechanizmu fallback motywu. Nie tłumaczy automatycznie treści demo ani tekstu użytkownika. Motywy dokumentowe, takie jak Victorie Vending, wyświetlają oryginalne treści demonstracyjne; selektory języka i scenariusza są dla nich ukryte.

## Zakres podglądu

Sprawdź układ, responsywność, tła, typografię, animacje i wygląd formularzy. Zewnętrzne zasoby, na przykład fonty, mogą nadal wymagać internetu. Własne moduły JavaScript wymagające osobnej integracji z aplikacją nie są automatycznie rejestrowane przez wskazanie katalogu.

Zapis danych, rzeczywistą wysyłkę formularzy, uprawnienia i zachowanie pluginów z API sprawdź później w środowisku aplikacji. Kolejne kroki opisują [pierwszy szablon](/pl/quickstart/) i [wydanie paczki](/pl/release/).

## Zmiana portu

Serwer nasłuchuje wyłącznie na `127.0.0.1`. Jeśli port 5180 jest zajęty, zatrzymaj poprzedni proces lub ustaw inny port:

```bash
LOOM_PLAYGROUND_PORT=5181 npm run loom:playground
```

Wtedy otwórz adres `http://127.0.0.1:5181/__loom` zamiast domyślnego linku.