عن المشروع

عداد زوار GitHub هو أداة مفتوحة المصدر تعرض أعلام دول زوار ملفك الشخصي على README في GitHub. يعمل كواجهة برمجة تطبيقات بدون خادم مُنشرة على Vercel، ولا يتطلب صيانة أو تسجيل حساب. نظرة عامة يقوم المستخدمون بإضافة علامة صورة ماركداون واحدة إلى ملف README الخاص بملفهم الشخصي لعرض مصدر الزوار. تتكامل الخدمة مع واجهة برمجة تطبيقات Flag Counter وتوفر أربعة أنماط عرض: الدول الأعلى، خريطة الأعلام، أعلام من (الولايات المتحدة/كندا)، وعداد صغير. الميزات الرئيسية - تكامل بسطر واحد: أضف سطر ماركداون واحد إلى أي ملف README لملف شخصي على GitHub - لا يتطلب تسجيل: يعمل فورًا باستخدام اسم مستخدم GitHub فقط - أربعة أنماط عرض: قائمة الدول الأعلى، تصور خريطة أعلام، أعلام مُرشحة حسب الموقع، وعداد صغير مدمج - سمات متعددة: افتراضي، داكن، GitHub، GitHub داكن، وشفاف - عدادات مخصصة لكل مستودع: تتبع الزيارات للمستودعات الفردية بشكل منفصل - متوافق مع المعرف الرسمي: يدعم معرفات Flag Counter الحالية للتكامل مع لوحة التحكم - أداة تكوين في الوقت الفعلي: لوحة ويب تفاعلية مع معاينة مباشرة - اختصارات لوحة المفاتيح واستيراد/تصدير التكوين للمستخدمين المتقدمين أنماط العرض 1. الدول الأعلى: شبكة أعلام مرتبة حسب عدد الزوار 2. خريطة الأعلام: تصور جغرافي لمواقع الزوار 3. أعلام من: أعلام مُرشحة تُظهر الزوار من دول محددة (الولايات المتحدة أو كندا) 4. العداد الصغير: عرض مدمج يُظهر إما عدد الأعلام أو عدد زيارات الصفحة حزمة التقنية مبنية بـ Next.js 15، React 19، TypeScript، Tailwind CSS، ومنشورة على Vercel مع تخزين مؤقت عالمي عبر شبكة توصيل المحتوى (CDN). الاستخدام أضف إلى ملف README لملفك الشخصي على GitHub: ![](https://github-visitor-counter-tau.vercel.app/api?username=YOUR_USERNAME) المعلمات الاختيارية تشمل `displayMode`، `theme`، `columns`، `maxflags`، `label`، ألوان مخصصة، والمزيد. يتبع تتبع المستودعات المحدد `repo` أو تنسيق `username/repo` المدمج. يمكن لمستخدمي Flag Counter الحاليين تمرير معلمة `counterId`. الاستضافة الذاتية المشروع مرخص برخصة MIT ويمكن استضافته ذاتيًا عبر نشر Vercel أو التطوير المحلي باستخدام `npm run dev`. جميع أكواد المصدر متوفرة في المستودع.