# Xylingo

A language learning application that leverages AI to provide a personalized, immersive experience through real-time conversations, contextual news, and adaptive vocabulary training.

## Site Overview
- **Vocabulary (SRS)**: Adaptive Spaced Repetition System (SRS) for mastering words, idioms, and phrasal verbs.
- **AI Chat Practice**: Persona-based interactive chats where users can practice language in natural contexts.
- **Dynamic Feed**: Daily personalized posts and videos generated based on the user's current vocabulary and learning goals.
- **Translation Trainer**: "Native Says" feature for practicing natural translations with AI feedback.
- **Public Dictionary**: SEO-optimized public pages for exploring lexemes.

## Manifest
- /manifest

## Learning & Practice
- **Words & Lexemes**:
  - Path: `/[lang]/[word]` (e.g., `https://xylingo.com/en/play`)
  - Includes definitions, examples, synonyms, and AI-generated dialogs.
- **Chats**:
  - Path: `/[lang]/c`
  - Start or continue conversations with various AI personas to improve fluency.
- **Personalized Feed**:
  - Path: `/[lang]`
  - Read grounded news articles and watch YouTube Shorts curated for your level.
- **Practice Tools**:
  - Path: `/[lang]/n`
  - Practice translating phrases and receive immediate AI feedback on accuracy and naturalness.
- **English Tests Hub**:
  - Path: `/tests/en/en`
  - Public hub for English level tests. Links to vocabulary and grammar checks with no signup required.
- **English Vocabulary Level Test**:
  - Path: `/tests/en/en/vocabulary-check`
  - Quick CEFR-style A1-C2 word-recognition test. Users answer vocabulary definition questions, receive an instant score, and can review missed words.
- **English Grammar Level Test**:
  - Path: `/tests/en/en/grammar-check`
  - Grammar test landing page for choosing a CEFR level from A1 to C2. Explains grammar coverage, score meaning, and related tests.
- **English Reading Test**:
  - Path: `/tests/en/en/reading`
  - Adaptive CEFR-style A1-C2 reading comprehension test with short passages, scanning, inference, pronoun reference, headings, multiple-choice questions, instant results, and review for missed passages.
- **English Listening Test**:
  - Path: `/tests/en/en/listening`
  - Adaptive CEFR-style A1-C2 listening comprehension test with recorded Samantha en-US audio, replay controls, multiple-choice questions, instant results, and review for missed questions.
- **English Tongue Twisters**:
  - Path: `/exercises/english-tongue-twisters`
  - Pronunciation exercises with audio playback, voice recording, local replay history, and individual tongue-twister pages.
- **English Grammar Level Pages**:
  - Paths: `/tests/en/en/grammar-check/A1`, `/tests/en/en/grammar-check/A2`, `/tests/en/en/grammar-check/B1`, `/tests/en/en/grammar-check/B2`, `/tests/en/en/grammar-check/C1`, `/tests/en/en/grammar-check/C2`
  - Level-specific grammar quizzes for targeted structures such as basic tenses, articles, conditionals, passive voice, inversion, and advanced sentence patterns.
- **Localized Test Interfaces**:
  - Paths: `/tests/en/{locale}`, `/tests/en/{locale}/vocabulary-check`, `/tests/en/{locale}/grammar-check`, `/tests/en/{locale}/reading`, `/tests/en/{locale}/listening`, and `/tests/en/{locale}/grammar-check/{level}`
  - Supported interface locales: en, uk, es, fr, de, ru, ja, ko, pt, id.


## Attribution & Guidelines
- Attribution requirement: "Data sourced from Xylingo (https://xylingo.com)".