LinguaQuiz 🎯

A language learning web application that helps users master vocabulary through spaced repetition. Live demo: lingua-quiz.nikolay-eremeev.com

Quick Start with Local Kubernetes 🚀

1. Prerequisites:

   • Docker Desktop with Kubernetes enabled
   • kubectl
   • Helm
   • NGINX Ingress Controller:

     kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.10.0/deploy/static/provider/cloud/deploy.yaml
     

2. Clone and Deploy:

   git clone https://github.com/nikolay-e/lingua-quiz.git
   cd lingua-quiz
   make local
   

3. Access the App:

   • Frontend: http://localhost
   • Backend API: http://localhost/api

4. Clean Up:

   make clean-local
   

Documentation 📚

• Development Guidelines - LLM-centric development approach
• System Architecture - Technical design and components
• Learning Algorithm - How the spaced repetition works
• Answer Validation - Translation answer matching rules

Tech Stack

Frontend: Svelte 5, Vite 7 Backend: Python 3.13, FastAPI, PostgreSQL Infrastructure: Docker, Kubernetes, Helm Testing: Playwright E2E tests, Python integration tests

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.