diff --git a/README.md b/README.md
index af91396..c0ea045 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,42 @@
-# promomundial-web
+<div align="center">
+  <br/><br/>
+  <h1>🌍 Cómete el mundo y gana</h1>
+  <p><b>Aplicación web promocional gamificada con validación de facturas automatizada mediante Inteligencia Artificial (OCR).</b></p>
+</div>
 
+---
+
+## 📋 Descripción del Proyecto
+
+Plataforma interactiva desarrollada para la campaña promocional conjunta de **Maggi** y **Nestlé**. Los usuarios pueden registrar su cuenta de manera segura, fotografiar sus tickets de compra y subirlos a la plataforma. Mediante integraciones automatizadas con Inteligencia Artificial, las facturas se analizan para otorgar puntos al usuario (1 punto por cada $10 USD), permitiéndole escalar en un Ranking en tiempo real para obtener diferentes premios.
+
+## 🛠️ Stack Tecnológico
+
+* **Frontend:** React 19, TypeScript
+* **Build Tool:** Vite 6
+* **Estilos y Componentes:** Tailwind CSS v4, Lucide React, Framer Motion
+* **Enrutamiento:** React Router DOM v7
+* **BaaS (Autenticación y BD):** Supabase (PostgreSQL)
+* **Automatización y Procesamiento IA:** n8n Webhooks, Google Gemini API
+* **Seguridad:** Google reCAPTCHA v2
+
+## ⚙️ Variables de Entorno (.env)
+
+Para configurar la aplicación, debes crear un archivo `.env` o `.env.local` en la raíz del proyecto tomando como plantilla el archivo `.env.example`. Asegúrate de definir las siguientes variables:
+
+```env
+# Clave de la API de IA (Configurada en AI Studio o n8n)
+GEMINI_API_KEY="TU_GEMINI_API_KEY"
+
+# URL de la Aplicación
+APP_URL="http://localhost:3000"
+
+# Credenciales de Supabase
+VITE_SUPABASE_URL="TU_URL_DE_SUPABASE"
+VITE_SUPABASE_ANON_KEY="TU_ANON_KEY_DE_SUPABASE"
+
+# Endpoint del Webhook de N8N que recibirá las facturas (FormData)
+VITE_N8N_WEBHOOK_URL="TU_N8N_WEBHOOK_URL"
+
+# Llave de sitio de Google reCAPTCHA
+VITE_RECAPTCHA_SITE_KEY="TU_RECAPTCHA_SITE_KEY"
\ No newline at end of file