Documentazione

Per iniziare

Quick start

Aggiornata 2026-11-03

Quick start

Questa è la configurazione per sviluppatori. L'installer chiavi in mano è pianificato e non serve per esplorare il kit.

Requisiti

  • PHP 8.4 con le estensioni richieste dal framework
  • Composer 2
  • Node.js e npm (per gli asset di admin e web)
  • MySQL 8 (la suite di test usa SQLite)
  • Flutter 3.47+ e tooling Android solo se compili il client

Passi

Dalla radice dell'applicazione Laravel (composer/):

composer install
cp .env.example .env
php artisan key:generate

Crea un database MySQL vuoto e imposta la connessione in .env (DB_*). Poi:

php artisan migrate
php artisan theme:validate
php artisan theme:seed
php artisan storage:link
npm install
npm run build
php artisan serve

Apri http://127.0.0.1:8000.

Creare un utente admin

L'admin è Filament su /admin. Crea un utente con php artisan tinker:

use App\Models\User;
User::create([
    'name' => 'Operator',
    'email' => 'operator@example.com',
    'password' => bcrypt('change-me'),
]);

Attiva l'autenticazione a due fattori nell'admin dopo il primo accesso.

Verificare l'installazione

php artisan theme:validate
php artisan theme:preflight
php artisan migrate:status
php artisan kit:verify

Esplora

  • Web pubblico: / (web di gioco, o sito prodotto con PRODUCT_SITE_ENABLED=true)
  • Admin: /admin
  • Health API: /api/v1/health
  • Documentazione (modalità prodotto): /docs

Prossimi passi