active v2.1.0 Lab

Flashcards AI

Magic active recall study deck with 3D flips, speech phonetics (1x & 0.75x slow mode), 3 study modes, and batch AI card generation.

Active Recall and bilingual memorization web app tailored for kids (school science, space, world geography) and adults (Business English, AI concepts, MBA strategy). Features 3D card-flip animations, native speech pronunciation via Web Speech API with regular and slow turtle modes, 3 study modes (Leitner 3D Flip, 4-Option Quiz Arcade, and Spelling Mode with progressive hint reveals), RFC-4180 CSV import/export, and batch AI magic generation with Google Gemini API.

Flashcards AI

🎯System Objectives

✓

Empower multigenerational bilingual study (kids and adults) eliminating monotonous manual rote methods and cold empty screens.

✓

Deliver native phonetic speech pronunciation (Web Speech API) with dual speed modes (1.0x and 0.75x turtle slow mode).

✓

Offer 3 interactive study modes: Classic 3D Leitner Flip, Quiz Arcade with dynamic distractors, and Spelling Mode with progressive hints.

✓

Integrate batch structured card generation using Google Gemini API (gemini-2.5-flash / gemini-2.0-flash BYOK) in pure JSON.

✓

Ensure 100% client-side privacy, progress and medals persistence in LocalStorage, and full offline PWA installability.

⚡Key Capabilities & Modules

🗣️

Dual Phonetic Speech (1.0x & 0.75x Turtle): native in-browser voice synthesis via Web Speech API to master accurate pronunciation syllable by syllable.

🎒

6 Curated Decks in 1 Click: pre-loaded study decks for kids (Bilingual Science, Space, Capitals) and adults (Business English, AI Concepts, MBA Strategy).

🎯

3 Adaptive Study Modes: Classic 3D Leitner Flip, 4-Option Quiz Arcade, and Spelling Mode with progressive letter hints.

⚡

Batch AI Generation with Gemini: autocompletes dozens of terms, definitions, phonetics, and mnemonic hints in a single JSON payload.

📂

RFC-4180 CSV Import & Export: process and backup tabular study decks compatible with Excel, safely handling commas and quotes.

📲

100% Offline Installable PWA: zero external CDNs, adaptive Sunny Studio / Starlight Deck design with anti-FOUC, and achievement medals.

📐Architecture & Design Specifications

Strict client-side Single-Source-of-Truth architecture: study logic, CSV parsing, and speech audio run deterministically inside the browser. The user's Gemini API key stays strictly in LocalStorage and communicates directly and securely with Google AI Studio endpoints with zero intermediate servers.

flowchart TD USER["Estudiante (Niño / Adulto)"] --> UI["Interfaz Flashcards 3D (Sunny / Starlight)"] UI -->|"Modo Manual / CSV"| PARSER["Parser/Exportador CSV RFC-4180"] UI -->|"Modo IA (Gemini Batch)"| GEMINI["Google Gemini API (gemini-2.5-flash / 2.0-flash)"] PARSER --> DECK["Gestor de Mazos (6 Curados + Personalizados)"] GEMINI --> DECK DECK -->|"Persistencia Local"| LS[("Navegador LocalStorage")] DECK --> TTS["Web Speech API (Voz 1.0x & Tortuga 0.75x)"] DECK --> MODES{"3 Modos de Juego"} MODES -->|"1"| M1["Giro 3D & Cajas Leitner"] MODES -->|"2"| M2["Quiz Arcade (4 Opciones)"] MODES -->|"3"| M3["Escritura & Pistas"] M1 --> UI M2 --> UI M3 --> UI

🔍 Click diagram to enlarge to fullscreen

Invariant Architectural Principles:

  • Privacy & Local Sovereignty: study decks and user keys reside strictly in the local browser with zero invasive trackers or third-party ad networks.
  • Inclusion & Playful Motivation: warm colors, 3D tactile buttons, native canvas confetti, and positive audio reinforcement for both kids and adults.
  • Zero Network Dependencies: complete removal of third-party CDNs, ensuring instant loading and reliable offline execution.

🛠️Technology Stack

FRONTEND

Vanilla JS (ES Modules)HTML5 SemanticCSS 3D TransformsCSS Design Tokens

PWA

Web App Manifest (PWA)Service Worker (Cache-First / Stale-While-Revalidate)SVG Vector Icon

APIS

Web Speech Synthesis API (TTS)Web Audio API (Sintetizador 8-bit)Web Storage API (LocalStorage)

AI

Google Gemini API (gemini-2.5-flash / gemini-2.0-flash via REST JSON)

HOSTING

Hugo Static Engine (/apps/flashcards/)Shims SEO Retrocompatibles (/es/, /en/)

📚Reference Articles & Architecture Series

This application is fully documented in an engineering series published on the blog:

AI-Powered Programming: Creating My Own Magical Flashcards Study App
Part 1

AI-Powered Programming: Creating My Own Magical Flashcards Study App

While helping my son study science in English, I realized we needed more than just covering the page with a hand. That’s how my …

Read full article →

⏱️Evolutionary History & Versions (SemVer)

Formal record of releases, feature additions, and security patches:

v2.1.0 2026-11-06 RELEASE

Flashcards v2.1.0: Full Offline PWA, Maskable Icon Suite, Universal Install and In-App Update

  • Full suite of 6 PNG and SVG icons with native maskable support (192px & 512px) and apple-touch-icon for Android & iOS.
  • Service Worker v2.1.0 update with skipWaiting support, full icon precaching, and instant reload via controllerchange.
  • Universal PWA install button in header with smart standalone detection and toast guidance for iOS Safari.
  • Interactive #btn-check-update (v2.1.0) badge for manual version checks and #pwa-update-banner floating action.
  • Single-File Inline bundling: direct injection of CSS and JS modules into index.html, removing loose requests and guaranteeing instant offline startup.
  • Floating Toasts notification system (#toast-container) for playful feedback, achievements, and app status.
v2.0.0 2026-11-06 RELEASE

Evolution to Magic Deck v2.0: Phonetic Speech, 6 Curated Decks, 3 Modes and Gemini Batch

  • Contract drift resolution: native Web Speech API voice synthesis with normal (1.0x) and turtle (0.75x) speeds for bilingual pronunciation.
  • 6 pre-loaded curated study decks for kids (Human Body Science, Space, Capitals) and adults (Business English, AI Concepts, MBA Strategy).
  • 3 interactive study modes: 3D Leitner Flip, 4-Option Quiz Arcade, and Spelling Mode with progressive letter-by-letter hints.
  • Gemini API upgrade to structured batch JSON calls (gemini-2.5-flash with gemini-2.0-flash fallback), accelerating generation 10x.
  • Standard RFC-4180 CSV parser and exporter with full deck download and sample templates.
  • 100% Offline PWA: manifest.json, sw.js, vector icon, and complete elimination of external CDNs (Tailwind and Giphy).
  • Full persistence of custom decks, records, and 6 achievement medals in LocalStorage with native Canvas confetti.
  • SEO redirection shims in /es/ and /en/ fixing legacy UTF-g charset bug.
v1.0.0 2025-10-17 RELEASE

Official initial Flashcards release with Gemini AI engine

  • Basic Gemini API integration and 3D card flip animation.

Want to deploy this architecture or explore custom solutions?

If you are interested in deploying this architecture, exploring custom solutions for your organization, or proposing new features to evolve the app, get in touch directly.

You can also reach out through the contact form (contacto@datalaria.com).