اللوحة والمشاريع
اللوحة هي النافذة الرئيسية. كل حاجة تانية في XTop بتتفتح منها.
البحث
مربع البحث بيبقى جاهز للكتابة أول ما اللوحة تفتح، فالخطوات كلها: اضغط الاختصار، اكتب، اضغط Enter.
البحث بيدوّر في اسم المشروع، وأسماءه التانية، ومسار الفولدر، واسم المجموعة. وبيتجاهل الحروف الكبيرة والمسافات والشرط والنقط، فلو كتبت shop api هيلاقي shop-api.
ولو النتيجة جت من اسم تاني للمشروع، الاسم ده بيظهر جنبه عشان تعرف الصف ظهر ليه.
| المفتاح | الوظيفة |
|---|---|
| ↑ / ↓ | التنقّل بين النتائج |
| Enter | فتح في المحرر |
| Shift+Enter | فتح ترمينال |
| Esc | قفل اللوحة |
المجموعات
المشاريع بتتحط في مجموعات — شغل، مشاريع جانبية، واحدة لكل عميل، زي ما تحب. تقدر تغيّر اسم المجموعة وتحرّكها وتطويها لسطر واحد، وبتوريك عدد المشاريع اللي جواها.
والمجموعة كمان ممكن تشيل أوامر خاصة بيها، وساعتها بتظهر في كل مشروع جواها. شوف الأوامر السريعة.
إضافة المشاريع
في فوتر اللوحة زرارين بيضيفوا مشروع:
- مشروع — إضافة واحد بإيدك.
- استيراد فولدر — توجّه البرنامج على مجلد فيفحصه ويدوّر على المجلدات الفرعية اللي فيها
.gitأو ملف حزمة، وبعدين تختار اللي عايزه. دي الطريقة اللي بتضيف بيها قرص شغل كامل مرة واحدة.
والزرار التالت، مجموعة، بيعمل مجموعة جديدة تحطهم فيها. ومفيش حاجة متثبتة في مكانها بعد كده — انقل المشروع لمجموعة تانية بالسحب في أي وقت.
وبأي طريقة ضفته، البرنامج بيقرا ملفات المشروع وبيجيب أوامره معاه — npm run dev و make build و docker compose up — فتقدر تشغّله من أول لحظة. شوف الأوامر بتنزل مع المشروع.
المشروع بيشيل إيه
| الحقل | أهميته |
|---|---|
| الاسم | الاسم الأساسي، وأول حاجة البحث بيدوّر فيها |
| أسماء تانية | أي عدد من الأسماء الإضافية اللي تقدر تدوّر بيها — اكتب واحد واضغط Enter أو , |
| المسار | الفولدر على الجهاز |
| البيئة | windows أو wsl — بتحدد الترمينال يبقى PowerShell ولا wsl.exe -d <distro> --cd <path>، وأنهي نسخة من المحرر بتتفتح |
| المحرر الافتراضي | بيشتغل بدل الإعداد العام في المشروع ده بس |
| رابط Figma | بيضيف زرار Figma في الصف |
| معرّف مجموعة Postman | بيضيف زرار Postman في الصف |
| الفتح عند بدء التشغيل | شوف مشاريع بدء التشغيل |
صف المشروع
مرّر الماوس على الصف عشان تظهر أزراره.
بالترتيب: تشغيل أمر، معلومات Git، الملاحظات، اختبار الـ API، ترمينال، وبعدين Figma و Postman لو المشروع ليه روابط، وآخر حاجة قايمة ⋯.
قايمة ⋯ فيها باقي طرق الفتح: افتح المحرر على جهة ويندوز أو جهة WSL، كل نوع ترمينال لوحده، اعرض الفولدر في مستكشف الملفات، انسخ مسار المشروع، إدارة الأوامر، تعديل، وحذف.
خيارات WSL اللي بتبقى مقفولة
لو WSL مش متثبّت، أو هو النسخة الفاضية من المتجر، أو مفيش توزيعة متسجّلة، خيارات WSL بتبقى مقفولة وبتقولك السبب، ومعاها لينك صفحة التثبيت من مايكروسوفت. ولو البرنامج مش متأكد، مش بيقفل حاجة.
قائمة أو بطاقات
أول زرار في الهيدر بيبدّل بين القايمة والبطاقات. والاختيار بيتحفظ.
المفتوحة مؤخرًا
فوق المجموعات، اللوحة بتعرض آخر مشروع فتحته وسطر قصير المفتوحة مؤخرًا. المزيد بيعرض الباقي، وأقل بيطويه تاني.
التثبيت
اللوحة بتختفي لما تضغط في أي مكان تاني. زرار التثبيت في الهيدر بيخليها مفتوحة — مفيد وإنت بتنقل مشاريع بين المجموعات أو بتقرا مخرجات Git.