Praca lokalna

Instalację i konfigurację .env opisują Pierwsze kroki.

Uruchamianie

composer dev

Skrypt uruchamia równolegle php artisan serve, queue:listen --tries=1, podgląd logów (pail), Vite motywu (npm run dev) oraz dev server panelu (npm run dev --prefix resources/js/cms).

Po starcie:

Adres	Co tam jest
http://127.0.0.1:8000	witryna
http://127.0.0.1:8000/cms	zbudowany panel z public/cms
http://127.0.0.1:9000/cms/	dev server panelu z HMR

composer dev nie ma przełącznika pomijającego panel. Jeśli panel nie jest zainstalowany (brak resources/js/cms), uruchom php artisan mb:install-cms albo startuj pozostałe procesy osobno.

Komendy motywu

Uruchamiane z głównego katalogu projektu:

npm run dev         # Vite i HMR
npm run build       # build klienta
npm run build:ssr   # build klienta i bundle SSR
npm run ssr         # serwer SSR (po build:ssr)
npm run types:check # sprawdzenie typów TypeScript
npm run check       # lint i formatowanie
npm run check:fix   # lint i formatowanie z automatyczną poprawą

Panel ma osobny package.json w resources/js/cms. Nie instaluj jego zależności do głównego package.json; komendy panelu uruchamiaj z jego katalogu albo z --prefix resources/js/cms.

SSR lokalnie

O użyciu SSR decyduje Laravel, a nie Vite, więc zmienna musi trafić do .env:

1. Ustaw INERTIA_SSR_ENABLED=true w .env.
2. Wykonaj php artisan config:clear.
3. Uruchom npm run dev.

W trybie deweloperskim renderowanie obsługuje plugin Inertia dla Vite, bez osobnego procesu Node. Szczegóły i wariant produkcyjny: SSR i scheduler.

Dane demo

php artisan cms:demo
php artisan cms:demo --force   # bez pytania o potwierdzenie

Komenda kasuje treści

cms:demo przed wgraniem zestawu demonstracyjnego usuwa wszystkie strony, artykuły i kategorie bloga, FAQ, opinie, slidery, menu, teksty statyczne oraz ustawienia. Nie uruchamiaj jej na bazie z danymi do zachowania.

Seedery demo tworzą tłumaczenia dla każdego języka z SITE_LOCALES. Trzy bazowe kategorie zgód cookies pochodzą z migracji, więc istnieją także bez danych demo.

Pobranie środowiska z hostingu

php artisan mb:sync-remote            # baza i pliki
php artisan mb:sync-remote --db       # tylko baza
php artisan mb:sync-remote --files    # tylko pliki
php artisan mb:sync-remote --dry-run  # pokazuje plan i kończy bez zmian

Kierunek jest zawsze zdalny → lokalny: na serwerze nic się nie zmienia, a lokalna baza zostaje nadpisana. Dostęp do serwera komenda bierze z phploy.ini, dane bazy ze zdalnego .env, a zdalną domenę w danych podmienia na lokalne APP_URL. Opcje i szczegóły: Modules/Moonsync/README.md w repozytorium.

Kolejka

composer dev uruchamia worker kolejki, ale sterownik wybiera QUEUE_CONNECTION w .env (domyślnie database).