عن المشروع
تُعد create-t3-app أداة سطر أوامر تفاعلية لبدء تطبيق Next.js كامل المسار وآمن الأنواع. وبدلاً من تقديم قالب ثابت واحد، تقوم واجهة سطر الأوامر (CLI) باستعراض مطالبات وتوليد مشروع بناءً على الخيارات المحددة، بحيث يكون كل جزء من المكدس (stack) اختيارياً ويمكن تضمينه أو تخطيه حسب احتياجات التطبيق.
يصف ملف README الأداة بأنها جزء من "T3 Stack"، وهو مكدس لتطوير الويب يركز على البساطة، والمعيارية، وأمان الأنواع في كامل المسار. وتشمل التقنيات التي يشير إليها Next.js وtRPC وTailwind CSS وTypeScript وPrisma وDrizzle وNextAuth.js.
يحدد المشروع ثلاثة مبادئ توجيهية في ملف README الخاص به. أولاً، حل المشكلات: يجب أن تعالج الإضافات مشكلة محددة ضمن التقنيات الأساسية، لذا يتم استبعاد أشياء مثل مكتبات إدارة الحالة (zustand، redux) عمداً بينما يتم تضمين المصادقة وتكامل ORM/API. ثانياً، "المخاطرة بمسؤولية" (bleed responsibly): تُستخدم التقنيات الأحدث والأكثر خطورة في المناطق الأقل أهمية، مع تفضيل قواعد بيانات SQL على تقنيات قواعد البيانات غير المثبتة. ثالثاً، يتم التعامل مع أمان الأنواع (typesafety) كأمر غير اختياري، وتعتبر القرارات التي تساوم عليه خارج نطاق المشروع.
يتم البدء من خلال أمر الإنشاء الخاص بمدير الحزم: `npm create t3-app@latest` أو `yarn create t3-app` أو `pnpm create t3-app@latest` أو `bun create t3-app@latest`؛ وبعد ذلك تطرح واجهة سطر الأوامر (CLI) أسئلة التكوين الخاصة بها. يتم توثيق الاستخدام الأكثر تقدماً على موقع المشروع الإلكتروني.
يشير ملف README إلى مجتمع Discord للحصول على المساعدة، ومناقشة أفضل الممارسات، وإرشادات المساهمة، ويطلب من المساهمين قراءة إرشادات المساهمة (Contributing Guidelines) قبل فتح مشكلة (issue) أو طلب سحب (pull request) حتى يفهموا استراتيجية التفرع وبيئة التطوير المحلية. كما يتم عرض معرض للمساهمين وإسناد الفضل لشركة Vercel.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.