diff --git a/README.md b/README.md
index 6c40a3c..8b73090 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,76 @@
-# myip WebApp Modern UI
+# 🌐 myip – IP & RIPE Lookup WebApp
 
-Include Montserrat, animations, copy-IP button, favicon.
+myip è una webapp minimale e containerizzata che mostra:
+
+- il **tuo IP pubblico**
+- informazioni RIPE utili (ASN, Provider/Holder, Prefisso annunciato)
+- UI moderna e responsiva
+- pulsante **Copia IP**
+- integrazione con ingress-nginx e PROXY protocol
+- design personalizzabile tramite CSS dedicato
+
+Pensata per essere deployata come micro-servizio in Kubernetes.
+
+---
+
+## ✨ Screenshot
+
+> *(sostituire con screenshot reale)*
+>
+> ![screenshot](./assets/screenshot.png)
+
+---
+
+## 🚀 Funzionalità
+
+### 🔍 Identificazione del client
+- Recupero del **vero IP del client** anche dietro più proxy/load balancer.
+- Compatibile con:
+  - `X-Forwarded-For`
+  - `X-Real-IP`
+  - PROXY protocol v2
+
+### 🛰️ Lookup RIPEstat
+Per l’indirizzo IP viene mostrato:
+- ASN
+- Provider (holder)
+- Prefisso annunciato
+
+### 🎨 UI moderna
+- Font Montserrat
+- Layout centrato
+- Logo cliccabile
+- Animazioni CSS
+- Copy-to-clipboard
+- Modalità dark automatica
+
+### 🔧 Semplice da deployare
+- Dockerfile incluso
+- Configurazione Helm-ready
+- Compatibile con ingress-nginx e cert-manager
+
+---
+
+## 📂 Struttura del progetto
+
+myip-webapp/
+├─ app.py
+├─ requirements.txt
+├─ Dockerfile
+├─ static/
+│ ├─ myip.css
+│ ├─ logo.png
+│ └─ favicon.ico
+└─ README.md
+
+---
+
+## 🐳 Deploy con Docker
+
+### Build
+
+```bash
+docker build -t myip:latest .
+docker run -p 8080:8000 myip
+
+http://localhost:8080
diff --git a/assets/screenshot.png b/assets/screenshot.png
new file mode 100644
index 0000000..6c358d6
Binary files /dev/null and b/assets/screenshot.png differ