عن المشروع

Windrift هو إطار عمل مفتوح المصدر بلغة JavaScript لكتابة سرديات قابلة للتغيير وقصص تشعبية تفاعلية. وقد استُخدم لتأليف أعمال مثل Harmonia وStone Harbor وThe Ballroom وThe Imposter وترجمة برتغالية من Stone Harbor. المشروع مبني على Next.js ومكتوب بلغة TypeScript، ويعمل كتطبيق واحد من Next.js يمكنه استضافة قصص متعددة. يمكن للمؤلفين استخدام ميزات Next.js وخيارات النشر الخاصة به، بما في ذلك الاستضافة عبر Vercel. ولأن كود Windrift الأساسي يُضمَّن مع كل مستودع قصة، يمكن للمؤلفين تعديل أو تغيير سلوك المكتبة الأساسي في مشاريعهم الخاصة. يوفر المستودع سير عمل للتطوير المحلي باستخدام Node.js، ويوصي باستخدام Node Version Manager مع Node 22. يتم التثبيت عبر npm، وتتوفر أوامر لإنشاء قصة جديدة باستخدام معرّف قصة وتشغيل بيئة التطوير المحلية. وتُوثَّق أوامر إضافية، بما في ذلك خيارات النشر، في دليل Windrift الرسمي. تُقدَّم التوثيقات من خلال دليل رسمي يُنشر باستمرار، وهو نفسه مكتوب كقصة Windrift. يتضمن الدليل قصصًا نموذجية تتراوح بين الاستخدام الأساسي والمتقدم، كما تقدم Windrift Playground عروضًا توضيحية إضافية مع كود المصدر المتاح للقصص النموذجية. ويشمل المشروع أيضًا اختبارات تكامل عبر سير عمل Playwright.