Merge pull request #9 from BinarCode/feature/docs-editor-ui

feat(ui): add --base-path and version bump to 0.20.0

Author: maloun96

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aidocs"
-version = "0.18.0"
+version = "0.20.0"
 description = "AI-powered documentation generator for web applications. Install docs commands into your Claude Code project."
 readme = "README.md"
 license = { text = "MIT" }

src/aidocs_cli/__init__.py

@@ -1,6 +1,6 @@
 """AI-powered documentation generator CLI for Claude Code projects."""
 
-__version__ = "0.17.0"
+__version__ = "0.20.0"
 
 from .cli import app
 

src/aidocs_cli/cli.py

@@ -1259,6 +1259,11 @@ def ui(
         "--reconfigure",
         help="Re-run the setup prompts even if config exists.",
     ),
+    base_path: str = typer.Option(
+        "",
+        "--base-path",
+        help="Base URL path when served behind a reverse proxy (e.g. /admin/docs).",
+    ),
 ) -> None:
     """Launch the web-based docs editor UI.
 
@@ -1350,13 +1355,17 @@ def ui(
     from .ui.app import create_app
 
     full_repo = f"{github_owner}/{github_repo}"
+    # Strip trailing slash from base_path
+    base_path = base_path.rstrip("/")
+
     fastapi_app = create_app(
         docs_dir=target_dir.resolve(),
         github_token=github_token,
         github_repo=full_repo,
         base_branch=github_branch,
         media_path=media_path or None,
         docs_prefix=docs_path,
+        base_path=base_path,
     )
 
     url = f"http://{host}:{port}"

src/aidocs_cli/ui/app.py

@@ -36,6 +36,7 @@ def create_app(
     base_branch: str = "main",
     media_path: str | None = None,
     docs_prefix: str | None = None,
+    base_path: str = "",
 ) -> FastAPI:
     """Create and configure the FastAPI application."""
     owner, repo = github_repo.split("/", 1)
@@ -137,6 +138,7 @@ async def index(request: Request):
         template = (TEMPLATE_DIR / "index.html").read_text(encoding="utf-8")
         rendered = template.replace("{{ tree }}", tree_html)
         rendered = rendered.replace("{{ docs_prefix }}", str(docs_dir))
+        rendered = rendered.replace("{{ base_path }}", base_path)
 
         success_html = ""
         if "success" in flash:
@@ -208,7 +210,7 @@ async def api_store(request: Request):
         except Exception as e:
             _flash(request, "error", f"Failed: {e}")
 
-        return RedirectResponse("/", status_code=303)
+        return RedirectResponse(f"{base_path}/", status_code=303)
 
     @app.post("/api/update")
     async def api_update(request: Request):
@@ -243,7 +245,7 @@ async def api_update(request: Request):
         except Exception as e:
             _flash(request, "error", f"Failed to create PR: {e}")
 
-        return RedirectResponse("/", status_code=303)
+        return RedirectResponse(f"{base_path}/", status_code=303)
 
     @app.post("/api/delete")
     async def api_delete(request: Request):
@@ -263,7 +265,7 @@ async def api_delete(request: Request):
         except Exception as e:
             _flash(request, "error", f"Failed to create delete PR: {e}")
 
-        return RedirectResponse("/", status_code=303)
+        return RedirectResponse(f"{base_path}/", status_code=303)
 
     @app.post("/api/upload-image")
     async def api_upload_image(

src/aidocs_cli/ui/templates/index.html

@@ -32,7 +32,7 @@
         <div class="max-w-[1600px] mx-auto px-6 py-3 flex items-center justify-between">
             <div class="flex items-center gap-2">
                 <svg class="w-5 h-5 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/></svg>
-                <a href="/" class="text-base font-semibold text-gray-800">Docs Editor</a>
+                <a href="{{ base_path }}/" class="text-base font-semibold text-gray-800">Docs Editor</a>
             </div>
             <button type="button" id="sync-btn"
                     class="flex items-center gap-1.5 px-3 py-1.5 text-xs font-medium text-gray-600 border border-gray-200 rounded-lg hover:bg-gray-50 transition">
@@ -46,7 +46,7 @@
         {{ flash_messages }}
 
         <!-- Hidden delete form -->
-        <form id="delete-form" action="/api/delete" method="POST" class="hidden">
+        <form id="delete-form" action="{{ base_path }}/api/delete" method="POST" class="hidden">
             <input type="hidden" name="path" id="d-path">
         </form>
 
@@ -86,7 +86,7 @@
                 </div>
 
                 <!-- Edit Form -->
-                <form action="/api/update" method="POST"
+                <form action="{{ base_path }}/api/update" method="POST"
                       class="hidden flex-1 flex flex-col" id="edit-form">
                     <input type="hidden" name="path" id="f-path">
                     <input type="hidden" name="uploaded_images" id="f-uploaded-images">
@@ -181,7 +181,7 @@ <h2 class="text-sm font-semibold text-gray-800 truncate capitalize" id="editor-t
                 </form>
 
                 <!-- Create Form -->
-                <form action="/api/store" method="POST"
+                <form action="{{ base_path }}/api/store" method="POST"
                       class="hidden flex-1 flex flex-col" id="create-form">
 
                     <div class="bg-white rounded-t-xl border border-gray-200 px-5 py-3 flex items-center justify-between shadow-sm">
@@ -265,6 +265,7 @@ <h2 class="text-sm font-semibold text-gray-800">New Page</h2>
 
         <script>
             const docsPrefix = '{{ docs_prefix }}';
+            const basePath = '{{ base_path }}';
             const md = window.markdownit({ html: true, linkify: true, typographer: true });
             let currentTab = localStorage.getItem('docs-editor-tab') || 'editor';
             let previewTimer = null;
@@ -418,7 +419,7 @@ <h2 class="text-sm font-semibold text-gray-800">New Page</h2>
 
                     showPanel('loading-state');
 
-                    fetch('/api/edit?path=' + encodeURIComponent(this.dataset.path), {
+                    fetch(basePath + '/api/edit?path=' + encodeURIComponent(this.dataset.path), {
                         headers: { 'Accept': 'application/json' }
                     })
                     .then(r => r.json())
@@ -462,7 +463,7 @@ <h2 class="text-sm font-semibold text-gray-800">New Page</h2>
                 setDirty(false);
                 showPanel('loading-state');
 
-                fetch('/api/folders', { headers: { 'Accept': 'application/json' } })
+                fetch(basePath + '/api/folders', { headers: { 'Accept': 'application/json' } })
                     .then(r => r.json())
                     .then(data => {
                         const select = document.getElementById('c-folder');
@@ -543,7 +544,7 @@ <h2 class="text-sm font-semibold text-gray-800">New Page</h2>
                     checkDirty();
                     schedulePreview();
 
-                    fetch('/api/upload-image', {
+                    fetch(basePath + '/api/upload-image', {
                         method: 'POST',
                         body: formData,
                     })
@@ -657,7 +658,7 @@ <h2 class="text-sm font-semibold text-gray-800">New Page</h2>
                 btn.classList.add('opacity-50');
                 icon.classList.add('animate-spin');
 
-                fetch('/api/sync', { method: 'POST' })
+                fetch(basePath + '/api/sync', { method: 'POST' })
                     .then(r => r.json())
                     .then(data => {
                         if (data.success) {