Project Scaffolding

أنشئ تطبيق Next.js / TanStack مُهيأً لـ Profound CMS.

التثبيت والتشغيل

استخدم Bun لإنشاء مشروع جديد:

bunx create-profound-app <project-name>

يمكنك اختيار قالب بشكل تفاعلي، أو تمرير قالب محدد صراحةً:

bunx create-profound-app <project-name> --framework=next/tanstack --template=base/docs

لتخطي تهيئة Git تلقائيًا:

bunx create-profound-app <project-name> --no-git

لتخطي تثبيت التبعيات تلقائيًا:

bunx create-profound-app <project-name> --no-install

الخطوات التالية

cd <project-name>
bun dev

القوالب

• base: قالب بداية لموقع بسيط لـ Profound CMS.
• docs: قالب بداية لموقع توثيق بواجهة مستخدم مخصصة للتوثيق.

إنشاء الموقع في Profound CMS

يحتاج التطبيق المُهيأ إلى موقع للإشارة إليه. أنشئ موقعًا في لوحة الإدارة قبل إعداد متغيرات البيئة.

1. انتقل إلى لوحة الإدارة.
2. إذا لم تكن مؤسستك تملك أي مواقع بعد، فستنتقل مباشرةً إلى نموذج الإنشاء. وإلا، افتح القائمة المنسدلة للمؤسسة في أعلى الشريط الجانبي واختر إنشاء موقع جديد.
3. أدخل اسمًا ونطاقًا للموقع، ويمكنك اختياريًا اختيار قالب بداية.
4. انقر على إنشاء. سيتم نقلك إلى /admin/<websiteId> — المعرّف الموجود في عنوان URL هذا هو معرّف الموقع الذي يطلبه القسم التالي.

أين يمكن الحصول على مفتاح API ومعرّف الموقع؟

من لوحة الإدارة:

1. انسخ معرّف الموقع من زر "نسخ المعرّف" في لوحة المعلومات
2. أنشئ مفتاح API جديدًا من قسم الإعدادات > مفاتيح API

متغيرات البيئة

أنشئ ملف .env.local في موقعك المُنشأ:

PROFOUND_API_KEY=your_api_key
NEXT_PUBLIC_PROFOUND_WEBSITE_ID=your_website_id
NEXT_PUBLIC_CMS_API_URL=https://cms.dev.tryprofound.com
NEXT_PUBLIC_BUNNY_CDN_URL=https://cms-profound.b-cdn.net

ما الذي يفعله؟

ينسخ create-profound-app قالبًا إلى مجلد جديد، ويستبدل العناصر النائبة في القالب، مثل اسم المشروع، ويُهيئ اختياريًا مستودع Git ويثبت التبعيات المطلوبة.

أوامر الموقع المُنشأ

داخل المشروع المُنشأ، الأوامر الرئيسية هي:

bun dev: تشغيل خادم التطوير
bun build: إنشاء نسخة الإنتاج
bun start: تشغيل نسخة الإنتاج
bun lint: تشغيل فحص التنسيق
bun generate-schemas: مزامنة مخططات CMS من Profound CMS