نبدأ!¶

👋 أهلًا بك في SaaSFast أيها المُبدع¶

مرحبًا بك! هنا ستجد شرحًا سريعًا عن القالب وكيفية استخدامه لتشغيل تطبيقك بسهولة.

💡 بعد الانتهاء، توجّه إلى هذا الدليل المختصر لإطلاق مشروعك خلال 5 دقائق فقط!

⚡ حان وقت تحويل فكرتك إلى مشروع ناشئ حقيقي بسرعة!

🚀 تشغيل الخادم المحلي¶

افتح الطرفية (Terminal) ونفّذ الأوامر التالية خطوة بخطوة:

git clone https://github.com/Marc-Lou-Org/SaaSFast.git [YOUR_APP_NAME]
cd [YOUR_APP_NAME]

npm install
git remote remove origin
npm run dev

🛠️ إعداد ملف البيئة `.env.local`¶

قم بإعادة تسمية الملف .env.example إلى .env.local:

mv .env.example .env.local

🌐 فتح الموقع في المتصفح¶

بعد تشغيل التطبيق، افتح الرابط التالي:

http://localhost:3000

✅ تهانينا! التطبيق جاهز ويعمل.

⚠️ لا تقلق بشأن الأخطاء الظاهرة في وحدة التحكم (Console) — لن تؤثر على أداء التطبيق.

📁 هيكل مشروع Next.js¶

/app                → صفحات الموقع (مجلد + page.js = صفحة)
/app/api            → نهايات API
/components         → مكونات React
/libs               → وظائف مساعدة (Stripe, Resend, Auth)
/models             → نماذج قاعدة البيانات

⚙️ ملف `config.js`¶

يحتوي على إعدادات التطبيق. 📌 كل مفتاح موثق بشرح يوضّح وظيفته وطريقة استخدامه.

نوصي بالاطلاع عليه بدقة — يمثل العمود الفقري للتطبيق.

🔐 ملف `.env`¶

غيّر قيمة NEXTAUTH_SECRET إلى نص عشوائي لا يقل عن 15 حرفًا.

NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-random-secret
GOOGLE_ID=
GOOGLE_SECRET=
MONGODB_URI=
RESEND_API_KEY=
STRIPE_PUBLIC_KEY=
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=