منصوبے کے بارے میں

WebSight ایک اوپن سورس، پرائیویسی فرسٹ ویب اینالیٹکس پروجیکٹ ہے۔ اس کا مقصد سائٹ مالکان کو وہ اعداد و شمار فراہم کرنا ہے جن کی انہیں ضرورت ہے، بغیر وزیٹرز کو ایک پروڈکٹ بنائے: یہ کوئی کوکیز استعمال نہیں کرتا، کوئی کراس سائٹ ٹریکنگ نہیں کرتا، اور کوئی ذاتی ڈیٹا جمع نہیں کرتا۔ یہ ایک ہوسٹڈ ایپ اور ایسے سافٹ ویئر کے طور پر پیش کیا گیا ہے جسے آپ مکمل طور پر اپنے انفراسٹرکچر پر چلا سکتے ہیں۔ ٹریکنگ اور سیٹ اپ ٹریکر کو ہلکا پھلکا ڈیزائن کیا گیا ہے: کور اسکرپٹ 1KB سے کم ہے، جو async اور deferred لوڈ ہوتا ہے۔ انٹیگریشن دو طریقوں سے کی جا سکتی ہے۔ سب سے سادہ طریقہ ایک سنگل deferred اسکرپٹ ٹیگ ہے جو ہوسٹڈ ٹریکر کی طرف اشارہ کرتا ہے، جس میں ٹارگٹ سائٹ کا نام data-site ایٹریبیوٹ کے ذریعے دیا جاتا ہے۔ دیگر data-* ایٹریبیوٹس پیکیج آپشنز کے ساتھ ایک سے ایک میپ ہوتے ہیں، جن میں persistence mode، Core Web Vitals سیمپلنگ، اور ایڈمن یا ہیلتھ چیک روٹس کے لیے پاتھ ایکسلوزنز شامل ہیں۔ متبادل طور پر، websight نامی ایک npm پیکیج کو بلڈ میں شامل کیا جا سکتا ہے، جو ٹائپڈ init کال کے ساتھ ساتھ کسٹم ایونٹس کے لیے track اور identify فنکشنز فراہم کرتا ہے؛ track اور identify کو init سے پہلے کال کیا جا سکتا ہے اور وہ ٹریکر کے بوٹ ہونے تک کیو (queue) میں رہتے ہیں۔ ایک React انٹیگریشن بھی Analytics کمپوننٹ کے ذریعے فراہم کی گئی ہے جسے روٹ لے آؤٹ میں ماؤنٹ کرنے کے لیے ڈیزائن کیا گیا ہے۔ اینالیٹکس کی صلاحیتیں README میں ایک ریئل ٹائم ڈیش بورڈ کا ذکر ہے جس میں لائیو وزیٹر موجودگی دکھائی دیتی ہے جو تاخیر کے بجائے ایونٹس کے آتے ہی اپ ڈیٹ ہوتی ہے، اور ایک گھومنے والا 3D گلوب ہے جو ظاہر کرتا ہے کہ موجودہ قارئین کہاں واقع ہیں۔ سیشن ری پلے rrweb کے ذریعے چلتا ہے اور اسے پرائیویسی ماسکڈ کے طور پر بیان کیا گیا ہے، جسے ڈیش بورڈ سے فی سائٹ فعال کیا جا سکتا ہے۔ رویے کے تجزیے (behavior analysis) کے لیے، پروجیکٹ کسٹم ایونٹس، کنورژن فنلز، گولز اور ریٹینشن کوہورٹس، اور فلٹرز اور سیگمنٹس کو کور کرتا ہے جنہیں سورس، ملک، ڈیوائس یا کیمپین کے لحاظ سے تقسیم کیا جا سکتا ہے۔ Core Web Vitals اور JavaScript ایرر کیپچر دستیاب ہیں اور ضرورت پڑنے پر لوڈ ہوتے ہیں۔ پرائیویسی پوزیشن کوکی لیس، اسٹیٹ لیس ٹریکنگ ڈیفالٹ ہے ۔ README کا دعویٰ ہے کہ یہ طریقہ GDPR، CCPA اور PECR کے لیے موزوں ہے اور وزیٹرز کے لیے کسی رضامندی کی ضرورت نہیں ہے۔ کسی بھی سائٹ کے لیے پبلک شیئر لنکس بنائے جا سکتے ہیں اور اختیاری طور پر پاس ورڈ سے محفوظ کیے جا سکتے ہیں۔ پروجیکٹ MIT لائسنس کے تحت ہے اور مکمل طور پر سیلف ہوسٹ ایبل ہے۔ آرکیٹیکچر اور سیلف ہوسٹنگ WebSight ایک سنگل Next.js ایپلی کیشن ہے جس کے پیچھے Supabase Postgres ڈیٹا بیس ہے۔ ٹریکر ایپ کی پبلک ڈائریکٹری میں رہتا ہے، اس لیے کسی علیحدہ سروس کو چلانے کی ضرورت نہیں ہے: ایک Next.js ایپ جو ایک Supabase پروجیکٹ کی طرف اشارہ کرتی ہے۔ README میں سیلف ہوسٹنگ کے مراحل میں ریپوزٹری کو کلون کرنا، انوائرمنٹ ایگزیمپل فائل کو کاپی کرنا اور Supabase کیز اور ایپ URL کو بھرنا، ڈیپینڈنسز انسٹال کرنا، بلڈ کرنا اور اسٹارٹ کرنا شامل ہے۔ supabase/migrations کے تحت مائیگریشنز کو Supabase CLI کے ساتھ اپلائی کیا جاتا ہے، جس کے بعد ایپ کو Vercel یا کسی دوسرے Node ہوسٹ پر ڈیپلائے کیا جا سکتا ہے۔ README میں ذکر ہے کہ انوائرمنٹ ویری ایبلز اور geo/CDN کے حوالے سے ایک مکمل گائیڈ آن لائن سیلف ہوسٹنگ گائیڈ میں موجود ہے۔ README میں نامزد ٹیک اسٹیک میں Next.js 16، React 19، TypeScript، Tailwind CSS v4، Postgres کے لیے Supabase، Recharts، 3D گلوب کے لیے three-globe، اور سیشن ری پلے کے لیے rrweb شامل ہیں؛ ٹریکر کو زیرو ڈیپینڈینسی کے طور پر بیان کیا گیا ہے اور اسے tsup کے ساتھ بنایا گیا ہے۔ کمیونٹی اور لائسنس Issues اور pull requests کا خیرمقدم کیا جاتا ہے، اور دستاویزات پروجیکٹ کی اپنی docs سائٹ پر ہوسٹ کی گئی ہیں۔ پروجیکٹ MIT لائسنس کے تحت ہے، جسے استعمال کرنے اور سیلف ہوسٹ کرنے کے لیے مفت بیان کیا گیا ہے۔