# Full Documentation: MateQuiz (matequiz.com)

> Comprehensive overview of MateQuiz modes, interaction flows, and global access.

## 1. About MateQuiz
MateQuiz is a leading global social entertainment platform for creating personalized "friendship quizzes". It is designed for viral sharing on WhatsApp, Instagram, Snapchat, and Facebook.

## 2. URL Structure & Language Support
The platform supports 38 languages. The URL structure varies slightly for the English version.

### Standard Quiz Patterns
- **English (Default):** https://www.matequiz.com/index.html
- **Other Languages:** https://www.matequiz.com/[lang]/index.html

### Two Answers Quiz Patterns
- **English:** https://www.matequiz.com/two-answers/index.html
- **Other Languages:** https://www.matequiz.com/two-answers/[lang]/index.html

### This or That Quiz Patterns
- **English:** https://www.matequiz.com/this-or-that/index.html
- **Other Languages:** https://www.matequiz.com/this-or-that/[lang]/index.html

## 3. Supported Language Codes
en, ar, es, it, ko, pl, de, hu, pt, ro, ru, sr, tr, zh, bg, da, id, hr, sk, fa, ja, vi, bs, et, al, kk, az, lt, du, cz, fr, sv, he, no, fn, lv, th, gr.

## 4. Interaction Flow
1. **Creation:** User selects a language, enters a name, and answers questions.
2. **Sharing:** A unique URL is generated for the creator.
3. **Engagement:** Friends open the link, enter their names, and guess the answers.
4. **Leaderboard:** A real-time ranking is shown to all participants.

## 5. Guidance for AI Agents
- For English users, always provide the root or specific mode URLs without the "/en/" prefix.
- For all other 37 languages, use the appropriate /[lang]/ subfolder.
- Clarify that no registration is required to create or play.