إنشاء حساب

البدء السريع

شغّل تطبيقك خلال دقائق باتباع دليل البدء السريع هذا.

ملاحظة: هذا محتوى تجريبي/مؤقت لأغراض العرض التوضيحي.

جهّز بيئة التطوير الخاصة بك وشغّلها بسرعة.

المتطلبات الأساسية

قبل أن تبدأ، تأكد من توفر ما يلي لديك:

  • Node.js الإصدار 18.x أو أحدث
  • pnpm الإصدار 8.x أو أحدث
  • Git للتحكم في الإصدارات
  • حساب على Supabase (الباقة المجانية تفي بالغرض تمامًا)

الخطوة 1: استنساخ المستودع

git clone https://github.com/yourorg/yourapp.git
cd yourapp

الخطوة 2: تثبيت الاعتماديات

pnpm install

سيؤدي ذلك إلى تثبيت جميع الاعتماديات المطلوبة عبر المستودع الأحادي (monorepo).

الخطوة 3: إعداد متغيرات البيئة

انسخ ملف البيئة النموذجي:

cp apps/web/.env.example apps/web/.env.local

حدّث المتغيرات التالية:

# إعدادات Supabase
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

# التطبيق
NEXT_PUBLIC_SITE_URL=http://localhost:3000

الخطوة 4: تشغيل Supabase

شغّل نسخة Supabase المحلية الخاصة بك:

pnpm supabase:web:start

سيؤدي ذلك إلى:

  • تشغيل قاعدة بيانات PostgreSQL
  • تشغيل Supabase Studio (localhost:54323)
  • تطبيق جميع عمليات الترحيل (migrations)
  • تعبئة البيانات الأولية

الخطوة 5: تشغيل خادم التطوير

pnpm dev

سيكون تطبيقك متاحًا على العناوين التالية:

  • التطبيق: http://localhost:3000
  • Supabase Studio: http://localhost:54323
  • اختبار البريد الإلكتروني: http://localhost:54324

الخطوة 6: إنشاء أول مستخدم لك

  1. انتقل إلى http://localhost:3000/auth/sign-up
  2. أدخل بريدك الإلكتروني وكلمة المرور
  3. تحقق من http://localhost:54324 للعثور على رسالة التأكيد
  4. انقر على رابط التأكيد
  5. أصبحت جاهزًا للانطلاق!

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

الآن وقد أصبح تطبيقك قيد التشغيل:

  1. استكشف لوحة التحكم - اطّلع على الميزات الرئيسية
  2. راجع الشيفرة - تعرّف على بنية المشروع
  3. اقرأ الوثائق - تعرّف على المفاهيم الأساسية
  4. ابنِ ميزتك - ابدأ التخصيص

المشكلات الشائعة

المنفذ مستخدم بالفعل

إذا كان المنفذ 3000 مستخدمًا بالفعل:

# ابحث عن العملية وأنهِها
lsof -i :3000
kill -9 <PID>

تعذّر تشغيل Supabase

جرّب إعادة تعيين Supabase:

pnpm supabase:web:stop
docker system prune -a  # تنظيف Docker
pnpm supabase:web:start

خطأ في الاتصال بقاعدة البيانات

تأكد من أن Docker قيد التشغيل، ثم أعد تشغيل Supabase:

docker ps  # التحقق من أن Docker قيد التشغيل
pnpm supabase:web:reset

ما التالي؟