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.

• 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

• 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.

• Next.js 16 (App Router)
• TypeScript
• Tailwind CSS + shadcn/ui
• Google Gemini (gemini-2.5-flash) via Vercel AI SDK
• Chrome Extension Manifest V3

• Node.js 20+
• pnpm 9+
• A free Google AI Studio API key

1. Clone the repository:

git clone https://github.com/Abdelkaderbzz/arabizzi.git
cd arabizzi

2. Install dependencies:

pnpm install

3. Set up environment variables:

cp .env.example .env

Add your Gemini API key to .env:

GOOGLE_GENERATIVE_AI_API_KEY=your_api_key_here

4. Start the development server:

pnpm dev

Open http://localhost:3000.

1. Open chrome://extensions
2. Enable Developer mode
3. Click Load unpacked and select the extension/ folder
4. Open the extension settings (gear icon) and paste your Gemini API key

Full details: extension/README.md

pnpm dev      # run web app locally
pnpm landing  # static landing page (port 5174)
pnpm build    # production build
pnpm start    # start production server
pnpm lint     # run ESLint

Pull requests run CI automatically: Lint, Build, and Extension checks must pass before merge.

├── app/                 # Next.js routes and API
│   └── api/convert/     # Gemini conversion endpoint
├── components/          # React UI components
├── contexts/            # Language and history state
├── extension/           # Chrome extension source
├── lib/                 # Conversion and usage helpers
├── netlify-landing/     # Landing, releases, privacy (Web Store)
├── translations/        # English and Arabic strings
└── types/               # TypeScript declarations

The Chrome extension stores the API key and preferences locally. Conversion text is sent only to Google's Gemini API. The privacy policy lives at arabizzi.com/privacy.html (netlify-landing/privacy.html).

We welcome contributions from the community.

1. Read CONTRIBUTING.md for setup and PR guidelines
2. Follow our Code of Conduct
3. Fork the repository, create a branch, and open a pull request

To report a security vulnerability, please read SECURITY.md and contact us privately. Do not open public issues for security reports.

This project is licensed under the MIT License.

• Built for the Tunisian Arabic community
• Powered by Google Gemini
• UI components from shadcn/ui