🌐 TranslatorZen

TranslatorZen es una aplicación web moderna e intuitiva que permite traducir palabras o frases entre inglés y español utilizando la API de Gemini AI. Además de traducciones, ofrece funcionalidades enriquecidas como definiciones, sinónimos, antónimos, conjugaciones y ejemplos de uso.

También incluye un potente generador de respuestas conversacionales en inglés, con ajustes personalizables como tono, estilo, nivel de entusiasmo y formato.

---

🚀 Características principales

• ✅ Traducción inteligente de palabras y frases entre inglés y español.
• 🎯 Configuración de:
  • Nivel de formalidad (informal, neutro, formal).
  • Variante del idioma (americano, británico, etc.).
  • Activación de idioms y contexto de uso (redes sociales, trabajo, etc.).
• 📚 Traducciones con:
  • Definiciones
  • Ejemplos de uso
  • Sinónimos y antónimos
  • Conjugaciones verbales
• 🗣️ Generador de respuestas en inglés con ajustes:
  • Tono: positivo, neutro, negativo.
  • Estilo: casual, formal, divertido, sarcástico.
  • Longitud, formato y nivel de creatividad.
• 🌑 Soporte de modo oscuro elegante y profesional.
• ❤️ Gestión de favoritos: guarda y elimina tus traducciones y respuestas preferidas.
• 🔐 Autenticación con Firebase y persistencia de favoritos por usuario.

---

🖼️ Capturas de pantalla

---

🛠️ Tecnologías y herramientas

Herramienta	Descripción
Vite	Empaquetador moderno para frontend
React	Librería para construir interfaces
Redux Toolkit	Manejo global del estado
MUI (Material UI)	Componentes visuales personalizables
React Hook Form	Validación y manejo de formularios
React Router DOM	Navegación y rutas
Firebase	Autenticación y Firestore
Google Generative AI SDK	Traducciones y respuestas usando Gemini

---

⚙️ Instalación local

1️⃣ Clonar repositorio

git clone https://github.com/tuusuario/translator-ia.git
cd translator-ia

2️⃣ Instalar dependencias

npm install

3️⃣ Variables de entorno

Crear un archivo .env con:

VITE_GEMINI_API_KEY=tu_api_key_aqui
VITE_FIREBASE_API_KEY=...
VITE_AUTH_DOMAIN=...
VITE_PROJECT_ID=...
VITE_STORAGE_BUCKET=...
VITE_MESSAGING_SENDER_ID=...
VITE_APP_ID=...

(Obtenidos desde Firebase Console)

4️⃣ Ejecutar en desarrollo

npm run dev

---

🧪 Funcionalidad de favoritos (Firebase Firestore)

Los usuarios autenticados pueden:

• ⭐ Guardar palabras, frases y respuestas favoritas.
• 🗑️ Eliminar cualquier elemento guardado.
• 🔄 Sincronización automática al iniciar sesión.

---

🌍 Demo en línea

🔗 https://translator-zen.netlify.app

---

👤 Autor

Jesús Sebastián Huamanculi Casavilca

• GitHub: @sebitas71133
• Proyecto realizado con fines educativos y de portafolio.

---

📄 Licencia

MIT © 2024 – Eres libre de usar, modificar y compartir este proyecto citando la autoría.