تخطَّ إلى المحتوى
Saasfly Docs

تثبيت

هل أنت مستعد لتثبيت Saasfly؟ اتبع هذا الدليل لاستخدام واجهة سطر الأوامر create saasfly للبدء.

متطلبات النظام

  • Node.js - 18.17 أو أحدث.
  • Bun - 1.0 أو أحدث.
  • OS - يتم دعم macOS، وWindows (بما في ذلك WSL)، وLinux.

بالمناسبة، نوصي باستخدام NVM (Node Version Manager) لتشغيل إصدارات مختلفة من Node.js.

1. تشغيل معالج الإعداد

قم بتشغيل الأمر التالي في محطتك لبدء معالج التثبيت المفيد:

Terminal window
bun create saasfly

عند التثبيت، ستشاهد المطالبات التالية:

  1. استنسخ مستودع saasfly في المجلد المحدد.
  2. إزالة سجل git
  3. تثبيت التبعيات
  4. إنشاء نوع Prisma

بعد المطالبات، سيقوم الأمر create saasfly بإنشاء مجلد باسم مشروعك وتثبيت التبعيات المطلوبة.

2. ابدأ Saasfly

ينبغي عليك القيام بالقوائم أدناه لتشغيل الخادم.

إعداد متغيرات البيئة

قم بالدخول إلى مجلد saasfly، ثم قم بنسخ الملف .env.example، ثم قم بإعادة تسميته إلى .env.local، ثم أدخل المتغيرات الخاصة بك.

Terminal window
cd saasfly
cp .env.example .env.local

تأكد من أن لديك قاعدة بيانات Postgres (إذا لم يكن لديك Postgres، فانقر هنا) وقمت بإنشاء قاعدة بيانات جديدة.

يجب أن يكون POSTGRES_URL موجودًا في ملف .env.local الخاص بك:

# مثال على التنسيق
# POSTGRES_URL="postgres://{USER}:{PASSWORD}@{DB_HOST}:{DB_PORT}/{DATABASE}"


POSTGRES_URL="postgres://postgres:[email protected]:5432/saasfly"

بعد ذلك، استخدم bun لإنشاء جداول قاعدة البيانات:

Terminal window
bun db:push

انتاج:

🚀  Your database is now in sync with your Prisma schema. Done in 151ms


┌─────────────────────────────────────────────────────────┐
│  Update available 5.9.1 -> 5.10.2                       │
│  Run the following to update                            │
│    npm i --save-dev prisma@latest                       │
│    npm i @prisma/client@latest                          │
└─────────────────────────────────────────────────────────┘

إذا حدث خطأ ما، يمكنك التحدث إلينا على Discord، وسنكون سعداء بالإجابة على أي شيء يتعلق بـ Saasfly.

قم بتشغيل البناء أولاً

نظرًا لأن بعض المكونات الأساسية تتطلب وقت التجميع، فيجب عليك run build أولًا.

Terminal window
bun run build

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

استخدم bun run لبدء تشغيل خادم الويب الخاص بك:

Terminal window
bun run dev:web
@saasfly/nextjs:dev: cache bypass, force executing ad8bea47f156e113
@saasfly/nextjs:dev: $ bun with-env next dev
@saasfly/nextjs:dev: $ dotenv -e ../../.env.local -- next dev
@saasfly/nextjs:dev:    ▲ Next.js 14.1.0
@saasfly/nextjs:dev:    - Local:        http://localhost:3000
@saasfly/nextjs:dev:
@saasfly/nextjs:dev:    automatically enabled Fast Refresh for 1 custom loader
@saasfly/nextjs:dev:  ✓ Ready in 12.1s

إذا سارت الأمور على ما يرام، فيجب أن يقوم Saasfly الآن بخدمة مشروعك على http://localhost:3000 ، ويمكنك رؤية النتيجة:

Installation

مبروك! يمكنك الآن البدء في كتابة التعليمات البرمجية لبناء برنامج SaaS الخاص بك.

إذا كنت جديدًا على Saasfly، فراجع مستندات هيكل المشروع للحصول على نظرة عامة على جميع الملفات والمجلدات المحتملة في تطبيقك.

تشغيل مع Stripe

يرجى قراءة المقال Stripe. ثم استخدم bun dev لتشغيل Stripe:

Terminal window
bun dev