Progressive Web App (PWA)

Il Carrubo è sviluppato con un approccio “Mobile First” e confezionato come Progressive Web App (PWA). Questo significa che l’applicazione web si comporta e si installa esattamente come un’app nativa da App Store o Play Store, ma senza dover passare per gli store ufficiali.

Vantaggi

  • Installazione in home screen: Icona rapida sullo smartphone.
  • Esperienza Standalone: L’app si apre senza la barra degli indirizzi di Safari/Chrome (Full screen).
  • Offline Cache: Le risorse statiche vengono messe in cache dal Service Worker, rendendo il caricamento quasi istantaneo.
  • Aggiornamenti automatici: Non devi aggiornare l’app manualmente; ricevi l’ultima versione ad ogni refresh.

Manifest Configuration

La configurazione risiede nel file public/manifest.json. Il colore del tema principale dell’app è #101118 (dark theme).

manifest.json
{
  "name": "Il Carrubo",
  "short_name": "Il Carrubo",
  "display": "standalone",
  "background_color": "#101118",
  "theme_color": "#101118"
}

Shortcuts Android/iOS

Abbiamo configurato delle “scorciatoie” (App Shortcuts) che appaiono tenendo premuto l’icona dell’app sulla schermata Home:

  1. Lista Prenotazioni → Apre /lista
  2. Nuova Prenotazione → Apre /inserisci
  3. Calendario → Apre /calendario
Android Asset Links

L’app include anche la validazione .well-known/assetlinks.json, che dimostra la paternità del dominio in ottica di Trusted Web Activity (utile se un giorno si decidesse di compilare in APK per il Play Store).