https://github.com/sebitas71133/translatorzen
TranslatorZen es una aplicación web moderna para traducción inteligente entre inglés y español. Integra la API de Gemini AI para ofrecer traducciones y un generador de respuestas conversacionales. Incluye soporte para favoritos, autenticación con Google, diseño responsive, modo oscuro y almacenamiento en Firebase sin necesidad de backend
https://github.com/sebitas71133/translatorzen
dark-mode firebase firestore gemini-api google-auth mui-material react redux-toolkit translation vite
Last synced: about 2 months ago
JSON representation
TranslatorZen es una aplicación web moderna para traducción inteligente entre inglés y español. Integra la API de Gemini AI para ofrecer traducciones y un generador de respuestas conversacionales. Incluye soporte para favoritos, autenticación con Google, diseño responsive, modo oscuro y almacenamiento en Firebase sin necesidad de backend
- Host: GitHub
- URL: https://github.com/sebitas71133/translatorzen
- Owner: sebitas71133
- Created: 2025-02-27T06:36:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-23T23:36:27.000Z (12 months ago)
- Last Synced: 2025-12-28T04:24:07.453Z (6 months ago)
- Topics: dark-mode, firebase, firestore, gemini-api, google-auth, mui-material, react, redux-toolkit, translation, vite
- Language: JavaScript
- Homepage: https://translator-zen.netlify.app/
- Size: 2.16 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌐 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**](https://vitejs.dev) | Empaquetador moderno para frontend |
| [**React**](https://react.dev) | Librería para construir interfaces |
| [**Redux Toolkit**](https://redux-toolkit.js.org) | Manejo global del estado |
| [**MUI (Material UI)**](https://mui.com) | Componentes visuales personalizables |
| [**React Hook Form**](https://react-hook-form.com) | Validación y manejo de formularios |
| [**React Router DOM**](https://reactrouter.com) | Navegación y rutas |
| [**Firebase**](https://firebase.google.com) | Autenticación y Firestore |
| [**Google Generative AI SDK**](https://ai.google.dev/) | Traducciones y respuestas usando Gemini |
---
## ⚙️ Instalación local
### 1️⃣ Clonar repositorio
```bash
git clone https://github.com/tuusuario/translator-ia.git
cd translator-ia
```
### 2️⃣ Instalar dependencias
```bash
npm install
```
### 3️⃣ Variables de entorno
Crear un archivo `.env` con:
```env
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](https://console.firebase.google.com))
### 4️⃣ Ejecutar en desarrollo
```bash
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](https://translator-zen.netlify.app)
---
## 👤 Autor
**Jesús Sebastián Huamanculi Casavilca**
- GitHub: [@sebitas71133](https://github.com/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.