Skip to content

About

Interactive language learning flashcards web app with a Tinder-style swipe interface, high-contrast dark mode, and AI-assisted JSON deck generation.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

CardFlow AI

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).

Módulos

Flashcards

  1. Configura la sesión: tarjetas por ronda, segundos por tarjeta (el temporizador se puede desactivar) y descanso tras la ronda.
  2. 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.
  3. 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».
  4. 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" }
]

Exámenes Rápidos

  1. 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
  2. Copia la instrucción generada y pégala en la IA de tu elección.

  3. Pega la respuesta en la aplicación y pulsa Cargar examen (o Ctrl/Cmd + Enter). Si la IA envolvió el JSON en un bloque ```json o añadió texto alrededor, se limpia automáticamente.

  4. Completa los espacios (Enter salta al siguiente). El Banco de palabras es opcional y sólo muestra los verbos en forma base, mezclados.

  5. 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.

Reading

  1. Elige la dificultad (easy, medium, hard) y copia la instrucción generada en tu IA. Pide 3 secciones, 25 preguntas y 40 minutos.
  2. Pega el JSON devuelto, carga un archivo o usa Usar examen de ejemplo (reading-sample.json, nivel medium) y pulsa Empezar examen.
  3. 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.
  4. Al entregar verás la puntuación, la banda, el aprobado según pass_mark y 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.

Arquitectura

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.js sincronizada 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 en routes y 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/renderReadingSection y submitReading/gradeReadingQuestion.

Uso local

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 5517

y visita http://localhost:5517. También puede publicarse directamente desde la raíz del repositorio en GitHub Pages.

About

Interactive language learning flashcards web app with a Tinder-style swipe interface, high-contrast dark mode, and AI-assisted JSON deck generation.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages