الآخر

Cheat Sheet: لو المشكلة… فكّر في…

One-page troubleshooting & recall
🎯 الهدف: صفحة واحدة ترجعلها لما حاجة تضرب — المشكلة على الشمال، والحل تحتها.
package داخلية بتتنزّل من npm بدل المحليةاستخدم workspace:* + scope @repo/
import شغال عندي وبيضرب في CIphantom dependency → ضيفها في package.json الصح
عاوز أضيف tool للريبو كلهpnpm add -Dw
مين جايب الـ package دي؟pnpm why
web بيتبني قبل ui"dependsOn": ["^build"]
cache hit بس dist فاضيظبّط outputs
staging build أخد production configضيف الـ env في env بتاع الـ task
ليه ده miss؟--summarize أو --dry=json
أشغّل app واللي محتاجه--filter=web...
غيّرت package، مين يتأثر؟--filter=...@repo/ui
NestJS مش فاهم الـ packageابنيها cjs+esm بـ tsup + exports
Invalid hook callReact في peerDependencies بتاعة ui
Next مش بيقرا .ts من packagetranspilePackages في next.config
CI بطيء--affected + remote cache
affected بيبني كل حاجةfetch-depth: 0
Docker image ضخمة وبتتبني كل شويةturbo prune --docker (json ثم full)
عاوز أنشر الـ design systemChangesets + changesets/action
features بتعمل import من بعضNx module boundaries + tags
كل package جديدة بتاخد ساعة setupNx generators (أو turbo gen)
Turbo ولا Nx؟ابدأ Turbo؛ انقل لـ Nx لما تحتاج حدود معمارية أو CI موزّع

🏁 Checklist النهاية