feat: custom dashboard at / and route DeerFlow under /app

- Add dashboard.html: status page with links to workspace, setup, API docs
- nginx: location = / serves dashboard.html (alias, no-cache)
- nginx: location = /app redirects 302 → /workspace
- Dockerfile: COPY dashboard.html to /app/dashboard.html

To use DeerFlow: visit /workspace (or /app as alias).
First boot: visit /setup to create admin account before /workspace.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Dockerfile

@@ -96,6 +96,7 @@ COPY --from=source --chown=1000:1000 /src/config.example.yaml /app/config.exampl
 
 # ── Copy HuggingFlow runtime scripts ─────────────────────────────
 COPY --chown=1000:1000 nginx.conf                    /etc/nginx/nginx.conf
+COPY --chown=1000:1000 dashboard.html                /app/dashboard.html
 COPY --chown=1000:1000 start.sh                      /app/start.sh
 COPY --chown=1000:1000 deerflow-sync.py              /app/deerflow-sync.py
 COPY --chown=1000:1000 health-server.js              /app/health-server.js

dashboard.html

@@ -0,0 +1,308 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>HuggingFlow — DeerFlow on Hugging Face</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+    :root {
+      --bg: #0f1117;
+      --surface: #1a1d27;
+      --border: #2a2d3e;
+      --accent: #ff9d00;
+      --accent2: #7c3aed;
+      --text: #e2e8f0;
+      --muted: #64748b;
+      --green: #22c55e;
+      --card: #161927;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      padding: 2rem 1rem;
+    }
+
+    .container { max-width: 720px; width: 100%; }
+
+    /* ── Header ─────────────────────────────────────────── */
+    .header {
+      text-align: center;
+      margin-bottom: 3rem;
+    }
+
+    .logo {
+      font-size: 3.5rem;
+      line-height: 1;
+      margin-bottom: 0.75rem;
+      filter: drop-shadow(0 0 24px rgba(255,157,0,0.4));
+    }
+
+    .title {
+      font-size: 2rem;
+      font-weight: 700;
+      letter-spacing: -0.02em;
+      background: linear-gradient(135deg, #ff9d00 0%, #ff6b35 50%, #7c3aed 100%);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      background-clip: text;
+      margin-bottom: 0.5rem;
+    }
+
+    .subtitle {
+      color: var(--muted);
+      font-size: 0.95rem;
+    }
+
+    .subtitle a {
+      color: var(--accent);
+      text-decoration: none;
+    }
+
+    .subtitle a:hover { text-decoration: underline; }
+
+    /* ── Status pill ────────────────────────────────────── */
+    .status-pill {
+      display: inline-flex;
+      align-items: center;
+      gap: 0.5rem;
+      background: rgba(34,197,94,0.1);
+      border: 1px solid rgba(34,197,94,0.3);
+      color: var(--green);
+      font-size: 0.8rem;
+      font-weight: 600;
+      padding: 0.3rem 0.85rem;
+      border-radius: 999px;
+      margin-bottom: 2rem;
+      letter-spacing: 0.04em;
+      text-transform: uppercase;
+    }
+
+    .dot {
+      width: 7px; height: 7px;
+      background: var(--green);
+      border-radius: 50%;
+      animation: pulse 2s ease-in-out infinite;
+    }
+
+    @keyframes pulse {
+      0%,100% { opacity: 1; transform: scale(1); }
+      50%      { opacity: 0.5; transform: scale(0.8); }
+    }
+
+    /* ── Primary CTA ────────────────────────────────────── */
+    .cta-row {
+      display: flex;
+      gap: 0.75rem;
+      justify-content: center;
+      margin-bottom: 2.5rem;
+      flex-wrap: wrap;
+    }
+
+    .btn {
+      display: inline-flex;
+      align-items: center;
+      gap: 0.45rem;
+      font-size: 0.9rem;
+      font-weight: 600;
+      padding: 0.65rem 1.4rem;
+      border-radius: 8px;
+      text-decoration: none;
+      transition: all 0.15s ease;
+      border: 1px solid transparent;
+    }
+
+    .btn-primary {
+      background: linear-gradient(135deg, #ff9d00, #ff6b35);
+      color: #fff;
+      box-shadow: 0 4px 16px rgba(255,157,0,0.3);
+    }
+
+    .btn-primary:hover {
+      transform: translateY(-1px);
+      box-shadow: 0 6px 24px rgba(255,157,0,0.45);
+    }
+
+    .btn-ghost {
+      background: var(--surface);
+      color: var(--text);
+      border-color: var(--border);
+    }
+
+    .btn-ghost:hover {
+      background: var(--border);
+      transform: translateY(-1px);
+    }
+
+    /* ── Info grid ──────────────────────────────────────── */
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+      gap: 1rem;
+      margin-bottom: 2rem;
+    }
+
+    .card {
+      background: var(--card);
+      border: 1px solid var(--border);
+      border-radius: 12px;
+      padding: 1.25rem 1.5rem;
+    }
+
+    .card-label {
+      font-size: 0.7rem;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.08em;
+      color: var(--muted);
+      margin-bottom: 0.5rem;
+    }
+
+    .card-value {
+      font-size: 1rem;
+      font-weight: 600;
+      color: var(--text);
+    }
+
+    .card-value.mono { font-family: "SF Mono", "Fira Code", monospace; font-size: 0.85rem; }
+
+    /* ── Routes table ───────────────────────────────────── */
+    .routes {
+      background: var(--card);
+      border: 1px solid var(--border);
+      border-radius: 12px;
+      overflow: hidden;
+      margin-bottom: 2rem;
+    }
+
+    .routes-header {
+      padding: 0.85rem 1.5rem;
+      font-size: 0.75rem;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.08em;
+      color: var(--muted);
+      border-bottom: 1px solid var(--border);
+    }
+
+    .route-row {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 0.85rem 1.5rem;
+      border-bottom: 1px solid var(--border);
+      text-decoration: none;
+      color: var(--text);
+      transition: background 0.1s;
+    }
+
+    .route-row:last-child { border-bottom: none; }
+
+    .route-row:hover { background: var(--border); }
+
+    .route-path {
+      font-family: "SF Mono", "Fira Code", monospace;
+      font-size: 0.85rem;
+      color: var(--accent);
+    }
+
+    .route-desc { font-size: 0.85rem; color: var(--muted); }
+
+    .route-arrow { color: var(--muted); font-size: 0.8rem; }
+
+    /* ── Footer ─────────────────────────────────────────── */
+    .footer {
+      text-align: center;
+      font-size: 0.78rem;
+      color: var(--muted);
+    }
+
+    .footer a { color: var(--muted); }
+    .footer a:hover { color: var(--text); }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <div class="logo">🦌</div>
+      <div class="title">HuggingFlow</div>
+      <p class="subtitle">
+        <a href="https://github.com/bytedance/deer-flow" target="_blank" rel="noopener">DeerFlow</a>
+        research agent · hosted on Hugging Face Spaces
+      </p>
+    </div>
+
+    <div style="text-align:center">
+      <span class="status-pill"><span class="dot"></span>Running</span>
+    </div>
+
+    <div class="cta-row">
+      <a href="/workspace" class="btn btn-primary">⚡ Open Workspace</a>
+      <a href="/setup"     class="btn btn-ghost">🔧 Admin Setup</a>
+      <a href="/docs"      class="btn btn-ghost">📖 API Docs</a>
+    </div>
+
+    <div class="grid">
+      <div class="card">
+        <div class="card-label">Stack</div>
+        <div class="card-value">DeerFlow v2</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Backend</div>
+        <div class="card-value mono">FastAPI · port 8001</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Frontend</div>
+        <div class="card-value mono">Next.js · port 3000</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Proxy</div>
+        <div class="card-value mono">nginx · port 7861</div>
+      </div>
+    </div>
+
+    <div class="routes">
+      <div class="routes-header">Available Routes</div>
+      <a href="/"          class="route-row">
+        <span class="route-path">/</span>
+        <span class="route-desc">This dashboard</span>
+        <span class="route-arrow">→</span>
+      </a>
+      <a href="/workspace" class="route-row">
+        <span class="route-path">/workspace</span>
+        <span class="route-desc">DeerFlow research workspace</span>
+        <span class="route-arrow">→</span>
+      </a>
+      <a href="/setup"     class="route-row">
+        <span class="route-path">/setup</span>
+        <span class="route-desc">Admin account creation (first boot)</span>
+        <span class="route-arrow">→</span>
+      </a>
+      <a href="/api/health" class="route-row">
+        <span class="route-path">/api/health</span>
+        <span class="route-desc">Backend health check (JSON)</span>
+        <span class="route-arrow">→</span>
+      </a>
+      <a href="/docs"      class="route-row">
+        <span class="route-path">/docs</span>
+        <span class="route-desc">Swagger API reference</span>
+        <span class="route-arrow">→</span>
+      </a>
+    </div>
+
+    <p class="footer">
+      <a href="https://github.com/somratpro/HuggingFlow" target="_blank" rel="noopener">HuggingFlow</a>
+      · MIT License ·
+      <a href="https://github.com/bytedance/deer-flow" target="_blank" rel="noopener">DeerFlow by ByteDance</a>
+    </p>
+  </div>
+</body>
+</html>

nginx.conf

@@ -120,7 +120,19 @@ http {
             proxy_read_timeout    600s;
         }
 
-        # ── All other requests → Next.js frontend ─────────────────
+        # ── Custom dashboard at root ──────────────────────────
+        location = / {
+            alias /app/dashboard.html;
+            default_type text/html;
+            add_header Cache-Control "no-cache";
+        }
+
+        # ── /app → DeerFlow workspace (convenience alias) ─────
+        location = /app {
+            return 302 /workspace;
+        }
+
+        # ── All other requests → Next.js frontend ─────────────
         location / {
             proxy_pass         http://127.0.0.1:3000;
             proxy_http_version 1.1;