প্রকল্প সম্পর্কে

GitHub Visitor Counter হলো একটি ওপেন-সোর্স টুল যা আপনার GitHub প্রোফাইল README-তে ভিজিটরদের দেশের পতাকা প্রদর্শন করে। এটি Vercel-এ ডেপ্লয় করা একটি সার্ভারলেস API হিসেবে চলে, যার জন্য কোনো রক্ষণাবেক্ষণ বা অ্যাকাউন্ট রেজিস্ট্রেশনের প্রয়োজন নেই। ## ওভারভিউ ব্যবহারকারীরা তাদের GitHub প্রোফাইলে একটি মাত্র মার্কডাউন ইমেজ ট্যাগ যোগ করে ভিজিটররা কোথা থেকে আসছেন তা দেখাতে পারেন। এই পরিষেবাটি Flag Counter API-এর সাথে সমন্বিত এবং চারটি ডিসপ্লে মোড প্রদান করে: Top Countries, Flag Map, Flags From (US/CA), এবং Mini Counter। ## মূল বৈশিষ্ট্যসমূহ - **এক লাইনের ইন্টিগ্রেশন**: যেকোনো GitHub প্রোফাইল README-তে একটি মাত্র মার্কডাউন লাইন যোগ করুন - **রেজিস্ট্রেশনের প্রয়োজন নেই**: শুধুমাত্র একটি GitHub ইউজারনেমের মাধ্যমে তাৎক্ষণিকভাবে কাজ করে - **চারটি ডিসপ্লে মোড**: শীর্ষ দেশগুলোর তালিকা, ফ্ল্যাগ ম্যাপ ভিজ্যুয়ালাইজেশন, লোকেশন-ফিল্টার করা পতাকা এবং একটি কমপ্যাক্ট মিনি কাউন্টার - **একাধিক থিম**: Default, Dark, GitHub, GitHub Dark, এবং Transparent - **প্রতি-রিপোজিটরি কাউন্টার**: পৃথকভাবে প্রতিটি রিপোজিটরির ভিজিট ট্র্যাক করুন - **অফিসিয়াল ID সামঞ্জস্যপূর্ণ**: ড্যাশবোর্ড ইন্টিগ্রেশনের জন্য বিদ্যমান Flag Counter ID সমর্থন করে - **রিয়েল-টাইম কনফিগারেশন টুল**: লাইভ প্রিভিউ সহ ইন্টারঅ্যাক্টিভ ওয়েব ড্যাশবোর্ড - **পাওয়ার ইউজারদের জন্য কিবোর্ড শর্টকাট এবং কনফিগ ইমপোর্ট/এক্সপোর্ট সুবিধা** ## ডিসপ্লে মোডসমূহ ১. **Top Countries**: ভিজিটর সংখ্যার ভিত্তিতে সাজানো পতাকার গ্রিড ২. **Flag Map**: ভিজিটরদের অবস্থানের ভৌগোলিক ম্যাপ ভিজ্যুয়ালাইজেশন ৩. **Flags From**: শুধুমাত্র নির্দিষ্ট দেশ (US বা কানাডা) থেকে আসা ভিজিটরদের ফিল্টার করা পতাকা ৪. **Mini Counter**: পতাকার সংখ্যা অথবা পেজ ভিউ দেখানোর কমপ্যাক্ট ডিসপ্লে ## টেক স্ট্যাক এটি Next.js 15, React 19, TypeScript, Tailwind CSS দিয়ে তৈরি এবং গ্লোবাল CDN ক্যাশিং সহ Vercel-এ ডেপ্লয় করা হয়েছে। ## ব্যবহারবিধি আপনার GitHub প্রোফাইল README-তে যোগ করুন: ``` ![](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` এর মাধ্যমে লোকাল ডেভেলপমেন্টের মাধ্যমে সেলফ-হোস্ট করা যেতে পারে। সমস্ত সোর্স কোড রিপোজিটরিতে উপলব্ধ।