Navbar Debug Quick Checklist

Immediate Actions

  • [ ] Visit /api/health/ui-debug in both environments
  • [ ] Clear browser cache / use incognito mode
  • [ ] Check browser console for JS errors
  • [ ] Verify window width is same in both environments

CSS Verification

  • [ ] Check Network tab - is output.css loading? (200 status?)
  • [ ] Compare CSS file sizes between environments
  • [ ] Run npm run build-css locally
  • [ ] Restart Docker Compose: docker-compose restart app

Responsive Testing

  • [ ] Test at 767px width (should show hamburger)
  • [ ] Test at 768px width (should show full nav)
  • [ ] Inspect element - which div has display: none?
  • [ ] Mobile: <div class="md:hidden ..."> should be visible
  • [ ] Desktop: <div class="hidden md:flex ..."> should be visible

Quick Fixes to Try

  1. [ ] Force refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (PC)
  2. [ ] Rebuild Docker image: docker-compose build --no-cache app
  3. [ ] Check container CSS: docker exec blueberry-app ls -la /app/blueberry/static/css/
  4. [ ] Test in different browser

If Still Broken

  • [ ] Screenshot both environments
  • [ ] Save browser console output
  • [ ] Check docker-compose logs app
  • [ ] Note exact browser window dimensions
  • [ ] Test with DevTools device emulation
Document ID: development/debug-notes/navbar-debug-checklist