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

OpenBand ایک اوپن سورس، لوکل فرسٹ میوزک پروڈکشن پلیٹ فارم ہے جو بنیادی طور پر براؤزر میں چلتا ہے، اور اسے Expo Router، React Native Web اور TypeScript کے ساتھ بنایا گیا ہے۔ اسے ایک ایسی جگہ کے طور پر پیش کیا گیا ہے جہاں موسیقی کے خیال کو ان مراحل سے گزر کر آگے بڑھایا جا سکتا ہے جنہیں README میں start، hear، shape، finish، اور keep or share کہا گیا ہے، بغیر کسی اکاؤنٹ کے دریافت کرنے کی ضرورت۔ ریپوزٹری میں بیان کردہ بنیادی صلاحیتوں میں ملٹی ٹریک آڈیو ریکارڈنگ اور ترتیب، پینو رول کے ساتھ MIDI، لوپر اور کورڈ ٹریک، سیمپلر، سنتھ اور بیٹ میکر، amp/cab ماڈلنگ چینز کے ساتھ گٹار پیڈل بورڈ، اسٹیم سیپریشن (اختیاری طور پر لوکل Demucs کے ذریعے)، ٹیوننگ اور ٹائم/پچ ٹولز، اور ایک مکسزر شامل ہے جس میں ایفیکٹس، بسز، سنیپ شاٹس، LUFS میٹرنگ، ماسٹرنگ اور ایکسپورٹ شامل ہیں۔ فوکسڈ تخلیقی موڈز اور 3D اسٹوڈیو رومز کا بھی ذکر کیا گیا ہے۔ تعاون کی خصوصیات جیسے presence، CRDT پر مبنی ایڈیٹنگ اور branching کو ارتقا پذیر اور اختیاری بیک اینڈ سروسز پر منحصر قرار دیا گیا ہے۔ دستیابی کو واضح طور پر الفا کے طور پر پیش کیا گیا ہے۔ ویب ایپ عوامی طور پر ڈیمو کے طور پر قابل رسائی ہے؛ الیکٹران ڈیسک ٹاپ، اینڈرائیڈ اور آئی او ایس دستخط شدہ اسٹور ریلیز کے بجائے سورس سے بلڈ کرنے کے اہداف ہیں۔ README میں کہا گیا ہے کہ جب تک کوئی تصدیق شدہ ریلیز لنک موجود نہ ہو، کوئی موبائل اسٹور لسٹنگ یا دستخط شدہ ڈیسک ٹاپ ڈاؤن لوڈ کا دعویٰ نہیں کیا جاتا، اور صارفین کو متنبہ کیا گیا ہے کہ وہ اہم کام کے آزاد بیک اپ رکھیں۔ مقامی طور پر چلانے کے لیے Node.js 22 یا نیا اور npm درکار ہے؛ Python 3.12 صرف لوکل Demucs اسٹیم سیپریشن کے لیے ضروری ہے۔ فرنٹ اینڈ بغیر .env فائل کے ڈیولپمنٹ فال بیکس کے ساتھ شروع ہو سکتا ہے، جنہیں README میں پروڈکشن سروسز کے ثبوت کے بجائے تلاش اور جانچ کے لیے بتایا گیا ہے۔ ایک اختیاری Express API مقامی ڈیولپمنٹ کے لیے بطور ڈیفالٹ SQLite استعمال کرتی ہے، جس میں Supabase/PostgreSQL اور آبجیکٹ اسٹوریج بطور ہوسٹڈ آپشنز ہیں۔ ڈیسک ٹاپ بلڈز OpenBandNative برج کے پیچھے الیکٹران کے ذریعے چلتے ہیں، اور فرنٹ اینڈ اسکرینوں کو براہ راست الیکٹران APIs کو کال نہیں کرنا چاہیے۔ آرکیٹیکچر پرت دار ہے: UI (Expo Router، React، React Native Web، TypeScript) ایک ٹائپ شدہ میوزک اور پروجیکٹ کور سے بات کرتا ہے، جو مقامی پروجیکٹ اور اثاثہ اسٹورز، Web Audio / expo-audio / WASM آڈیو، اور اختیاری API سے جڑتا ہے۔ اسٹائلنگ NativeWind/Tailwind ٹوکنز استعمال کرتی ہے، اسٹیٹ جہاں مناسب ہو React context اور Zustand استعمال کرتی ہے، اور توثیق میں TypeScript، Vitest، Playwright smoke tests اور آرکیٹیکچر گراف چیکس شامل ہیں۔ مفید کمانڈز میں npm run lint، npm test، npm run test:legacy، npm run test:graph-sdd، npm run graph:ci اور npm run build شامل ہیں، جس میں بیک اینڈ ٹائپ چیکنگ npx tsc --noEmit کے ذریعے کی جاتی ہے۔ دستاویزات الفا کے لیے غیر معمولی طور پر مکمل ہیں: پروڈکٹ حکمت عملی، آرکیٹیکچر، بلڈ سیٹ اپ، فیچر نفاذ کی حیثیت، روڈ میپ، معاہدے، آرکیٹیکچر ڈیسیژن ریکارڈز، مارکیٹنگ فاؤنڈیشن اور اسکرین شاٹ/UI آڈٹ وضاحتیں۔ شراکت PR-first ہے، بڑی تبدیلیوں کے لیے GitHub Spec Kit استعمال کرتی ہے، اور اس میں AGENTS.md پالیسی ہے۔ ریپوزٹری اپنے بیج کے مطابق MIT شرائط کے تحت ہے، حالانکہ README نوٹ کرتا ہے کہ ڈیپینڈنسیز، ماڈلز، نمونے اور تخلیق کار کے فراہم کردہ مواد اپنی شرائط برقرار رکھتے ہیں، اور انتساب اور تیسرے فریق کے نوٹس لانچ ریویو آئٹم ہیں۔ پروجیکٹ کا نام برانڈ کلیئرنس کے زیر التوا ایک ورکنگ نام کے طور پر بیان کیا گیا ہے۔