Install
pnpm create vinext-app@latest my-appلمن يناسب
هذه المهارة تناسب من يكتب Next.js أصلًا ويريد الانتقال إلى Vite واتخاذ Cloudflare Workers هدف نشر رئيس. الرسمي يكتبها: تشغيل تطبيق Next.js على Vite، وأول بيئة هبوط هي Cloudflare Workers. تناسب أيضًا من يستعد لإنشاء دليل مثال على هذا الجهاز ويقبل أن أمر الإنشاء الرسمي يكتب على القرص.
النص الأصلي يقول أيضًا إنها تعمل مع Claude Code وOpenCode وCursor وCodex وكثير من أدوات ترميز الذكاء الأخرى. هذه قائمة أمثلة، لا دعم لهذه الأربع فقط. إن كنت تصنع صفحة ثابتة فقط، أو هدف النشر ليس Workers أصلًا، فابقَ عند القراءة.
ولا تناسب معاملة تطبيق إنتاج حي على أنه «يُبدَّل فيعمل». الرسمي واضح: اليوم تستطيع حمل عدد غير قليل من تطبيقات Next.js ذات وزن، لكنها ليست بعد بديلاً فوريًا لكل تطبيق أو حمل إنتاج. المستودع الرسمي هو https://github.com/cloudflare/vinext اعمل بالأوامر المكتوبة أصلًا في تلك الصفحة.
إنهاء المحاولة الأولى في 3 دقائق
اسلك فقط مسار المشروع الجديد الذي كتبه الرسمي.
شرط مسبق: هذا الجهاز يستطيع تشغيل pnpm، والدليل الحالي يسمح بمجلد جديد، وأنت توافق بوضوح على تهيئة محلية واحدة. أكّد أولاً: الأمر أدناه سينشئ دليلاً جديدًا اسمه my-app. إن لم ترد بعد الكتابة على القرص فلا تنفّذه.
موضع التثبيت: افتح طرفية في دليل المشروع الجديد، أكّد الآثار أعلاه ثم نفّذ:
pnpm create vinext-app@latest my-app
تحقق منخفض المخاطر: بعد ظهور الدليل انظر فقط إلى الشرح والإعداد قراءةً. لا تنشر ولا تغيّر مستودعًا حيًا. إن فتحت مشروع Next.js قائمًا، فالجملة التالية في النص الأصلي هي قول migrate this project to vinext في أداة مدعومة؛ في المحاولة الأولى قف عند إعادة صياغة ما ستغيّره تلك الجملة — لا تدع الأداة تغيّر الملفات بعد.
إشارة النجاح: يظهر my-app في الدليل الحالي ويتبين أنه مشروع Next.js-on-Vite بناه vinext. إن فشل الأمر فلا تُكمل بمثبّت لم يظهر؛ عد إلى الصفحة الرسمية وقابل النص.
حالات الاستخدام
الحالة الأولى: من الصفر ابنِ مشروع Next.js على Vite باتجاه Cloudflare Workers. الأمر الرسمي هو pnpm create vinext-app@latest my-app. يناسب من يريد أولاً دليلاً محليًا قابلاً للفحص ثم يقرر إن كان سيكمل. قبل العمل أكّد أنه لا يوجد مجلد بنفس الاسم. إن لم يكتب النص الأصلي كيف تتخطى التثبيت أو تغيّر هدف النشر، فلا تفترض وجود مثل هذا المفتاح.
الحالة الثانية: قيّم إن كان مشروع Next.js قائم يجب أن ينتقل إلى vinext. النص الأصلي يقول: افتح ذلك المشروع في أي أداة مدعومة وقل migrate this project to vinext. في المرة الأولى اجعل الأداة تسرد الملفات التي ستغيّرها، واسمح بالكتابة بعد التأكيد فقط. النص الأصلي لا يعطي قائمة المسارات أو جلب البيانات أو الوسيط المشمول؛ تصل فقط إلى «بدء التقييم بالعبارة الرسمية» ولا تُكمل جدول توافق لم يُكتب.
حدود الاستخدام
المسار الرئيس الرسمي هو pnpm create vinext-app@latest my-app. لا تكتب مثبّتًا لم يظهر في المسار الرئيس. في جانب النشر يكتب النص الأصلي Cloudflare Workers فقط كهدف أول؛ ولا يثبت أنك تستطيع الدفع كما هو إلى منصة غير مسمّاة.
حد القدرة واضح: اليوم تستطيع حمل عدد غير قليل من تطبيقات Next.js ذات وزن، لكنها ليست بعد بديلاً فوريًا لكل تطبيق أو حمل إنتاج. لا تستخدمها لوعد قطع بلا تغيير لموقع حي.
قائمة الأدوات هي Claude Code وOpenCode وCursor وCodex وكثير من أدوات ترميز الذكاء الأخرى — مثال لا قائمة مغلقة. عبارة ترحيل واحدة فقط مكتوبة. الأسرار ومتغيرات البيئة وخطوات النشر الإنتاجي لم تُبسَط؛ لا تُكملها. الصفحة الرسمية هي https://github.com/cloudflare/vinext إن اقترحت أداة أمرًا يخالف تلك الصفحة، فتلك الصفحة هي المرجع.