WIP: integrate documentation to the jinja theme

Author: ix-56h

src/server/main.py

@@ -19,7 +19,7 @@
 load_dotenv()
 
 # Initialize the FastAPI application with lifespan
-app = FastAPI(lifespan=lifespan)
+app = FastAPI(lifespan=lifespan, docs_url=None, redoc_url=None)
 app.state.limiter = limiter
 
 # Register the custom exception handler for rate limits
@@ -98,6 +98,12 @@ async def llm_txt() -> FileResponse:
     return FileResponse("static/llm.txt")
 
 
+@app.get("/docs", response_class=HTMLResponse)
+async def custom_swagger_ui(request: Request) -> HTMLResponse:
+    """Render the Swagger UI documentation page inside the Jinja theme."""
+    return templates.TemplateResponse("swagger_ui.jinja", {"request": request})
+
+
 # Include routers for modular endpoints
 app.include_router(index)
 app.include_router(ingest)

src/server/templates/swagger_ui.jinja

@@ -0,0 +1,25 @@
+{% extends "base.jinja" %}
+{% block title %}API Docs{% endblock %}
+{% block content %}
+    <div class="bg-[#fff4da] rounded-xl border-[3px] border-gray-900 p-4 md:p-8 relative z-20">
+        <h1 class="text-3xl font-bold text-gray-900 mb-4">API Documentation</h1>
+        <div id="swagger-ui"></div>
+    </div>
+    <link rel="stylesheet"
+          href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+    <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
+    <script>
+  window.onload = function() {
+    SwaggerUIBundle({
+      url: "/openapi.json",
+      dom_id: '#swagger-ui',
+      presets: [
+        SwaggerUIBundle.presets.apis,
+        SwaggerUIBundle.SwaggerUIStandalonePreset
+      ],
+      layout: "BaseLayout",
+      deepLinking: true,
+    });
+  }
+    </script>
+{% endblock %}