docs: aggiunto README.md con istruzioni

README.md

@@ -0,0 +1,48 @@
+# CantiCristiani PWA
+
+Applicazione PWA moderna per la gestione di canti, accordi e karaoke integrato. Progettata per musicisti e cantanti per un uso fluido durante le celebrazioni o i momenti di preghiera.
+
+## Caratteristiche Principali
+
+- 🎤 **Karaoke Intelligente**: Avanzamento automatico del testo basato sul rilevamento vocale (microfono).
+- 🎚️ **Sensibilità Dinamica**: Regolazione in tempo reale della sensibilità del microfono tramite slider verticale custom (50% - 100%).
+- 🎼 **Accordi e Trasporto**: Visualizzazione accordi con possibilità di trasporto tonale istantaneo.
+- 📋 **Gestione Playlist**: Creazione, modifica e condivisione di playlist tramite QR Code.
+- 📱 **PWA Ready**: Installabile su Android e iOS come app nativa, con supporto offline.
+- 🔆 **Schermo Sempre Acceso**: Opzione dedicata nelle impostazioni per evitare lo spegnimento dello schermo durante l'uso.
+- 🔍 **Ricerca Rapida**: Filtri avanzati per categorie, tonalità e playlist.
+
+## Tecnologie Utilizzate
+
+- **Framework**: Ionic + Angular
+- **State Management**: Angular Signals
+- **PWA**: @angular/pwa
+- **API**: Screen Wake Lock API, Media Session API
+
+## Installazione e Sviluppo
+
+### Prerequisiti
+- Node.js (v18+)
+- Ionic CLI
+
+### Comandi Locali
+```bash
+npm install
+ionic serve
+```
+
+## Deploy
+
+Per distribuire l'applicazione in produzione (ambiente locale o server FTP):
+
+```bash
+./deploy_pwa.sh
+```
+
+Lo script si occupa di:
+1. Incrementare la versione dell'app.
+2. Eseguire la build di produzione.
+3. Distribuire i file nella cartella di distribuzione locale.
+
+---
+© 2026 CantiCristiani.it