https://github.com/sebitas71133/zen-lingo
Aplicación web, diseñada para ayudar a los usuarios a gestionar su propio vocabulario y expresiones en inglés. Ofrece funcionalidades para registrar y organizar palabras, verbos, frases, textos y etiquetas, así como una opción avanzada de autocompletado utilizando la API de Gemini
https://github.com/sebitas71133/zen-lingo
file-saver firebase-auth firebase-database framer-motion google-gemini-api jspdf mui-material react react-hook-form react-router redux-toolkit slick-carousel sweetalert2 toastify xlsx
Last synced: 8 months ago
JSON representation
Aplicación web, diseñada para ayudar a los usuarios a gestionar su propio vocabulario y expresiones en inglés. Ofrece funcionalidades para registrar y organizar palabras, verbos, frases, textos y etiquetas, así como una opción avanzada de autocompletado utilizando la API de Gemini
- Host: GitHub
- URL: https://github.com/sebitas71133/zen-lingo
- Owner: sebitas71133
- License: mit
- Created: 2025-07-14T06:07:36.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-17T19:28:08.000Z (11 months ago)
- Last Synced: 2025-08-15T10:30:49.695Z (10 months ago)
- Topics: file-saver, firebase-auth, firebase-database, framer-motion, google-gemini-api, jspdf, mui-material, react, react-hook-form, react-router, redux-toolkit, slick-carousel, sweetalert2, toastify, xlsx
- Language: JavaScript
- Homepage: https://zenlingo.netlify.app/
- Size: 2.63 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📚 EnglishApp - Aprende Inglés (React + MUI + Firebase + Gemini API)
Aplicación web construida con **React 19**, **MUI**, **Firebase** y **Redux Toolkit**, diseñada para ayudar a los usuarios a **gestionar su propio vocabulario y expresiones en inglés**. Ofrece funcionalidades para registrar y organizar **palabras**, **verbos**, **frases**, **textos** y **etiquetas**, así como una opción avanzada de autocompletado utilizando la **API de Gemini (Google Generative AI)**.
---
## 🚀 Tecnologías principales
- React 19
- Material UI (MUI)
- Firebase (Auth + Firestore)
- Redux Toolkit
- React Router v7
- Framer Motion – animaciones
- React Hook Form – formularios
- Google Generative AI (Gemini API) – autocompletar contenido
- jsPDF, xlsx – exportar contenido
- React Toastify, SweetAlert2 – notificaciones y alertas
- Slick Carousel – carruseles de contenido
---
### 🖼️ Vista previa de la aplicación
| Words | View |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|  |  |
| Autocomplete | Tags |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|  |  |
| Tools | Dashboard |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|  |  |
| Home | Login |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|  |  |
---
## 📦 Instalación
1. Clona el repositorio:
```bash
git clone https://github.com/sebitas71133/zen-lingo
cd zen-lingo
```
2. Instala las dependencias:
```bash
npm install
```
3. Crea el archivo `.env`:
```bash
cp .env.template .env
```
Edita tu archivo `.env` con las claves necesarias de Firebase y Gemini:
```env
VITE_FIREBASE_API_KEY=...
VITE_FIREBASE_AUTH_DOMAIN=...
VITE_FIREBASE_PROJECT_ID=...
VITE_FIREBASE_STORAGE_BUCKET=...
VITE_FIREBASE_MESSAGING_SENDER_ID=...
VITE_FIREBASE_APP_ID=...
VITE_FIREBASE_MEASUREMENT_ID=...
VITE_GEMINI_API_KEY=...
```
4. Levanta el proyecto:
```bash
npm run dev
```
---
## 📘 Funcionalidades destacadas
- Autenticación con Firebase
- Gestión de:
- ✅ Palabras
- ✅ Verbos
- ✅ Frases y textos personalizados
- ✅ Etiquetas (tags)
- Organización, filtrado y búsqueda
- Exportación a PDF, Excel y descarga local
- Autocompletado de contenido con Gemini AI
- Notificaciones con toast y alertas interactivas
- Interfaz moderna y adaptable (Material UI + animaciones)
---
## 🧪 Scripts disponibles
| Comando | Descripción |
| --------------- | ------------------------------ |
| npm run dev | Inicia en modo desarrollo |
| npm run build | Compila para producción |
| npm run preview | Previsualiza la build generada |
---
## 🧩 Integraciones
- 🔐 **Firebase** – autenticación y almacenamiento de datos en tiempo real.
- 🤖 **Gemini API (Google)** – generación de contenido sugerido para palabras.
- 🧾 **Exportadores/importadores** – permite exportar e importar listas de estudio en diferentes formatos.
---
## 🧩 Video
https://github.com/user-attachments/assets/09c2974e-5bac-48e0-aad1-2ccb2345e839
---
## 🛠️ Autor
Jesús Sebastián Huamanculi Casavilca - [GitHub](https://github.com/sebitas71133)
---
## 📄 Licencia
MIT