Open-source Tunisian Arabizi converter — Next.js web app and Chrome extension powered by Google Gemini.
# Arabizzi
Convert Tunisian Arabic written in Latin script (Arabizi) into **Arabic script** or **Modern Standard Arabic (Fusha)**, powered by Google Gemini.
**Website:** arabizzi.com · **GitHub:** Abdelkaderbzz/arabizzi · **Chrome extension:** Web Store
This repository includes a **Next.js web app** and a **Chrome extension** that share the same conversion logic and bilingual UI.
## What's in this repo
| Path | Description |
| --- | --- |
| `app/`, `components/` | Next.js web application |
| `extension/` | Chrome extension (Manifest V3, self-contained) |
| `netlify-landing/` | Marketing site, releases, and privacy policy |
## Features
### Web app
- Latin (Arabizi) → Tunisian Arabic script or Fusha (MSA)
- Bilingual interface (English / Arabic) with RTL support
- Fusha / Tunisian output mode selector
- One-click copy, clickable examples
- Recent conversions and saved bookmarks
- Response caching to reduce API calls
### Chrome extension
- Toolbar popup with the same Fusha / Tunisian modes
- Bring-your-own Gemini API key (stored locally in the browser)
- Copy output and recent history (last 10)
- Saved bookmarks for conversions you want to keep
- English / Arabic interface
See extension/README.md for extension-specific setup and publishing steps.
## Examples
| Latin Input | Tunisian Output | MSA Output |
| --- | --- | --- |
| 3aslema | عسلامة | السلام عليكم |
| chneya 7alek? | شنية حالك؟ | كيف حالك؟ |
| taw nemchi lel dar | توا نمشي للدار | سأذهب إلى المنزل الآن |
## Tech stack
- Next.js 16 (App Router)
- TypeScript
- Tailwind CSS + shadcn/ui
- Google Gemini (`gemini-2.5-flash`) via Vercel AI SDK
- Chrome Extension Manifest V3
## Getting started (web app)
### Prerequisites
- Node.js 20+
- pnpm 9+
- A free Google AI Studio API key
### Installation
1. Clone the repository:
```bash
git clone
github.com
cd arabizzi
```
2. Install dependencies:
```bash
pnpm install
```
3. Set up environment variables:
```bash
cp …