Browser Cache Causes Broken UI on Page Reload

[mohamedachrefhacheni]

Privileged issue

• I'm @tiangolo or he asked me directly to create an issue here.

Issue Content

When reopening the FastAPI dashboard, some users see outdated or broken UI components.This occurs due to the browser serving cached assets instead of fetching fresh ones from the server. Hard-refreshing (Ctrl+F5) temporarily fixes the issue, but a permanent solution is needed.

[stevleibelt]

Just some wild guesses here, this sounds more like a caching issue in swagger-ui or possible a configuration think in traefik?

[YuriiMotov]

I suppose that's because index.html is being cached.
To solve this we need to set separate cache strategies for index.html (no-cache) and static assets (long time cache since they have content hashes in the file names).

Can you please try the following nginx config?

frontend/nginx.conf

server {
  listen 80;

  root /usr/share/nginx/html;
  index index.html index.htm;

  # Serve index.html with no-cache
  location / {
      try_files $uri /index.html =404;
      add_header Cache-Control "no-cache, no-store, must-revalidate" always;
  }

  # Serve assets files normally
  location /assets/ {
      try_files $uri =404;
  }

  include /etc/nginx/extra-conf.d/*.conf;
}

Don't forget to rebuild the frontend container