🐛 Problem

When mounting the admin panel at the root path (mount_path="/"), dashboard content fails to load. The issue comes from templates building URLs like:

<a href="/{{ mount_path }}/...">

With an empty mount_path, this results in //dashboard-content, which doesn’t match any registered FastAPI route.

✅ Solution

To fix this, I introduced a url_prefix variable in the Python context that normalizes the mount path with a leading slash only when necessary:

self.url_prefix = f"/{self.mount_path}" if self.mount_path else ""

All template links now use {{ url_prefix }} instead of building paths manually:

<a href="{{ url_prefix }}/">Link</a>

This ensures routes work whether the panel is mounted at /, /admin, or any subpath.

🧪 Testing

• mount_path="/" → dashboard loads ✅
• mount_path="/admin" → still works as before ✅
• Verified dashboard content, navigation links, HTMX loading

📹 Before Fix