Skip to content

Repository files navigation

📝 Arabic Pro Tools - أدوات العربية الاحترافية

License: MIT TypeScript Vue.js

A comprehensive Chrome extension for Arabic language users with advanced grammar checking, translation, conversion, and more.

إضافة Chrome شاملة للمتحدثين باللغة العربية مع تدقيق نحوي متقدم، ترجمة، تحويل نصوص، وأكثر.

العربية | English


🌟 Features | الميزات

✍️ Smart Arabic Editor & Grammar Checker

  • Real-time grammar and spell checking
  • Support for Modern Standard Arabic and dialects (Egyptian, Gulf, Levantine)
  • Style suggestions and readability analysis
  • Punctuation correction
  • Text statistics and difficulty level analysis

🔄 Arabic Text Converter

  • Add/remove diacritics (Tashkeel)
  • Convert between number systems (Arabic ١٢٣ ⟷ English 123)
  • Number to text conversion (123 → مائة وثلاثة وعشرون)
  • Franco-Arab transliteration (ahlan → أهلا)
  • Arabic punctuation conversion

⌨️ Smart Keyboard

  • Franco-Arab input support
  • Auto-suggestions while typing
  • Quick diacritic insertion
  • Special Arabic symbols
  • Auto-correction

🌐 Contextual Translator

  • Context-aware translation
  • Arabic dialects support
  • Alternative translations
  • Confidence scoring
  • Save translations for later

📚 Comprehensive Arabic Dictionary

  • Word meanings from multiple sources
  • Root extraction
  • Synonyms and antonyms
  • Word conjugations
  • Examples from Quran, Hadith, and poetry
  • Text-to-speech pronunciation

🚀 Quick Start | البدء السريع

Installation | التثبيت

# Clone the repository
git clone https://github.com/yourusername/arabic-pro-tools.git

# Navigate to project directory
cd arabic-pro-tools

# Install dependencies
npm install

# Build the extension
npm run build

# Load in Chrome
# 1. Open chrome://extensions/
# 2. Enable "Developer mode"
# 3. Click "Load unpacked"
# 4. Select the 'dist' folder

Development | التطوير

# Start development server
npm run dev

# Build for production
npm run build

# Run linting
npm run lint

📖 Usage Examples | أمثلة الاستخدام

Grammar Checking | التدقيق النحوي

Input:  "إنشاء الله سأذهب إلى المدرسة، ولاكن الطقس سيء."
Output:
   "إنشاء الله"  "إن شاء الله"
   "لاكن"  "لكن"
  ⚠️ Use Arabic comma (،) instead of (,)

Text Conversion | تحويل النص

// Diacritics
removeDiacritics("الحَمْدُ للهِ")  // → "الحمد لله"
addDiacritics("السلام عليكم")      // → "السَّلَامُ عَلَيْكُم"

// Numbers
convertNumbers("عمري 25 سنة", 'arabic')   // → "عمري ٢٥ سنة"
numberToWords(123)                        // → "مائة وثلاثة وعشرون"

// Franco-Arab
transliterate("ahlan wa sahlan")  // → "أهلا وسهلا"

Translation | الترجمة

translate("Hello, how are you?", 'en', 'ar')
// → {
//   translatedText: "مرحباً، كيف حالك؟",
//   confidence: 95,
//   alternatives: ["أهلاً، كيف حالك؟", "مرحبا، كيف الحال؟"]
// }

Dictionary Lookup | البحث في المعجم

lookup("علم")
// → {
//   word: "علم",
//   root: "ع-ل-م",
//   meanings: ["معرفة، إدراك حقيقة الشيء", "اليقين"],
//   synonyms: ["معرفة", "إدراك", "يقين"],
//   examples: [...]
// }

🛠️ Tech Stack | التقنيات

  • Frontend: Vue.js 3 + TypeScript
  • Build Tool: Vite
  • Extension API: Chrome Manifest V3
  • Storage: IndexedDB
  • Speech: Web Speech API
  • Styling: CSS3 with RTL support

📁 Project Structure | هيكل المشروع

arabic-pro-tools/
├── src/
│   ├── assets/          # Static assets (icons, fonts, styles)
│   ├── background/      # Background service worker
│   ├── components/      # Vue components
│   ├── content/         # Content scripts
│   ├── popup/           # Extension popup
│   ├── services/        # Core services (grammar, translation, etc.)
│   ├── types/           # TypeScript type definitions
│   └── utils/           # Utility functions
├── docs/                # Documentation
├── manifest.json        # Extension manifest
├── package.json         # NPM dependencies
└── tsconfig.json        # TypeScript configuration

🎯 Use Cases | حالات الاستخدام

For Writers & Journalists | للكتّاب والصحفيين

  • Proofread articles before publishing
  • Improve writing style
  • Ensure error-free content
  • Analyze text readability

For Students & Researchers | للطلاب والباحثين

  • Write research papers and reports
  • Language proofreading
  • Dictionary lookups
  • Quick translation

For Social Media Users | لمستخدمي وسائل التواصل

  • Write error-free posts
  • Quick Franco-to-Arabic conversion
  • Use special symbols
  • Instant translation

For Developers | للمبرمجين

  • Write Arabic comments
  • Translate interfaces
  • Arabic documentation

⚙️ Settings | الإعدادات

  • Language: Arabic / English
  • Default Dialect: Fusha, Egyptian, Gulf, Levantine
  • Font: Cairo, Amiri, Tajawal
  • Font Size: 12-24px
  • Theme: Light, Dark, Auto
  • Auto-correct: Enable/Disable
  • Suggestions: Enable/Disable
  • Keyboard Layout: Franco / Standard

🔒 Privacy & Security | الخصوصية والأمان

  • Local Processing: All operations performed locally
  • No Data Collection: Your data never leaves your device
  • No External Servers: No dependency on external APIs
  • Open Source: Code available for review
  • Secure Storage: Data encrypted in IndexedDB

🤝 Contributing | المساهمة

We welcome contributions! Here's how you can help:

  1. Report Bugs: Open an issue
  2. Suggest Features: Share your ideas
  3. Improve Translations: Help with accuracy
  4. Add Dictionary Entries: Expand the dictionary
  5. Code Contributions: Submit pull requests

Development Guidelines

# Fork the repository
# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes
# Commit with clear messages
git commit -m "Add amazing feature"

# Push to your fork
git push origin feature/amazing-feature

# Open a Pull Request

📊 Statistics | الإحصائيات

Track your usage:

  • Words checked
  • Words translated
  • Days used
  • Most used features

📝 License | الترخيص

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgments | شكر وتقدير

Special thanks to:

  • All contributors who made this project possible
  • The Arabic NLP community
  • Vue.js and TypeScript communities

📞 Support & Contact | الدعم والتواصل


🗺️ Roadmap | خارطة الطريق

Version 1.1 (Coming Soon)

  • Advanced NLP integration (Farasa, CAMeL Tools)
  • Voice input support
  • PDF text extraction
  • Browser sync across devices
  • Offline mode enhancements

Version 2.0 (Future)

  • Mobile app companion
  • API for developers
  • Custom dictionaries
  • Team collaboration features
  • Premium features

Made with ❤️ for Arabic speakers worldwide

صُنع بـ ❤️ للمتحدثين بالعربية في كل مكان


Version 1.0.0 | Last Updated: 2025

⬆ Back to Top

About

أداة اللغة العربية المتقدمة

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages