A personalized German language learning platform powered by AI. Learn German through adaptive lessons, AI conversations with memory, and interactive activities tailored to your proficiency level.
New! AI Conversation Partner now remembers your progress and provides personalized learning based on your previous sessions!
- ✅ Fixed Activity Completion System: Learning plan items now use database IDs for accurate completion tracking - no more wrong activities being marked complete!
- ✅ Reading in German: Reading comprehension questions and answer choices now in German for authentic practice
- ✅ Speaking Practice Overhaul: Dedicated speaking activity page with turn-based AI tutoring, Deepgram transcription, automatic scoring, and learning plan integration
- ✅ Enhanced Placement Test: 3-section comprehensive assessment (Reading + Grammar + Writing) for more accurate level evaluation
- ✅ Study Streak Tracking: Track consecutive study days and total study time across all activities
- ✅ Session Memory: Every conversation is saved with complete transcripts and AI feedback
- ✅ Smart History View: Browse past conversations with expandable cards showing scores, feedback, and full transcripts
- ✅ Context-Aware AI: Alex loads your last session's feedback and adapts the conversation to your needs
- ✅ Continuous Learning: AI remembers your grammar mistakes, vocabulary gaps, and strengths across sessions
- ✅ Multilingual Feedback: All feedback provided in your native language for better understanding
- ✅ Beautiful UI: Polished conversation history cards with color-coded scores and detailed analytics
- Comprehensive CEFR-based assessment (A1-C2)
- Evaluates grammar, vocabulary, reading comprehension, and listening skills
- Identifies strengths and weaknesses
- Provides personalized recommendations
- Customized weekly learning schedules based on your level
- Structured progression from your current level to target goals
- Covers all essential skills: Grammar, Vocabulary, Listening, Writing, Speaking
- Automatic progress tracking and completion status
Six types of AI-generated activities, all fully working:
- Grammar Exercises: Fill-in-the-blank questions with detailed explanations in your native language
- Vocabulary Practice: Flashcard-style matching and translation exercises
- Reading Comprehension: German texts with questions and answer choices in German (authentic exam-style practice)
- Listening Comprehension: Audio-based exercises with comprehension questions
- Writing Tasks: AI-evaluated writing with feedback on grammar, vocabulary, and fluency
- Speaking Practice: Real-time AI conversation partner with topic-specific guidance from your learning plan
Integrated Learning Plan Activities:
- Each week's learning plan includes specific activities across all six skill areas
- Activities are dynamically generated based on your CEFR level
- Automatic completion tracking when you achieve 70%+ score
- Progress syncs with study streak and total study time
Turn-based voice conversations with Alex, your AI German tutor:
- 🎙️ Natural Voice Conversations: Speak, transcribe with Deepgram, and continue with the configured AI tutor provider
- 🧠 Context Awareness: Alex remembers your previous conversations and builds on them
- 📊 Detailed Feedback: After each session, receive comprehensive feedback including:
- Overall performance score (0-100)
- Strengths and areas for improvement
- Grammar corrections with explanations
- Vocabulary suggestions
- Fluency assessment
- Personalized encouragement in your native language
- 📚 Conversation History: View all past conversations with expandable details
- 🎯 Adaptive Learning: Each conversation uses feedback from previous sessions to focus on your weak areas
- 🌐 CEFR-Adapted: Alex adjusts speaking style, vocabulary, and complexity based on your level (A1-C2)
- 🔄 Continuous Improvement: AI tracks recurring grammar patterns and suggests vocabulary naturally
Choose from 5 specialized learning modes in the AI Conversation Partner:
-
Free Conversation 💬
- Natural, open-ended conversation practice
- Alex adapts topics to your interests
- Perfect for building conversational confidence
-
Reading Practice 📖
- Alex presents German texts appropriate for your level
- Read aloud and receive pronunciation feedback
- Patient AI that waits for you to finish before commenting
- Detailed feedback on articulation and fluency
-
Vocabulary Builder 📚
- Learn 2-3 new words each session
- Instructions in your native language, German words with examples
- Practice creating sentences with new vocabulary
- Immediate corrections and better phrasing suggestions
-
Grammar Drill ✏️
- Interactive error identification exercises
- Conducted 90% in German for immersion
- Find mistakes in sentences and explain corrections
- Multiple examples of the same grammar pattern for reinforcement
-
Listening Comprehension 👂
- Alex tells stories or describes situations
- Answer comprehension questions verbally
- Improves listening skills at natural speaking speeds
- Questions about main ideas, details, and inferences
Speaking activities from your learning plan with dedicated AI support:
- Topic-specific conversations based on learning plan items
- AI focuses conversation on the assigned topic (e.g., "Introducing yourself", "Family", "Hobbies")
- Turn-based voice interaction with Deepgram transcription and AI tutor replies
- Automatic evaluation and scoring after session ends
- Auto-completes learning plan item when you score 70%+
- Returns you to learning plan with progress saved
- Study time and streak tracking included
- 📈 Conversation History: View all past conversation sessions with scores and detailed feedback
- ✅ Learning Plan Progress: Track completion of weekly learning activities with database-backed accuracy
- 🔥 Study Streak: Monitor consecutive days of study - streak increments when you study on consecutive days
- ⏱️ Total Study Time: Track cumulative study time across all activities (conversations, exercises, reading, etc.)
- 📝 Study Sessions: Detailed records of each study session with activity type, duration, and items completed
- 📊 Performance Metrics: Detailed analytics on your strengths and improvement areas
- 🎯 Score Trends: See your progress over time across multiple conversations
- 🏆 Achievements: Celebrate milestones and learning goals
- 💯 Auto-Completion: Learning plan items automatically mark complete when you score 70%+ on activities
- Set your native language for better learning experience
- Instructions and explanations in your mother tongue
- Supports English, Arabic, and more
- Email/password authentication
- Google OAuth integration
- Profile customization with avatar support
- Secure data storage with Supabase
DeutschBoost's AI Conversation Partner uses advanced context awareness to provide truly personalized learning:
- First Conversation: Alex introduces himself and adapts to your CEFR level
- AI Feedback: After each conversation, you receive detailed analysis with a 0-100 score
- Memory System: Your feedback is saved and loaded before the next conversation
- Personalized Learning: Alex references your previous strengths, addresses recurring mistakes, and naturally incorporates suggested vocabulary
- Continuous Improvement: Watch your scores improve as Alex helps you overcome specific challenges
Example: If your last feedback showed issues with dative prepositions, Alex will gently reinforce correct usage in your next conversation without explicitly mentioning it - making learning natural and contextual!
- Frontend: React 19 + TypeScript + Vite
- Styling: Tailwind CSS (via CDN)
- AI:
- Google Gemini 2.5 Flash (activities, assessments)
- Google Gemini 2.5 Pro (feedback generation, deep thinking)
- OpenRouter-compatible AI providers for local-first tutor flows
- Deepgram for speech-to-text transcription
- Backend: Supabase
- PostgreSQL Database with JSONB for conversation storage
- Row Level Security (RLS) policies
- Real-time subscriptions
- Authentication (Email/Password + Google OAuth)
- Deployment: Vercel
- PWA: Vite PWA Plugin with Workbox
- Node.js (v18 or higher)
- npm or yarn
- Google Gemini API key
- Supabase account
- Clone the repository:
git clone https://github.com/aliihsaad/DeutschBoost.git
cd DeutschBoost- Install dependencies:
npm install- Set up environment variables:
Create a .env.local file in the root directory with the following:
# Gemini AI API Key
# Get from: https://aistudio.google.com/app/apikey
GEMINI_API_KEY=your_gemini_api_key
API_KEY=your_gemini_api_key
# Supabase Configuration
# Get from: https://supabase.com/dashboard/project/_/settings/api
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
# App Configuration
VITE_APP_URL=http://localhost:5173- Run the development server:
npm run dev- Open http://localhost:5173 in your browser
The app uses Supabase for data storage. To set up the database:
- Create a new project in Supabase
- Run the migration files in order in your Supabase SQL editor:
supabase_migrations/00_diagnostic_and_fix.sql(creates all tables, RLS policies, and fixes user records)supabase_migrations/add_mother_language.sql(adds mother language support)- Conversation sessions table is automatically created with JSONB fields for:
- Transcripts (speaker, text, timestamp)
- AI-generated feedback (scores, corrections, suggestions)
- Copy your project URL and anon key to
.env.local - Enable Google OAuth in Supabase Authentication settings (optional)
conversation_sessions table:
- Stores complete conversation transcripts
- AI feedback as JSONB (flexible schema)
- Duration tracking
- Links to user profiles for RLS
- Enables conversation history and AI context awareness
- Push your code to GitHub
- Import your repository on Vercel
- Configure environment variables in Vercel project settings
- Deploy!
Vercel will automatically detect the Vite configuration from vercel.json.
DeutschBoost/
├── src/
│ ├── components/ # Reusable UI components
│ ├── contexts/ # React contexts (Auth)
│ ├── lib/ # Library configurations (Supabase)
│ ├── pages/ # Auth pages (Login, Signup)
│ └── types/ # TypeScript type definitions
├── components/ # Main components
│ ├── ConversationHistoryCard.tsx # History display component
│ ├── Card.tsx # Reusable card component
│ └── LoadingSpinner.tsx # Loading state component
├── pages/ # Application pages
│ ├── SpeakingActivityPage.tsx # Provider-based conversation and speaking practice
│ ├── ActivityPage.tsx # Learning plan activity handler
│ ├── LearningPlanPage.tsx # 4-week learning plan display
│ ├── EnhancedPlacementTestPage.tsx # 3-section placement test
│ ├── ProfilePage.tsx # User profile & settings
│ └── HomePage.tsx # Landing page
├── services/ # API services
│ ├── geminiService.ts # AI prompts for all 5 conversation modes
│ ├── conversationService.ts # History & feedback management
│ ├── learningPlanService.ts # Learning plan & progress tracking
│ └── activityService.ts # Activity generation (Grammar, Vocab, Reading, etc.)
├── supabase_migrations/ # Database migrations
│ ├── 00_diagnostic_and_fix.sql # Initial schema setup
│ ├── 001_add_reading_skill.sql # Add Reading skill support
│ ├── 002_add_mother_language.sql # Multi-language support
│ └── 003_add_speaking_activity_mode.sql # Speaking activity mode
└── public/ # Static assets
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.
Created by aliihsaad
Project Link: https://github.com/aliihsaad/DeutschBoost