# 🇲🇦 Traduction - English to Darija Translator
A powerful and easy-to-use Chrome extension that translates English to **Darija** (Moroccan Arabic dialect) directly in your browser.
**Version**: 1.0.0
**Type**: Chrome Extension (Manifest V3)
**License**: MIT
---
## 🎯 Features
✅ **Instant Translation** - Select English text → Get Darija translation
âś… **Right-Click Context Menu** - Quick translation with one click
âś… **Side Panel Interface** - Integrated panel with text source and translation
âś… **Multiple API Support** - Claude, OpenAI, Gemini, OpenRouter
âś… **Local Configuration** - Store API keys securely in Chrome storage
âś… **Character Counter** - See word/character count of translations
âś… **Copy to Clipboard** - Easily copy translations
âś… **Error Handling** - Clear error messages for troubleshooting
---
## 🚀 Installation
### Step 1: Clone or Download the Extension
```bash
git clone
cd traductionAya
```
### Step 2: Load in Chrome
1. Open Chrome and go to `chrome://extensions/`
2. Enable **"Developer mode"** (top right corner)
3. Click **"Load unpacked"**
4. Select the `traductionAya` folder
### Step 3: Configure an API Key
1. Click the extension icon
2. Choose a preset (Claude, OpenAI, Gemini, etc.) or enter custom API settings
3. Enter your API key
4. Click **"Save Settings"**
---
## đź’» How It Works
### **Step-by-Step Process**
**①User Selects Text** → Select any English text on a webpage by clicking and dragging
**② Right-Click Menu** → Right-click on the selected text and choose "Translate to Darija"
**③ Capture & Store** → background.js captures the text and stores it in chrome.storage.local
**④ Panel Opens** → The side panel automatically opens on the right side of your browser
**⑤ Load Text** → side-panel.js loads and displays the selected text in the interface
**⑥ Configure API** → Make sure your API key is configured in the extension settings
**⑦ Click Translate** → Click the "Translate" button to send the text to the API
**⑧ API Processin …