تبويب الشفرة — اقرأ شفرة تطبيقك وعدّلها
باختصاريعرض تبويب الشفرة كل ملفات تطبيقك في شجرة مجلدات، وبجانبها محرر. انقر على ملف لقراءته، واكتب لتغييره، ثم اضغط «حفظ» (أو ⌘S / Ctrl+S)؛ وكل حفظ يصبح إصدارًا يمكنك الرجوع إليه. تُنشأ التطبيقات باستخدام TanStack Start وReact وTypeScript. والشفرة ملك لك: نزّلها من إعدادات المشروع ← تصدير، أو احتفظ بها في GitHub.
لن تحتاج أبدًا إلى فتح الشفرة، لأن MonstarX يكتبها ويغيّرها نيابةً عنك. لكنها كلها موجودة أمامك، متى أردت أنت (أو مطور تعمل معه) الاطلاع عليها. يعرض تبويب الشفرة كل ملفات تطبيقك ويتيح لك إجراء تغييراتك بنفسك.
ماذا يعرض تبويب الشفرة؟
Section titled “ماذا يعرض تبويب الشفرة؟”على اليمين، شجرة مجلدات فيها كل ملفات تطبيقك. وعلى اليسار، الملف الذي اخترته، بألوان تميّز الشفرة وبأرقام الأسطر.
على الهاتف، المس اسم الملف في الأعلى لفتح الشجرة في لوحة منبثقة.
أين توجد الأشياء؟
Section titled “أين توجد الأشياء؟”لا تحتاج إلى معرفة هذا، لكنه يساعدك إذا أردت المتابعة والقراءة:
| المجلد أو الملف | محتواه |
|---|---|
src/routes/ | ملف لكل صفحة: index.tsx هو الصفحة الرئيسية، وpricing.tsx هو /pricing. |
src/components/ | أجزاء تُستخدم في عدة صفحات، مثل الترويسة والتذييل. |
src/server/ | الشفرة التي تعمل على الخادم: حفظ حجز، وقراءة الجدول. |
src/db/ | بنية بيانات تطبيقك. |
migrations/ | الخطوات التي تنشئ جداول قاعدة البيانات وتغيّرها. |
public/ | ملفات تُقدَّم كما هي، مثل الأيقونات. |
src/styles.css | الألوان والخطوط وغيرها من التنسيقات. |
بماذا يُنشأ تطبيقي؟
Section titled “بماذا يُنشأ تطبيقي؟”التطبيقات التي ينشئها MonstarX تطبيقات ويب حديثة مبنية باستخدام:
- TypeScript: لغة JavaScript مع فحوص تكتشف الأخطاء قبل أن يعمل تطبيقك.
- React: الطريقة الأكثر انتشارًا لبناء واجهات الويب.
- TanStack Start: إطار عمل يحوّل صفحات React إلى تطبيق كامل بخادم، فتُحمَّل الصفحات بسرعة وتبقى بياناتك آمنة على الخادم.
- Tailwind CSS: مجموعة أدوات تنسيق للألوان والمسافات والتخطيط.
وهذا أيضًا ما تعرضه البطاقة في صفحة المشاريع، مثل TanStack Start · React · TypeScript. أما التطبيق الذي استوردته فيحتفظ بالتقنيات التي بُني بها.
كيف أعدّل ملفًا بنفسي؟
Section titled “كيف أعدّل ملفًا بنفسي؟”-
افتح تبويب الشفرة وانقر على الملف في الشجرة.
-
انقر داخل المحرر وأجرِ تغييرك. تظهر في الأعلى عبارة غير محفوظ، مع زرّي تجاهل وحفظ.
-
انقر على حفظ، أو اضغط ⌘S (على Mac) أو Ctrl+S (على Windows). تتحدث المعاينة فورًا.
يُحفظ كل حفظ إصدارًا باسم تعديل متبوعًا بمسار الملف، مثل تعديل src/routes/schedule.tsx، لتتمكن من الرجوع إذا ساءت الأمور. وإذا كان مشروعك مرتبطًا بـ GitHub مع تفعيل الإرسال التلقائي (وهو الإعداد الافتراضي)، يُرسل التغيير إلى هناك أيضًا. ويرى MonstarX تعديلك في المرة التالية التي تطلب منه فيها شيئًا.
أما تجاهل فيحذف تغييراتك غير المحفوظة.
متى لا يمكنني التعديل؟
Section titled “متى لا يمكنني التعديل؟”- أثناء تغيير MonstarX لتطبيقك. تكون الملفات للقراءة فقط حتى ينتهي: «يُجري MonstarX تغييرات على تطبيقك. تظل الملفات للقراءة فقط حتى ينتهي.»
- عندما يتغير الملف بعد أن بدأت. إذا حفظ MonstarX أو شخص آخر الملف في الأثناء، ترى «تغيّر هذا الملف بعد أن بدأت تعديله.» ويصبح زر حفظ باهتًا وغير قابل للنقر. وتبقى مسودتك محفوظة حتى تتجاهلها، فتستطيع المقارنة، ثم التجاهل، ثم إجراء التغيير من جديد.
- الملفات التي يديرها MonstarX. في التطبيقات التي ينشئها MonstarX، يتولى MonstarX ملفات الإعدادات (مثل
package.jsonوإعدادات Vite وTypeScript) والخدمات المدمجة للحسابات وقاعدة البيانات والبريد الإلكتروني والتخزين والذكاء الاصطناعي. لا تظهر هذه الملفات في الشجرة، لكنها موجودة في ملف zip عند التصدير. - صلاحية العرض فقط. الأشخاص الذين شاركت معهم المشروع بصلاحية يمكنه العرض والتعليق يرون «للعرض فقط: يمكنك قراءة الشفرة، لكن لا يمكنك تعديلها.» أما من لديهم صلاحية يمكنه التعديل فيعدّلون الملفات ويحفظونها مثلك.
هل يمكنني تنزيل شفرتي؟
Section titled “هل يمكنني تنزيل شفرتي؟”نعم. الشفرة ملك لك: أنت تملك ما تنشئه بـ MonstarX، بما في ذلك الشفرة التي يكتبها. ولديك طريقتان لأخذها معك:
- تنزيل ملف zip: من الإعداداتتصدير في مساحة العمل، ثم تنزيل .zip. تحصل على مشروع مستقل يعمل على حاسوبك. راجع تصدير تطبيقك.
- الاحتفاظ بها في GitHub: اربط مستودعًا، فيصبح كل تغيير commit. راجع GitHub.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل أحتاج إلى معرفة البرمجة لاستخدام MonstarX؟
لا. تبويب الشفرة موجود لمن يريد الاطلاع. ويمكن إنجاز كل شيء بوصف ما تريده في المحادثة.
هل سيلغي MonstarX تعديلاتي؟
لا. يقرأ الملفات كما هي عندما ترسل طلبك التالي، بما فيها تعديلاتك. وإذا أردت أن يعرف سبب تغييرك لشيء ما، فاذكره في المحادثة.
هل يمكنني إضافة ملف جديد في تبويب الشفرة؟
يعدّل تبويب الشفرة الملفات الموجودة. اطلب من MonstarX في المحادثة إنشاء صفحات أو ملفات جديدة.
كيف أضيف حزمة أو مكتبة؟
اطلبها في المحادثة، مثلًا «استخدم مكتبة لاختيار التاريخ في نموذج الحجز». يضيف MonstarX الحزم نيابةً عنك.
من يملك الشفرة التي يكتبها MonstarX؟
أنت. تنص شروط MonstarX على أنك تملك طلباتك وملفاتك وشفرتك وتطبيقاتك، ويمكنك تصديرها في أي وقت.