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

Shadcn Admin Dashboard ایک ایڈمن ڈیش بورڈ UI ہے جو Shadcn اور Vite سے تیار کیا گیا ہے، اور اسے ریسپانسیونس اور قابلِ رسائی کو مدنظر رکھ کر ڈیزائن کیا گیا ہے۔ مصنف نے اسے کام اور ذاتی پروجیکٹس سے لیے گئے ڈیش بورڈ UI پیٹرنز کے قابلِ استعمال مجموعے کے طور پر بنایا ہے، جس میں کچھ کوڈ براہِ راست ShadcnUI کی مثالوں سے اخذ کیے گئے ہیں۔ README میں واضح طور پر بتایا گیا ہے کہ یہ کوئی اسٹارٹر پروجیکٹ یا ٹیمپلیٹ نہیں ہے، اگرچہ مستقبل میں ایسا بنایا جا سکتا ہے۔ درج کردہ اہم خصوصیات میں لائٹ/ڈارک موڈ، ریسپانسیو لے آؤٹ، قابلِ رسائی، بلٹ اِن سائیڈ بار کمپوننٹ، گلوبل سرچ کمانڈ، 10 سے زائد صفحات، اضافی کسٹم کمپوننٹس، اور RTL (دائیں سے بائیں) سپورٹ شامل ہیں۔ ایک قابلِ ذکر تفصیل حسبِ ضرورت Shadcn UI کمپوننٹس کی ہینڈلنگ ہے۔ کچھ کمپوننٹس کو بہتر RTL سپورٹ اور دیگر بہتریوں کے لیے معمولی طور پر تبدیل کیا گیا ہے، جو اصل Shadcn UI ورژنز سے مختلف ہیں۔ README انہیں "Modified Components" (scroll-area، sonner، separator) اور "RTL Updated Components" (alert-dialog، calendar، command، dialog، dropdown-menu، select، table، sheet، sidebar، switch) میں تقسیم کرتا ہے۔ اس میں مشورہ دیا گیا ہے کہ غیر حسبِ ضرورت کمپوننٹس کو Shadcn CLI کے ذریعے اپ ڈیٹ کرنا عموماً محفوظ ہے، جبکہ حسبِ ضرورت بنائے گئے کمپوننٹس کو RTL سپورٹ یا دیگر تبدیلیوں کو برقرار رکھنے کے لیے دستی طور پر ضم کرنے کی ضرورت ہو سکتی ہے۔ اگر RTL سپورٹ کی ضرورت نہ ہو تو RTL-updated کمپوننٹس کو CLI کے ذریعے محفوظ طریقے سے اپ ڈیٹ کیا جا سکتا ہے۔ نفاذ کی تفصیلات src/components/ui/ میں موجود ہیں۔ ٹیک اسٹیک یہ ہے: UI کے لیے ShadcnUI (TailwindCSS + RadixUI)، بلڈ ٹول کے طور پر Vite، روٹنگ کے لیے TanStack Router، ٹائپ چیکنگ کے لیے TypeScript، لِنٹنگ اور فارمیٹنگ کے لیے ESLint اور Prettier، آئیکنز کے لیے Lucide Icons اور Tabler Icons (صرف برانڈ آئیکنز)، اور جزوی تصدیق کے لیے Clerk۔ مقامی طور پر چلانے کے لیے README میں چار مراحل دیے گئے ہیں: ریپوزٹری کلون کریں، پروجیکٹ ڈائریکٹری میں جائیں، pnpm install سے انحصارات انسٹال کریں، اور pnpm run dev سے سرور شروع کریں۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے اور @satnaing کے زیر انتظام ہے، جس میں اسپانسرشپ کے اختیارات موجود ہیں اور Clerk کو موجودہ اسپانسر کے طور پر درج کیا گیا ہے۔