| Port in use |
Stop other next dev, or use another port |
| Install / lockfile errors |
pnpm install; Node 20+; match pnpm major when possible |
Empty /team |
Check GitHub API / rate limit; set GITHUB_TOKEN |
| No README on project page |
Confirm repo has README; check network at build/runtime; token if rate-limited |
| Images broken in README |
Blob URLs are rewritten to raw; ensure asset exists on the default branch |
| Docker build fails |
Align Node/pnpm with Dockerfile; clear build cache |
| Docs Pages stale |
Rebuild/publish Zensical workflow |
| SEO not updating |
Rebuild, wait for revalidate (1h), run pnpm seo:notify, check GSC |