عن المشروع

Vinext هو سلسلة أدوات بديلة متوافقة مع Next.js مبنية على Vite، وليس تفرعاً من Next.js أو محولاً لمخرجات `next build`. تكتشف إضافة Vite الخاصة به مجلدات `app/` أو `pages/` وتحمّل `next.config.js`، وتدعم كل من App Router وPages Router. تشمل القدرات الموثقة مكونات خادم React، وإجراءات الخادم، ومعالجات المسارات، والوسيطات، وSSR وترطيب العميل، والتوليد الساكن، وISR، و`output: "export"`، ومخرجات Node.js المستقلة، والوحدات الشائعة مثل `next/link` و`next/image` و`next/navigation` و`next/headers` و`next/cache` وواجهة Metadata API. يستهدف المشروع Next.js 16.x ولا يركز على واجهات API المهملة من الإصدارات الأقدم. يوضح ملف README أن vinext قيد التطوير النشط وليس بعد بديلاً كاملاً جاهزاً للاستخدام المباشر. تشمل فجوات التوافق المعروفة سلوك Cache Components وPartial Prerendering غير المكتمل، وتحسين الصور والخطوط المحدود وقت البناء، وإخفاقات الوحدات الأصلية في تطوير App Router لحزم مثل `sharp` و`satori`، وتجاهل `preferredRegion`، وبعض دلالات Next.js المتقدمة أو المُدخلة حديثاً. يُنصح المستخدمون بتشغيل `vinext check` قبل الترحيل. يمكن إنشاء مشاريع جديدة باستخدام `create-vinext-app`؛ ويمكن ترحيل المشاريع القائمة باستخدام `vinext init`. يتحقق أمر الترحيل من التوافق، ويثبّت التبعيات، ويعدّل إعدادات مختارة لـ ESM، ويضيف سكربتات، ويطلب هدف النشر، ويولّد إعدادات Vite والمنصة المناسبة دون إزالة إعداد Next.js الأصلي. يستخدم الإعداد اليدوي إضافة Vite ‏`vinext()`، و`vite dev`، و`vite build`، و`vinext start`. يمكن لمهارة Agent الاختيارية أن ترشد الترحيل عبر أدوات البرمجة بالذكاء الاصطناعي المدعومة. يمتلك Cloudflare Workers التكامل الأعمق. يبني `@vinext/cloudflare deploy` التطبيقات وينشرها، بينما يُوصَل إلى الارتباطات مثل D1 وR2 وKV وDurable Objects وAI وQueues وVectorize وBrowser Rendering عبر `env` من `cloudflare:workers`. يغطي التكامل أيضاً محولات التخزين المؤقت، وتحسين الصور وقت الطلب، وتخزين الاستجابات مؤقتاً، والتسخين المسبق الاختياري للتخزين المؤقت. يمكن تشغيل مخرجات Node المستقلة من `dist/standalone/server.js`. يمكن استهداف منصات أخرى، بما في ذلك Vercel وNetlify وAWS وDeno Deploy وAzure، عبر إضافة Nitro Vite. يفيد المشروع بأكثر من 1,700 اختبار Vitest و380 اختبار Playwright من طرف إلى طرف، بما في ذلك اختبارات مستمدة من مجموعات مطابقة Next.js وOpenNext، لكنه يوصي بالتقييم الدقيق قبل الاستخدام في الإنتاج.