# π·πΌ GIP Rwanda Translator
**Kinyarwanda β English translation app** built for the GIP Rwanda Community β students and remote teams working across language barriers.
---
## Features
- **Kinyarwanda β English** and **English β Kinyarwanda** translation
- **Auto-translate** as you type (debounced)
- **Quick Phrases** tab with 25+ common greetings and work expressions
- **Translation History** β last 30 translations saved in the browser
- **Copy** button to paste directly into WhatsApp, Slack, email, etc.
- **Text-to-Speech** for both input and output
- **Tips** tab with usage guidance
- Mobile-friendly responsive layout
- API key stays server-side (never exposed to users)
---
## Project Structure
```
gip-rwanda-translator/
βββ api/
β βββ translate.js β Serverless API route (keeps API key secret)
βββ public/
β βββ index.html β Full frontend app
βββ vercel.json β Vercel routing config
βββ package.json
βββ .gitignore
βββ README.md
```
---
## Deployment to Vercel
### Step 1 β Get an Anthropic API Key
1. Go to
console.anthropic.com
2. Create an account or log in
3. Go to **API Keys** β click **Create Key**
4. Copy the key (starts with `sk-ant-...`)
---
### Step 2 β Upload to GitHub
1. Create a new repository on
github.com
2. Upload all these project files into the repo
- You can drag & drop in the GitHub web UI, or use Git:
```bash
git init
git add .
git commit -m "Initial commit"
git remote add origin
github.com
git push -u origin main
```
---
### Step 3 β Deploy on Vercel
1. Go to
vercel.com and sign in (free account)
2. Click **Add New β Project**
3. Import your GitHub repository
4. Leave all build settings as default
5. **Before deploying**, add the environment variable:
- Click **Environment Variables**
- Name: `ANTHROPIC_API_KEY`
- Value: `sk-ant-...` (your key from Step 1)
6. Click **Deploy**
Vercel will give you a live URL like `
gip-rwanda-tra β¦