From ff992daa58f7e02be4b221d2dc8d3049b9b33d3b Mon Sep 17 00:00:00 2001
From: David Frassi <d.frassi@estar.toscana.it>
Date: Sat, 16 May 2026 17:26:46 +0200
Subject: [PATCH] docs: aggiunto README.md con istruzioni

---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7f1dd74
--- /dev/null
+++ b/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