Table of Contents
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
- [ ] Force refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (PC)
- [ ] Rebuild Docker image:
docker-compose build --no-cache app
- [ ] Check container CSS:
docker exec blueberry-app ls -la /app/blueberry/static/css/
- [ ] 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