README

Laravel Realtime Starter è un pacchetto completo per avviare rapidamente progetti Laravel con:

• 🚀 Laravel Reverb per real-time WebSocket
• 🎨 Laravel Jetstream con Vue 3 + Inertia
• 🏗️ Pattern Architetturale Controller → Request → Service → Repository
• 🎯 Comandi Artisan per generare codice velocemente
• 💎 Componenti UI predefiniti con brand customizzabile
• ⚡ Ready-to-use setup completo in 5 minuti

🎯 Caratteristiche

Stack Tecnologico

• Laravel 12 - Framework PHP moderno
• Laravel Reverb - WebSocket server integrato
• Laravel Jetstream - Autenticazione e gestione team
• Vue 3 + Composition API - Frontend reattivo
• Inertia.js - SPA senza API
• TailwindCSS - Utility-first CSS
• Vite - Build tool velocissimo

Pattern Architetturale

Il pacchetto implementa il pattern Controller → Request → Service → Repository:

Request (Validazione)
    ↓
Controller (Coordinamento)
    ↓
Service (Business Logic)
    ↓
Repository (Database)

Vantaggi:

• ✅ Codice pulito e organizzato
• ✅ Facile da testare
• ✅ Riusabilità del codice
• ✅ Manutenibilità nel tempo
• ✅ Scalabilità del progetto

Comandi Artisan Inclusi

# Installa il pacchetto
php artisan realtime:install

# Genera CRUD completo
php artisan realtime:make:crud Post

# Genera feature completa
php artisan realtime:make:feature Chat --realtime

# Genera Service
php artisan realtime:make:service UserService --repository

# Genera Repository
php artisan realtime:make:repository UserRepository

📦 Installazione

Requisiti

• PHP >= 8.2
• Laravel >= 12.0
• Composer
• Node.js >= 18
• NPM o Yarn

Step 1: Installa il Pacchetto

composer require diegocopat/laravel-realtime-starter

Step 2: Esegui l'Installazione

php artisan realtime:install

Questo comando:

• ✅ Installa Laravel Jetstream con Vue 3 + Inertia
• ✅ Installa Laravel Reverb per WebSocket
• ✅ Configura Tailwind con i colori del brand
• ✅ Crea le directory per Services e Repositories
• ✅ Pubblica componenti UI predefiniti
• ✅ Configura .env per real-time
• ✅ Pubblica stubs per generazione codice

Step 3: Installa Dipendenze Frontend

npm install && npm run dev

Step 4: Avvia Reverb

In un terminale separato:

php artisan reverb:start

Step 5: Avvia Laravel

php artisan serve

Fatto! Vai su http://localhost:8000 🎉

🚀 Uso Rapido

Generare un CRUD Completo

php artisan realtime:make:crud Product

Questo crea:

• ✅ Product Model + Migration
• ✅ ProductRepository (queries database)
• ✅ ProductService (business logic)
• ✅ StoreProductRequest (validazione create)
• ✅ UpdateProductRequest (validazione update)
• ✅ ProductController (coordinamento)

Struttura Generata

app/
├── Models/
│   └── Product.php
├── Http/
│   ├── Controllers/
│   │   └── ProductController.php
│   └── Requests/
│       ├── StoreProductRequest.php
│       └── UpdateProductRequest.php
├── Services/
│   └── ProductService.php
└── Repositories/
    └── ProductRepository.php

📡 Real-Time Features

Generare Feature Real-Time

php artisan realtime:make:feature Chat --realtime

Questo crea tutto il CRUD base + Eventi e Listener per broadcasting.

🎨 Personalizzazione Brand

Colori Tailwind

Modifica config/realtime-starter.php:

'theme' => [
    'primary' => [
        '500' => '#your-primary-color',
        '600' => '#your-primary-dark',
        // ...
    ],
],

Logo

Sostituisci i file in public/images/:

• logo.svg
• favicon.png

📚 Comandi Disponibili

# Installazione
php artisan realtime:install              # Installa tutto
php artisan realtime:install --jetstream  # Solo Jetstream
php artisan realtime:install --reverb     # Solo Reverb
php artisan realtime:install --pest       # Aggiungi Pest

# Generazione Codice
php artisan realtime:make:crud Post
php artisan realtime:make:feature Chat --realtime
php artisan realtime:make:service UserService
php artisan realtime:make:repository UserRepository

🧪 Testing

php artisan test

📖 Documentazione

Vedi le guide complete per:

• Pattern architetturale dettagliato
• Real-time con Reverb
• Componenti UI
• Best practices

🤝 Contribuire

I contributi sono benvenuti! Vedi CONTRIBUTING.md

🛡️ Sicurezza

Segnala vulnerabilità a: info@connetrio.it

👨‍💻 Crediti

• Diego Copat - Connetrio
• Tutti i contributors

📄 Licenza

MIT License. Vedi LICENSE.md

💬 Supporto

• 📧 Email: info@connetrio.it
• 🐛 Issues: GitHub Issues

Made with ❤️ by Connetrio