المتطلبات

اختر طريقة واحدة للتشغيل: Docker، أو Node.js مع Yarn. لا تحتاج إلى الاثنين.

باستخدام Docker

• Docker Desktop على macOS أو Windows، أو Docker Engine على Linux. للموقع ملف Dockerfile خاص به؛ ولا حاجة إلى Compose.
• اتصال بالإنترنت للبناء الأول، الذي ينزّل صورة Node.js والحزم.
• لا شيء آخر: Docker يوفّر Node.js.

من دون Docker

• Node.js 22 أو أحدث. تستخدم صورة Docker الإصدار Node.js 24.
• Yarn 4، عبر Corepack. شغّل corepack enable مرة واحدة؛ يثبّت package.json إصدار Yarn بدقة، فيختار yarn الإصدار الصحيح. إذا لم يكن Corepack متاحًا في Node.js لديك، فثبّته أولًا باستخدام npm install -g corepack.
• لا حزم عامة، ولا قاعدة بيانات، ولا متغيرات بيئة.

المنفذ

يستمع الموقع على المنفذ 3030، باستخدام Docker ومن دونه. إذا كان برنامج آخر يستخدمه، فشغّله على منفذ آخر.

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

المتصفح

متصفح حديث يدعم WebGL، الذي يرسم العلب ثلاثية الأبعاد: Chrome أو Edge أو Firefox أو Safari. كل ملف تحمّله الصفحة موجود مع الموقع، ومنه النماذج ثلاثية الأبعاد وخريطة الإضاءة، فلا تحتاج إلى أي خدمة خارجية.

• لا تظهر العلب