kirimase

ملحوظة

ملاحظة: يتم معالجة الأخطاء الهامة فقط في الوقت الحالي لأننا نخطط لإعادة كتابة كاملة في المستقبل القريب جدًا!

كيريماز

Kirimase هي أداة سطر أوامر لبناء تطبيقات Full-Stack Next.js بشكل أسرع . إنه يتفوق على سير عمل التنمية الخاص بك ، مما يتيح لك دمج الحزم وموارد السقالات بسرعة لتطبيقك مع وضع أفضل الممارسات في الاعتبار.

شاهد أحدث عرض تجريبي هنا

تحقق من البرنامج التعليمي الرسمي هنا

سمات

1. التهيئة والتكوين : أضف وسرعان ما أضف وإعداد الحزم الأساسية لبدء مشروع NEXT.JS.
2. توليد الكود : نماذج السقالات ، وجهات النظر ، ووحدات التحكم مباشرة من CLI.

بداية سريعة

تثبيت Kirimase CLI على مستوى العالم:

npm install -g kirimase

إذا لم يكن لديك بالفعل تطبيق NEXTJS ، فقم بتشغيل إنشاء Next-Next مع مدير الحزمة المفضل لديك.

ثم قم بتشغيل الأمر التالي داخل دليل مشروعك:

kirimase init

ملاحظة: Kirimase غير متوافق مع دليل الصفحات.

الأوامر

قم بتشغيل هذه الأوامر داخل دليل تطبيق NextJS الخاص بك:

1. kirimase add

تهيئة وتكوين الحزم التالية لمشروع Next.js الخاص بك ، مصنفة إلى:

orm

الرذاذ

• استنادًا إلى نوع قاعدة البيانات المختار (postgreSQL ، MySQL ، SQLite) ، يقوم Kirimase بإعداد الملفات المطلوبة لـ Ramtle-torm ، و Ridshle-Zod للتحقق من عمليات التحقق ، ورذاذها لإدارة الترحيل.
• البرامج النصية مضافة تلقائيًا إلى package.json للاستخدام الفوري لـ Ramistle-Kit.

بريزما

• يقوم Kirimase بإعداد الملفات المطلوبة لـ Prisma مع Zod-Prisma للتحقق من التحقق.

---

المصادقة

Auth.JS

• يقوم بإنشاء ملفات لـ Auth.js (Next-Auth) ، بما في ذلك أحدث محول الرذاذ. (بالنسبة إلى PlanetScale ، يتم استبعاد المراجع لأنها لا تدعم المفاتيح الأجنبية).
• يولد مكون تسجيل دخول عام للاستخدام الفوري في مشروع Next.js الخاص بك.
• يلف تخطيط الجذر مع مزود المصادقة ويولد الأدوات المساعدة لفحوصات المصادقة وإعادة التوجيه في مسارات Next.js.

موظف

• ينشئ ملفات للكاتب بما في ذلك كل التكوين اللازم.
• يلف تخطيط الجذر مع مزود المصادقة ويولد الأدوات المساعدة لفحوصات المصادقة وإعادة التوجيه في مسارات Next.js.

لوسيا

• يولد ملفات لوسيا بما في ذلك كل التكوين اللازم.
• يولد طرق واجهة المستخدم و API للتسجيل والتسجيل

كين

• ينشئ ملفات لـ kinde بما في ذلك كل التكوين اللازم.
• يولد علامة مكون ومعالج المسار

---

آخر

TRPC

• يقوم بإنشاء ملفات لتكوين TRPC باستخدام جهاز توجيه التطبيق.
• يوفر تكوين TRPC و Scaffolds من جانب الخادم من جانب العميل باستخدام نمط الخادم التجريبي.
• يلف تخطيط الجذر في مزود TRPC.

Shadcn-ui

• يقوم بتثبيت وتكوين Shadcn-UI بما في ذلك مكونات الزر والخبز المحمص.
• إدراج المحمص المحمص ( <Toaster /> ) إلى تخطيط الجذر لإخطارات الخبز المحمص الفوري في تطبيق Next.js الخاص بك.

شريط

• يقوم بتثبيت وتكوين Stripe ضمن مشروع Next.js الخاص بك حتى تتمكن من البدء في قبول مدفوعات الاشتراك.

إعادة الالتحاق

• يقوم بتثبيت وتكوين إعادة الالتزام

يضيف Kirimase أيضًا المفاتيح ذات الصلة إلى .env الخاص بك والتي ستحتاج إلى توفير قيم لها.

2. kirimase generate

أقرب إلى rails scaffold ولكن لـ Next.js:

يولد Kirimase:

أ) النموذج:

• يولد مخطط الرذاذ مع أنواع الأعمدة بناءً على مزود نكهة SQL وقاعدة البيانات.
• يستخدم رذاذ Zod لإنشاء مخططات zod للتحقق من صحة الواجهة الأمامية والخلفية.
• يولد الاستعلامات والطفرات لعمليات CRUD ، وكتبت بالكامل وتحسين للاستهلاك عبر الواجهة الأمامية. js.

ب) وحدة التحكم:

• يمنحك خيارًا للسقالة TRPC ، وإجراءات الخادم و/أو طرق API.
• يستخدم مخططات ZOD من نماذج للتحقق من صحة الطلب.
• يتضمن معالجة الأخطاء المدمجة لطرق API والضغط التلقائي لطرق TRPC إلى جهاز توجيه الجذر.

ج) وجهات النظر:

• عرض السقالات باستخدام Shadcn-UI لتمكين عمليات CRUD الفورية (بما في ذلك حقول محددة لإضافة العلاقات و DatePickers للتواريخ).
• خيار لاستخدام نموذج خطاف رد الفعل مع TRPC أو رد فعل عادي (useOptimistic و usevalidated Form Hooks)

تشغيل في الوضع غير التفاعلي

اعتبارًا من V0.0.23 ، يمكنك تشغيل kirimase init و kirimase add بالكامل عبر سطر الأوامر على النحو التالي:

kirimase init -sf yes -pm bun --orm prisma -db pg -a next-auth -ap github discord -mp trpc stripe resend -cl shadcn-ui -ie yes

يأمر	علم قصير	خيار طويل	وصف	دعوى
init	-	-	تهيئة وتكوين kirimase	-
-	-ه	-بلا رأس	قم بتهيئة أي واجهة مستخدم	yes أو no
-	-SF	-SRC-Folder	استخدم مجلد SRC	yes أو no
-	-مساءً	-باكاج ماناجر	مدير الحزمة	<pm>
-	-Cl	-المكون LIB	مكتبة المكون	<component-lib>
-	-أ	--ور	orm	<orm>
-	-DB	-DB	قاعدة البيانات ("PG" ، "MySQL" ، "Sqlite")	<db>
-	-DBP	-DB-Provider	مزود قاعدة البيانات - مهم إذا كان يستخدم الرذاذ	<dbp>
-	-أ	--ث	مصادقة	<auth>
-	-ب	-الممتلكون	مقدمي المصادقة (إذا استخدموا Next-Auth)	<providers>
-	-MP	-حزم	حزم ("TRPC" ، "Shadcn-Ui" ، "إعادة الالتحاق")	<packages>
-	-أي	-مثال على الشبكة	تشمل مثال	yes أو no

المساهمة

حريص على تعزيز كيريماز؟ المساهمات وتقارير الأخطاء وطلبات الميزات هي دائما موضع ترحيب. لا تتردد في فتح مشكلة أو تقديم طلب سحب.

لتشغيل محليا:

pnpm i
pnpm run dev

npm install -g . (in a second terminal - this will then make kirimase available across your machine using " kirimase *command* " )

رخصة

معهد ماساتشوستس للتكنولوجيا