code-server/cursor-fullstack/CLOUDFLARE_PAGES_DEPLOYMENT.md

🚀 دليل النشر على Cloudflare Pages - Cursor Full Stack AI IDE

🚨 المشكلة الحالية

Cloudflare Pages يحاول بناء code-server بدلاً من مشروعنا بسبب:

• المستودع المرتبط يحتوي على code-server
• عدم وجود إعدادات صحيحة للبناء
• مشاكل في التبعيات الأصلية

✅ الحل النهائي

1. إنشاء مستودع منفصل للـ Frontend

# إنشاء مستودع جديد للـ Frontend فقط
git init cursor-ide-frontend
cd cursor-ide-frontend

# نسخ ملفات الـ Frontend
cp -r ../cloudflare/frontend/* .

# إضافة وإرسال
git add .
git commit -m "Initial frontend commit"
git remote add origin https://github.com/your-username/cursor-ide-frontend.git
git push -u origin main

2. إعداد Cloudflare Pages

1. انتقل إلى Cloudflare Dashboard
2. اختر Pages > Create a project
3. اربط المستودع الجديد
4. اختر الإعدادات التالية:
   • Framework preset: Vite
   • Build command: npm run build
   • Build output directory: dist
   • Root directory: / (root)

3. إعداد متغيرات البيئة

# في Cloudflare Pages Dashboard
VITE_BACKEND_URL=https://cursor-backend.workers.dev
VITE_WS_URL=wss://cursor-backend.workers.dev
VITE_APP_NAME=Cursor Full Stack AI IDE
VITE_APP_VERSION=1.0.0

🔧 إعداد سريع

1. إنشاء مستودع Frontend منفصل

# إنشاء مجلد جديد
mkdir cursor-ide-frontend
cd cursor-ide-frontend

# نسخ ملفات الـ Frontend
cp -r ../cloudflare/frontend/* .

# إعداد Git
git init
git add .
git commit -m "Initial frontend commit"

# رفع إلى GitHub
gh repo create cursor-ide-frontend --public
git remote add origin https://github.com/your-username/cursor-ide-frontend.git
git push -u origin main

2. نشر على Cloudflare Pages

# استخدام Wrangler
wrangler pages project create cursor-ide-frontend
wrangler pages deploy dist --project-name cursor-ide-frontend

🎯 الحل البديل - النشر المباشر

1. بناء المشروع محلياً

cd cloudflare/frontend
npm install
npm run build

2. نشر الملفات المبنية

# نشر مجلد dist مباشرة
wrangler pages deploy dist --project-name cursor-ide

🌍 النتيجة المتوقعة

بعد النشر الصحيح، ستحصل على:

• Frontend: https://cursor-ide.pages.dev
• Backend: https://cursor-backend.workers.dev
• WebSocket: wss://cursor-backend.workers.dev

🔧 استكشاف الأخطاء

مشكلة: المستودع الخاطئ

الحل: إنشاء مستودع منفصل للـ Frontend

مشكلة: إعدادات البناء

الحل: استخدام Vite preset في Cloudflare Pages

مشكلة: متغيرات البيئة

الحل: إضافة متغيرات البيئة في Cloudflare Dashboard

📋 خطوات النشر النهائية

1. إعداد المستودع

# إنشاء مستودع جديد
gh repo create cursor-ide-frontend --public

# نسخ الملفات
cp -r cloudflare/frontend/* cursor-ide-frontend/
cd cursor-ide-frontend

# إعداد Git
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/your-username/cursor-ide-frontend.git
git push -u origin main

2. ربط Cloudflare Pages

1. انتقل إلى Cloudflare Dashboard
2. Pages > Create a project
3. Connect to Git
4. اختر المستودع الجديد
5. إعدادات البناء:
   • Framework: Vite
   • Build command: npm run build
   • Build output directory: dist

3. إضافة متغيرات البيئة

VITE_BACKEND_URL=https://cursor-backend.workers.dev
VITE_WS_URL=wss://cursor-backend.workers.dev

4. النشر

• Cloudflare Pages سيبني المشروع تلقائياً
• ستحصل على رابط مباشر للتطبيق

🎉 النتيجة النهائية

تطبيق Cursor Full Stack AI IDE سيكون متاحاً على:

• Frontend: https://cursor-ide.pages.dev
• Backend: https://cursor-backend.workers.dev
• WebSocket: wss://cursor-backend.workers.dev

🚀 البدء السريع

# 1. إنشاء مستودع Frontend
gh repo create cursor-ide-frontend --public

# 2. نسخ الملفات
cp -r cloudflare/frontend/* cursor-ide-frontend/
cd cursor-ide-frontend

# 3. إعداد Git
git init && git add . && git commit -m "Initial commit"
git remote add origin https://github.com/your-username/cursor-ide-frontend.git
git push -u origin main

# 4. ربط Cloudflare Pages
# انتقل إلى Cloudflare Dashboard > Pages > Create project
# اختر المستودع الجديد
# إعدادات: Vite, npm run build, dist

# 5. إضافة متغيرات البيئة
# VITE_BACKEND_URL=https://cursor-backend.workers.dev
# VITE_WS_URL=wss://cursor-backend.workers.dev

---

🎯 هذا الحل سيضمن نشر التطبيق بنجاح على Cloudflare Pages!