À propos du projet

Jolito est une application de flashcards open-source destinée aux apprenants de l'espagnol mexicain parlé. Elle associe une boucle de révision par répétition espacée à une immersion audio et un flux d'entraînement piloté par clavier, et peut fonctionner comme une application web installable et capable de fonctionner hors ligne ou comme un package iOS natif. Points forts décrits dans le README : - Révision axée sur le clavier : Entrée pour révéler, touches 1-4 pour noter, Espace pour lire l'audio, avec des entrées autofocus pour garder les mains sur le clavier. - Audio prioritaire : audio d'espagnol mexicain parlé attaché aux questions et aux réponses. - Rappel actif typé : les apprenants tapent les réponses plutôt que de simplement les reconnaître ; un diff visuel instantané souligne les différences d'orthographe, tandis que la notation reste auto-évaluée. - Atelier de cartes doubles : des cartes réciproques espagnol-anglais liées sont créées ensemble avec des aperçus côte à côte et une rédaction par lots. - Assistant lexique hors ligne : dictionnaire d'espagnol mexicain intégré pour les traductions, les lemmes et les indices de conjugaison verbale. - Détection des doublons lors de la création de cartes, de la gestion des decks et de l'édition. - Import Anki : les decks existants peuvent être importés via des packages .apkg ou des exports texte, tout en préservant l'historique d'apprentissage et les calendriers de révision. - Build iOS natif via Capacitor avec retour haptique pour les révélations et la notation. - Stockage prioritaire hors ligne avec persistance locale et mise en cache via service-worker ; option d'installation PWA. - Decks personnels avec connexion e-mail sans mot de passe et synchronisation multi-appareils supportée par Supabase. Le projet se positionne entre deux extrêmes : les outils de répétition espacée polyvalents qui nécessitent une création manuelle de cartes (découpage audio, images, modèles), et les applications d'apprentissage ludifiées avec des programmes fixes. L'objectif déclaré de Jolito est une création de cartes sans friction avec un contrôle de l'apprenant sur les phrases du monde réel étudiées. L'exécution locale nécessite Node.js >= 24 et npm. Après le clonage, `npm ci` installe les dépendances et `npm run dev` lance un serveur de développement sur http://localhost:5173. Pour vérifier le build de production installable, `npm run build && npm run preview` le sert sur http://localhost:4173 ; un chargement initial en ligne permet de tester le comportement de rechargement hors ligne. Le développement à distance est documenté pour SSH avec un port transféré, car Mosh seul ne peut pas transporter le port TCP. La documentation complémentaire dans le dépôt couvre la vision du produit, les principes de conception, la feuille de route, une description de l'architecture référençant une structure de domaine hexagonale avec stockage local-first, un guide de qualité décrivant la pyramide des tests, les invariants d'accessibilité et les contrats CI, ainsi qu'un guide de développement pour la configuration de la synchronisation Supabase et le déploiement Cloudflare Workers. Le projet est sous licence Apache License 2.0.