القالب المستخدم في تجهيز مشاريع الكتب المُيسّرة العاملة بإستخدام Ruby on Rails
- ثبّت Docker حسب نظام تشغيلك من خلال هذا الرابط
- ثبّت Mise حسب نظام تشغيلك من خلال هذا الرابط
- ثبّت مكتبة
gpgحسب نظام تشغيلك. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS: - ثبّت مكتبة
libpqحسب نظام تشغيلك. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS: - أضِف مكتبة
libpqإلى متغيرPATHحسب نظام تشغيلك باتباع التعليمات الموضّحة بعد تثبيت المكتبة. على سبيل المثال، نفّذ هذا الأمر إذا كنت تستخدم نظام macOS معZsh:
brew install gnupg
brew install libpq
echo 'export PATH="/opt/homebrew/opt/libpq/bin:$PATH"' >> /Users/{user}/.zshrc
استخدم الأمر التالي لإنشاء مشروعك الجديد باستخدام القالب
~> rails new {app_name} --database=postgresql --css=tailwind --js=esbuild --skip-test \
--template https://raw.githubusercontent.com/ieasybooks/ruby-on-rails-template/refs/heads/main/template.rbخلال إنشاء المشروع يمكنك تحديد 5 أمور (جميعها مُعطّلة افتراضيًا):
-
هل تريد استخدام Cloudflare؟ ستحصل على المكتبات التالية إذا كنت ستستخدمه بالإضافة إلى الإعدادات المطلوبة:
- rails_cloudflare_turnstile
- cloudflare-rails
-
هل تريد استخدام Meilisearch؟ ستحصل على المكتبات التالية إذا كنت ستستخدمه بالإضافة إلى الإعدادات المطلوبة وخدمة Docker المُتعلقة به:
- meilisearch-rails
-
هل تريد استخدام Avo؟ ستحصل على المكتبات التالية إذا كنت ستستخدمه بالإضافة إلى الإعدادات المطلوبة:
- avo
-
هل تريد استخدام Devise؟ ستحصل على المكتبات التالية إذا كنت ستستخدمه بالإضافة إلى الإعدادات المطلوبة:
- devise
- devise-i18n
-
هل تريد استخدام Phlex؟ ستحصل على المكتبات التالية إذا كنت ستستخدمه بالإضافة إلى الإعدادات المطلوبة:
- phlex-icons
- phlex-rails
- ruby_ui
- tailwind_merge
ستحصل على الأدوات التالية باتباعك للخطوات المذكورة أعلاه:
- Docker
- Mise
- gnupg
- libpq
- Ruby (3.4.4)
- Rails (8.0.2)
- Node.js (24.1.0)
- Yarn (4.9.1)
- PostgreSQL (17.5)
- Meilisearch (1.15.2)
يمكنك الوصول إلى الخدمات من خلال المنافذ التالية:
- PostgreSQL → 5433 (localhost:5433)
- Meilisearch → 7701 (localhost:7701)
وبمجرّد إيقاف تشغيل خادم التطوير المحلّي من خلال الضغط على Cmd+C أو Ctrl+C، ستتوقف خدمات Docker (PostgreSQL و Meilisearch) عن العمل تلقائيًا.
أُعِدّ القالب ليعمل مع محرر VSCode أو ما يشبهه من المحررات مثل Cursor و Windsurf وغيرهما. بمجرّد فتح المشروع في أحد هذه المحررات سيظهر لك إشعار يسألك "هل تريد تثبيت الإضافات المُوصى بها؟"، وإذا ضغطت على زر Install ستبدأ عملية تثبيت الإضافات الموجودة في ملف .vscode/extensions.json.
الإضافات المُوصى بها:
- Ruby LSP
- Rails DB Schema
- Rails I18n
- Tailwind CSS IntelliSense
- vscode-gemfile
- GitLens — Git supercharged
- Mise VSCode
- Stimulus LSP
- Live Preview
- SQLTools
- SQLTools PostgreSQL/Cockroach Driver
- vscode-icons
- Git Blame
كما أن إعدادات جميع هذه الإضافات موجودة مسبقًا في ملف .vscode/settings.json، لذا لا داعي لإعدادها يدويًّا.
ملاحظة: جميع المكتبات يجب أن تكون مُحددة بإصدار مُعيّن لضمان الاستقرار والتوافق.
- active_record_doctor
- annotaterb
- better_errors
- binding_of_caller
- factory_bot_rails
- hotwire-spark
- i18n-tasks
- rspec-rails
- rubocop-rake
- rubocop-rspec
- rubocop-rspec_rails
- shoulda-matchers
- simplecov-json
- simplecov
- webmock
- avo
- cloudflare-rails
- memory_profiler
- mission_control-jobs
- pg_query
- pghero
- rack-mini-profiler
- solid_errors
- stackprof
- strict_ivars
بالإضافة إلى مكتبات إطار عمل Ruby on Rails الأساسية.
ملاحظة: جميع المكتبات يجب أن تكون مُحددة بإصدار مُعيّن لضمان الاستقرار والتوافق.
بالإضافة إلى مكتبات إطار عمل Ruby on Rails الأساسية.