docs: add stale localhost ui troubleshooting

This commit is contained in:
Md Bayazid Bostame
2026-03-30 13:08:20 +02:00
parent 74bd2c9b85
commit edd76316eb
2 changed files with 29 additions and 0 deletions

View File

@@ -491,6 +491,21 @@ docker compose --env-file .env.test -f docker-compose.prod.yml logs --tail=100 w
docker compose --env-file .env.test -f docker-compose.prod.yml logs --tail=100 caddy
```
## If localhost still looks wrong after the server is fixed
Use this order before assuming the local checkout is missing code:
1. hard refresh the page with `Cmd + Shift + R`
2. clear site data for `127.0.0.1:8088` in browser devtools and sign in again
3. restart the local web container:
```bash
docker compose restart web
```
4. if it still survives, rebuild the local stack:
```bash
docker compose up -d --build
```
This is the correct recovery path for stale browser state, shared-header fixes, page-local CSS fixes, and versioned static asset updates.
## Rollback
This deployment path is source-upload based, not image-tag based.