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

React-admin ایک فرنٹ اینڈ فریم ورک ہے جسے marmelab برقرار رکھتا ہے، تاکہ REST یا GraphQL APIs کے اوپر براؤزر میں چلنے والی سنگل پیج ایپلی کیشنز بنائی جا سکیں۔ یہ TypeScript میں لکھا گیا ہے اور React اور Material Design پر مبنی ہے، اور اسے npm پر react-admin کے طور پر تقسیم کیا گیا ہے۔ بیک اینڈ سے آزادی: یہ فریم ورک Data Providers نامی اڈاپٹرز کے ذریعے APIs سے بات کرتا ہے۔ README میں Data Provider کی ایک فہرست ہے جس میں 45 سے زیادہ اڈاپٹرز کی دستاویزات موجود ہیں، اور یہ وضاحت کی گئی ہے کہ موجودہ فراہم کنندگان کسی API کے لیے بلو پرنٹ کے طور پر کام کر سکتے ہیں یا کسی موجودہ API سے ڈیٹا حاصل کرنے کے لیے ایک کسٹم Data Provider لکھا جا سکتا ہے۔ بنیادی اجزاء: پروجیکٹ میں ایسے hooks اور components فراہم کیے گئے ہیں جو authentication، routing، forms اور validation، datagrids، search اور filtering، relationships، roles اور permissions، ایک rich text editor، i18n، notifications، menus، theming اور caching کا احاطہ کرتے ہیں۔ یہ accessibility، responsiveness، security، speed اور testability جیسی خصوصیات کے ساتھ ساتھ optimistic rendering، filter-as-you-type، undo، preferences اور saved queries جیسے صارف کے تجربے کے فیچرز بھی فراہم کرتا ہے۔ کسٹمائزیشن: react-admin کو ڈھیلے طور پر جڑے ہوئے React components اور hooks کی لائبریری کے طور پر پیش کیا گیا ہے جو قابل استعمال کنٹرولر لاجک فراہم کرتے ہیں، تاکہ کسی بھی حصے کو آپ کے اپنے حصے سے بدلا جا سکے، مثال کے طور پر ایک کسٹم datagrid، REST کے بجائے GraphQL، یا Material Design کے بجائے ایک مختلف ڈیزائن سسٹم۔ TypeScript کو اختیاری بتایا گیا ہے، لہذا ڈویلپمنٹ TypeScript یا JavaScript میں کی جا سکتی ہے۔ README میں ذکر ہے کہ یہ فریم ورک Material UI، react-hook-form، react-router، react-query اور TypeScript وغیرہ سے چلتا ہے۔ آغاز کرنا: انسٹالیشن npm install react-admin یا yarn add react-admin کے ذریعے کی جاتی ہے۔ دستاویزات میں ایک ٹیوٹوریل، یوٹیوب ویڈیو ٹیوٹوریلز اور ایک مکمل API ریفرنس شامل ہے۔ ریپوزٹری میں مثال کے طور پر ایپلی کیشنز موجود ہیں: ایک سادہ بلاگ جس میں پوسٹس، کمنٹس اور صارفین ہیں جو اینڈ-ٹو-اینڈ ٹیسٹ کے لیے استعمال ہوتے ہیں؛ ایک ای کامرس پوسٹر شاپ ایڈمن جو کہ آفیشل ڈیمو ہے؛ ایک CRM ایپلی کیشن؛ ایک ہیلپ ڈیسک ٹکٹنگ ایپلی کیشن جس میں ریئل ٹائم لاکس اور نوٹیفیکیشنز ہیں؛ اور وہ ایپلی کیشن جو ٹیوٹوریل کی پیروی کرتے ہوئے بنائی گئی ہے۔ README میں بتایا گیا ہے کہ یہ مثالیں سرور کے بغیر کام کرتی ہیں کیونکہ API کلائنٹ سائیڈ پر سیمولیٹ کی گئی ہے۔ ایک کم سے کم استعمال کا نمونہ ایک Admin component دکھاتا ہے جو Resource components کو لپیٹتا ہے جو API اینڈ پوائنٹ کے لیے لسٹ، ایڈٹ اور کریٹ صفحات کا اعلان کرتے ہیں، جس میں پیج components کو List، DataTable، Edit، Create، SimpleForm، DateField، EditButton اور ان پٹ components سے بنایا گیا ہے۔ ڈویلپمنٹ: monorepo ایک makefile استعمال کرتا ہے جس میں make install، make build، make run-simple، make run-demo، make test اور make prettier جیسی کمانڈز شامل ہیں۔ یونٹ ٹیسٹ کے لیے jest، اینڈ-ٹو-اینڈ ٹیسٹ کے لیے cypress استعمال ہوتا ہے، اور ایک git pre-commit hook تبدیل شدہ فائلوں سے متعلق ٹیسٹ چلاتا ہے۔ اس بات کی توقع ہے کہ شراکتیں موجودہ prettier-بیسڈ کوڈنگ اسٹائل کی پیروی کریں اور ان میں یونٹ ٹیسٹ اور دستاویزات شامل ہوں۔ بگ فکس پل ریکویسٹ master برانچ کو ٹارگٹ کرتی ہیں، جبکہ نئے فیچرز اور بریکنگ تبدیلیاں next کو ٹارگٹ کرتی ہیں۔ سپورٹ اور لائسنس: کمیونٹی سپورٹ Discord اور StackOverflow کے ذریعے فراہم کی جاتی ہے، اور کمرشل سپورٹ React-Admin Enterprise Edition کے ذریعے فراہم کی جاتی ہے۔ React-admin MIT لائسنس کے تحت ہے اور کمرشل مقاصد سمیت استعمال کے لیے مفت ہے۔