اللوحة والمشاريع
اللوحة هي الباب الرئيسي. كل حاجة تانية في XTop هي نافذة بتفتحها اللوحة.
البحث
مربع البحث بياخد التركيز أول ما اللوحة تفتح، فالدورة كلها: اضغط الاختصار، اكتب، اضغط Enter.
البحث بيطابق اسم المشروع، وأي اسم بديل ليه، ومسار المجلد، واسم المجموعة. المطابقة بتتجاهل حالة الحروف والمسافات والشرطات والنقط والشرطات السفلية، فـ shop api بتلاقي shop-api.
ولو النتيجة جت من اسم بديل، الاسم ده بيظهر جنب اسم المشروع، فيبقى واضح ليه الصف ده ظهر.
| المفتاح | الوظيفة |
|---|---|
| ↑ / ↓ | التنقّل بين النتائج |
| Enter | فتح في المحرر |
| Shift+Enter | فتح ترمينال |
| Esc | قفل اللوحة |
المجموعات
المشاريع بتعيش في مجموعات — شغل، مشاريع جانبية، واحدة لكل عميل، أي تقسيم يناسبك. المجموعة تقدر تتسمّى من جديد وتترتّب براحتك، وتتطوى لسطر واحد، وبتعرض عدد المشاريع اللي جواها.
المجموعات كمان بتشيل أوامر خاصة بيها، بتتعرض في كل مشروع جواها. شوف الأوامر السريعة.
إضافة المشاريع
تلات طرق، كلها من فوتر اللوحة:
- مشروع — إضافة واحد بإيدك.
- استيراد فولدر — توجّه البرنامج على مجلد فيفحصه ويدوّر على المجلدات الفرعية اللي فيها
.gitأو ملف حزمة، وبعدين تختار اللي عايزه. دي الطريقة اللي بتضيف بيها قرص شغل كامل مرة واحدة. - تقدر تنقل المشروع بين المجموعات بعدين؛ مفيش حاجة متثبتة في مكانها.
وفي الحالتين، ملفات الـ manifest بتاعة المشروع بتتقرا وأوامره بتيجي معاه — 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.