diff --git a/frontend/README-localization.md b/frontend/README-localization.md
new file mode 100644
index 00000000..a8290e00
--- /dev/null
+++ b/frontend/README-localization.md
@@ -0,0 +1,196 @@
+# Localization (i18n) Guide for Maple
+
+This document explains how the automatic UI localization system works in Maple and how to add new languages.
+
+## How It Works
+
+Maple automatically detects the user's operating system language and displays the UI in that language:
+
+1. **Locale Detection**: Uses `tauri-plugin-localization` to get the native OS locale
+2. **Fallback**: Falls back to browser language (`navigator.language`) if native detection fails
+3. **Translation Loading**: Dynamically loads the appropriate JSON translation file
+4. **UI Rendering**: React components use `useTranslation()` hook to display localized strings
+
+## Current Supported Languages
+
+- **English** (`en`) - Default and fallback language
+- **French** (`fr`) - Complete translations
+- **Spanish** (`es`) - Complete translations
+
+## File Structure
+
+```
+frontend/
+├── public/locales/ # Translation files
+│ ├── en.json # English (default)
+│ ├── fr.json # French
+│ └── es.json # Spanish
+├── src/
+│ ├── utils/i18n.ts # i18n configuration
+│ ├── main.tsx # i18n initialization
+│ └── components/ # Components using translations
+└── src-tauri/
+ ├── Cargo.toml # Rust dependencies
+ ├── src/lib.rs # Plugin registration
+ ├── tauri.conf.json # Asset protocol config
+ └── gen/apple/maple_iOS/Info.plist # iOS language declarations
+```
+
+## Adding a New Language
+
+### 1. Create Translation File
+
+1. Copy `public/locales/en.json` to `public/locales/{code}.json` (e.g., `de.json` for German)
+2. Translate all the strings while keeping the same key structure:
+
+```json
+{
+ "app": {
+ "title": "Maple - Private KI-Chat",
+ "welcome": "Willkommen bei Maple",
+ "description": "Private KI-Chat mit vertraulicher Datenverarbeitung"
+ },
+ "auth": {
+ "signIn": "Anmelden",
+ "signOut": "Abmelden",
+ "email": "E-Mail",
+ "password": "Passwort"
+ }
+ // ... continue with all keys
+}
+```
+
+### 2. Update iOS Configuration
+
+Edit `src-tauri/gen/apple/maple_iOS/Info.plist` and add your language code:
+
+```xml
+