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

CNA Templates، npm پر شائع ہونے والا create-awesome-node-app CLI کے لیے آفیشل ٹیمپلیٹ اور ایکسٹینشن ریپوزٹری ہے۔ اس کا مقصد ڈویلپرز کو اسکیفولڈنگ کے منتخب کردہ اسٹارٹنگ پوائنٹس اور اختیاری ایڈونز فراہم کرنا ہے جنہیں نیا Node-based پروجیکٹ بناتے وقت یکجا کیا جا سکتا ہے۔ ٹیمپلیٹس اور استعمال اس ریپوزٹری میں دس اسٹارٹر ٹیمپلیٹس فراہم کیے گئے ہیں، جن میں سے ہر ایک کی اپنی README اور متعلقہ CLI ٹائپ ہے: React Vite (فرنٹ اینڈ ایپس کے لیے react)، Next.js (فل اسٹیک کے لیے nextjs)، Next.js SaaS AI (SaaS اور AI ایپلی کیشنز کے لیے nextjs-saas-ai)، NestJS (بیک اینڈ APIs کے لیے nestjs-backend)، Remix / React Router v7 (فل اسٹیک کے لیے remix)، Astro (کنٹینٹ سائٹس کے لیے astro)، Hono (ہلکے پھلکے APIs کے لیے hono)، Turborepo (monorepo)، WebdriverIO (اینڈ-ٹو-اینڈ ٹیسٹنگ کے لیے webdriverio) اور WebExtension React Vite (براؤزر ایکسٹینشنز کے لیے webextension-react)۔ اسکیفولڈنگ یا تو npx create-awesome-node-app کے ذریعے انٹرایکٹو طریقے سے کام کرتی ہے یا ٹیمپلیٹ اور ایڈونز کا نام دے کر نان-انٹرایکٹو طریقے سے، مثال کے طور پر --template react-vite-boilerplate --addons material-ui zustand۔ ایک ویب سائٹ پر ٹیمپلیٹ اور ایکسٹینشن کے قابلِ براؤز کیٹلاگ موجود ہیں۔ دستاویزات اور تیاری docs ڈائریکٹری میں ٹائپ سسٹم اور جنریشن فلو کے ساتھ سسٹم کا جائزہ، تیاری کے طریقہ کار (فائل لے آؤٹ، EJS متغیرات، package/ سسٹم، جس کا ہسپانوی ترجمہ بھی موجود ہے)، مقامی ٹیسٹنگ اور CI ورک فلو گائیڈ، اور ایک مینٹیننس رن بک شامل ہے جو ٹیمپلیٹس، ایکسٹینشنز، CI، ڈیپینڈنسیز، سیکیورٹی اور ریلیزز کے آپریشنل طریقہ کار بیان کرتی ہے۔ CONTRIBUTING.md میں بتایا گیا ہے کہ نئے ٹیمپلیٹس اور ایکسٹینشنز کیسے شامل کیے جائیں۔ تصدیق کا ماڈل کوالٹی کنٹرول کو چار تہوں والے GitHub Actions ورک فلو میں منظم کیا گیا ہے۔ L0 انٹیگریٹی چیکس رجسٹری پاتھز، دستاویزات کے لنکس، اثاثوں اور پروفائلز کی جانچ کرتا ہے۔ L1 ٹیمپلیٹس ہر ٹیمپلیٹ کو الگ سے بلڈ کرتا ہے۔ L2 ایکسٹینشنز ایک کینونیکل ٹیمپلیٹ کے خلاف ایک ایکسٹینشن کا ٹیسٹ کرتا ہے۔ L3 پروفائلز ہر کیٹیگری کے منتخب کردہ اسٹیکس کو آزماتا ہے۔ پل ریکویسٹ (Pull requests) کے لیے L0 اور L1 پاس کرنا ضروری ہے، جبکہ متاثرہ پاتھز کے لیے L2 اور L3 چلتے ہیں؛ ہفتہ وار رن تمام تہوں کا احاطہ کرتا ہے۔ README میں واضح طور پر درج ہے کہ گرین CI کا مطلب یہ ہے کہ ٹیمپلیٹس اور حقیقت پسندانہ انتخاب کام کرتے ہیں، نہ کہ یہ کہ ہر ایکسٹینشن کو ایک ہی مشترکہ ایپلی کیشن میں ضم کیا جا سکتا ہے۔ ریپوزٹری میں ایک قابلِ استعمال مینٹیننس پرامپٹ بھی شامل ہے جو اس ایکو سسٹم پر کام کرنے والے AI اسسٹنٹس کے لیے ہے، جس میں پری فلائٹ چیکس، ایشو-فرسٹ ورک فلو، فی پل ریکویسٹ ایک فکس، انگریزی زبان میں کمٹس اور دستاویزات، پش کرنے سے پہلے مقامی تصدیق، اور مینوئل ٹوکن کے بجائے OIDC کے ذریعے npm Trusted Publishing شامل ہے۔ یہ پروجیکٹ MIT لائسنس کے تحت ہے، Node 22 یا اس سے نئے ورژن کو ٹارگٹ کرتا ہے، اور سپورٹ کے لیے ڈسکارڈ کمیونٹی، ایشو ٹریکر اور مباحثے (discussions) فراہم کرتا ہے۔