Aplicación web estática para practicar idiomas con ayuda de cualquier IA. Incluye tres módulos:
- Flashcards: sesiones con temporizador, gestos de deslizamiento y autoevaluación.
- Exámenes Rápidos: ejercicios de completar espacios para practicar tiempos verbales en inglés.
- Reading: exámenes de comprensión lectora estilo IELTS/Cambridge con temporizador, corrección y evidencia del texto.
No requiere instalación, backend ni dependencias. Funciona abriendo index.html directamente en el navegador o publicándolo en GitHub Pages. Tus tarjetas, ajustes y tema se guardan sólo en tu navegador (localStorage).
- Configura la sesión: tarjetas por ronda, segundos por tarjeta (el temporizador se puede desactivar) y descanso tras la ronda.
- Añade tus tarjetas: pega un arreglo JSON, carga o arrastra un archivo
.json, o usa las tarjetas de ejemplo. El panel «Genera tu JSON con cualquier IA» incluye un prompt listo para copiar. - Estudia: toca la tarjeta para voltearla y clasifícala como «la supe», «repasar» o «aún no» con los botones, deslizando o con el teclado. Si el tiempo se agota, la tarjeta pasa a «repasar».
- Resumen: porcentaje dominado, conteo por categoría y cuenta regresiva del descanso. Puedes repasar todas las pendientes, repetir otra ronda con el mismo mazo o cambiar la configuración.
| Acción | Gesto | Teclado |
|---|---|---|
| Voltear | Tocar | Espacio / Enter |
| La supe | Deslizar izquierda | ← |
| Repasar | Deslizar abajo | ↓ |
| Aún no | Deslizar derecha | → |
| Salir | Botón × | Esc |
Formato esperado:
[
{ "front": "Good morning", "back": "Buenos días" },
{ "front": "See you soon", "back": "Hasta pronto" }
]-
Selecciona uno o más tiempos verbales (presente, pasado y futuro en sus cuatro aspectos) y la dificultad:
Dificultad Párrafos Espacios Pista del verbo Fácil 2 6 Sí Medio 3 10 Sí Difícil 4 14 No -
Copia la instrucción generada y pégala en la IA de tu elección.
-
Pega la respuesta en la aplicación y pulsa Cargar examen (o
Ctrl/Cmd + Enter). Si la IA envolvió el JSON en un bloque```jsono añadió texto alrededor, se limpia automáticamente. -
Completa los espacios (
Entersalta al siguiente). El Banco de palabras es opcional y sólo muestra los verbos en forma base, mezclados. -
Al calificar, la comparación ignora mayúsculas, espacios repetidos, puntuación final y la diferencia entre apóstrofos rectos y tipográficos (
don't=don’t). Cada error muestra la oración, tu respuesta y la correcta, y los errores se agrupan por tiempo verbal. Puedes borrar respuestas para reintentar.
El lector valida que cada marcador {{id}} del texto tenga una pregunta asociada en su mismo párrafo y que los id sean únicos. Cada pregunta requiere baseForm (infinitivo, usado para las pistas) y correctAnswer (forma conjugada que se valida). La IA debe devolver un objeto JSON con esta forma:
{
"version": "1.0",
"title": "English verb tenses practice",
"instructions": "Complete every blank with the correct form of the verb.",
"difficulty": "Medio",
"selectedTenses": ["Present Simple", "Past Simple"],
"paragraphs": [
{
"id": "p1",
"text": "Every morning, Laura {{b1}} coffee. Last Saturday, she {{b2}} a new recipe.",
"questions": [
{
"id": "b1",
"sentence": "Every morning, Laura ___ coffee.",
"baseForm": "make",
"correctAnswer": "makes",
"verbTense": "Present Simple"
},
{
"id": "b2",
"sentence": "Last Saturday, she ___ a new recipe.",
"baseForm": "try",
"correctAnswer": "tried",
"verbTense": "Past Simple"
}
]
}
]
}difficulty debe ser exactamente Fácil, Medio o Difícil.
- Elige la dificultad (
easy,medium,hard) y copia la instrucción generada en tu IA. Pide 3 secciones, 25 preguntas y 40 minutos. - Pega el JSON devuelto, carga un archivo o usa Usar examen de ejemplo (
reading-sample.json, nivel medium) y pulsa Empezar examen. - Resuelve las secciones: el texto, con párrafos etiquetados
P1,P2…, queda a la izquierda y las preguntas a la derecha. La barra superior muestra el progreso y el tiempo, y avisa cuando quedan 5 minutos. Al agotarse el tiempo, el examen se entrega solo. - Al entregar verás la puntuación, la banda, el aprobado según
pass_marky el desglose por sección y tipo de pregunta. Cada pregunta muestra la respuesta correcta, la explicación y la cita del texto; Ver en el texto la resalta en el párrafo.
Tipos de pregunta soportados:
type |
Respuesta | Calificación |
|---|---|---|
multiple_choice |
Una opción de options (A–D) |
Por clave |
true_false_not_given |
True, False o Not Given |
Sin distinguir mayúsculas |
statement_completion |
Texto libre, máximo max_words palabras |
Contra accepted_answers, igual que los exámenes rápidos; superar el límite cuenta como error |
Estructura mínima (ver reading-sample.json para un examen completo):
{
"module": { "title": "Academic Reading", "generated_difficulty": "medium", "timer": { "total_minutes": 40 } },
"scoring": { "pass_mark": 15, "score_bands": [{ "min": 0, "max": 14, "label": "Developing" }, { "min": 15, "max": 25, "label": "Competent" }] },
"sections": [
{
"id": "S1",
"title": "Green Roofs",
"recommended_minutes": 13,
"passage": { "title": "Green Roofs", "paragraphs": [{ "id": "P1", "text": "..." }] },
"questions": [
{
"number": 1,
"type": "statement_completion",
"prompt": "Older buildings may need ______.",
"max_words": 2,
"correct_answer": "structural reinforcement",
"accepted_answers": ["structural reinforcement"],
"explanation": "...",
"text_reference": { "paragraph_id": "P1", "quote": "cita literal del párrafo", "note": "opcional, para Not Given" }
}
]
}
]
}El temporizador del examen sigue corriendo aunque cambies de sección de la app.
index.html estructura de las pantallas y componentes accesibles
style.css diseño responsive; todos los colores son tokens y el modo oscuro sólo los redefine
app.js estado, navegación, flashcards, validación y motor de exámenes
sample.json tarjetas de demostración (también integradas en app.js como respaldo)
reading-sample.json examen de Reading de ejemplo (nivel medium, 25 preguntas)
- Navegación: tabla de rutas en
app.jssincronizada con el hash de la URL (#flashcards,#quick-exams,#reading), así que recargar o compartir el enlace conserva la sección. Para añadir una sección, registra su ruta y pantalla enroutesy añade su enlace en el menú. - Sesiones: cambiar de sección o salir detiene la sesión de estudio y su temporizador.
- Exámenes: funciones separadas para generar la instrucción (
buildExamPrompt), validar el JSON (validateExam), renderizar (renderExam) y calificar (gradeExam). - Reading:
buildReadingPrompt,validateReading(normaliza tipos, opciones y párrafos),startReading/renderReadingSectionysubmitReading/gradeReadingQuestion.
Abre index.html en un navegador; no hace falta servidor. Si prefieres uno (necesario para «Usar examen de ejemplo» de Reading):
python -m http.server 5517y visita http://localhost:5517. También puede publicarse directamente desde la raíz del repositorio en GitHub Pages.