Commit 6: Adminbereich (TanStack Router, 8 Menüpunkte, Scan-Logs)

2026-07-19 02:53:04 +02:00
parent b0ff551ca0
commit 2f31996bbb
31 changed files with 1693 additions and 112 deletions
--- a/README.md
+++ b/README.md
@@ -72,12 +72,17 @@ Dieser erste Commit liefert ein lauffähiges Grundgerüst:
  (HTTP-Digest-Auth). Läuft ausschließlich manuell per API-Aufruf – nie automatisch.
  Benutzeränderungen an Diensten (Name, Kategorie, Favorit, Alias, Icon, Reihenfolge)
  bleiben bei erneuten Scans garantiert erhalten.
+- ✅ Adminbereich unter `/admin` (TanStack Router): Dashboard, Geräte (inkl.
+  „Jetzt scannen"-Button), Dienste (Inline-Bearbeitung), Kategorien (natives
+  Drag & Drop), Scanner (FritzBox-Trigger + Sammel-Scan), Logs (Scan-Historie),
+  Einstellungen (Live-Systeminfo + Theme), Plugins (ehrlicher Hinweis auf
+  zukünftigen Commit)

 Noch **nicht** enthalten (folgt in den nächsten Commits):

- Adminbereich mit "Jetzt scannen"-Button und Kategorien-Verwaltungsoberfläche
-  — beide Backend-APIs existieren bereits vollständig
- TanStack Router, Plugin-System, PWA-Manifest, shadcn/ui, RHF
+- Plugin-System (Scanner registrieren, Geräte importieren, Menüs erweitern, Icons)
+- PWA-Manifest / Offline-Grundfunktion
+- shadcn/ui, React Hook Form (aktuell einfache kontrollierte Formulare)

 ### Umgebungsvariablen (.env)

@@ -134,6 +139,23 @@ POST   /api/scan/devices/:id      Netzwerk-Scan für ein Gerät (DNS, Ports, Tit
                                   Favicon, Softwareerkennung); legt/aktualisiert Dienste
 POST   /api/scan/fritzbox         Liest Geräteliste der FritzBox per TR-064
                                   (erfordert FRITZBOX_HOST/USERNAME/PASSWORD)
+
+GET    /api/logs                  optional ?limit= (Default 100, Max 500)
+```
+
+## Frontend-Routen
+
+```
+/                                 Startseite: minimalistische Suche
+/admin                            -> redirect zu /admin/dashboard
+/admin/dashboard
+/admin/devices
+/admin/services
+/admin/categories
+/admin/scanner
+/admin/plugins                    Hinweis: Plugin-System noch nicht gebaut
+/admin/settings
+/admin/logs
 ```

 ## Deployment auf dem Server (xlc-launchpad)
--- a/apps/backend/src/db/client.ts
+++ b/apps/backend/src/db/client.ts
@@ -66,5 +66,14 @@ export function ensureSchema(): void {
      created_at TEXT NOT NULL,
      updated_at TEXT NOT NULL
    );
+
+    CREATE TABLE IF NOT EXISTS scan_logs (
+      id TEXT PRIMARY KEY,
+      type TEXT NOT NULL,
+      target_id TEXT,
+      level TEXT NOT NULL,
+      message TEXT NOT NULL,
+      created_at TEXT NOT NULL
+    );
  `);
 }
--- a/apps/backend/src/db/repositories/logs.ts
+++ b/apps/backend/src/db/repositories/logs.ts
@@ -0,0 +1,52 @@
+import { randomUUID } from "node:crypto";
+import { desc } from "drizzle-orm";
+import type { ScanLogEntry } from "@launchpad/shared";
+import { db } from "../client.js";
+import { scanLogs } from "../schema.js";
+
+function mapRow(row: typeof scanLogs.$inferSelect): ScanLogEntry {
+  return {
+    id: row.id,
+    type: row.type as ScanLogEntry["type"],
+    targetId: row.targetId,
+    level: row.level as ScanLogEntry["level"],
+    message: row.message,
+    createdAt: row.createdAt,
+  };
+}
+
+export interface LogScanInput {
+  type: ScanLogEntry["type"];
+  targetId?: string | null;
+  level: ScanLogEntry["level"];
+  message: string;
+}
+
+/** Schreibt einen Eintrag für einen Scan-Versuch (Erfolg oder Fehler). */
+export function logScan(input: LogScanInput): ScanLogEntry {
+  const id = randomUUID();
+  const createdAt = new Date().toISOString();
+
+  db.insert(scanLogs)
+    .values({
+      id,
+      type: input.type,
+      targetId: input.targetId ?? null,
+      level: input.level,
+      message: input.message,
+      createdAt,
+    })
+    .run();
+
+  return { id, type: input.type, targetId: input.targetId ?? null, level: input.level, message: input.message, createdAt };
+}
+
+export function listLogs(limit = 100): ScanLogEntry[] {
+  return db
+    .select()
+    .from(scanLogs)
+    .orderBy(desc(scanLogs.createdAt))
+    .limit(limit)
+    .all()
+    .map(mapRow);
+}
--- a/apps/backend/src/db/schema.ts
+++ b/apps/backend/src/db/schema.ts
@@ -58,3 +58,16 @@ export const categories = sqliteTable("categories", {
  createdAt: text("created_at").notNull(),
  updatedAt: text("updated_at").notNull(),
 });
+
+/**
+ * Protokoll jedes Scan-Versuchs (Geräte-Netzwerk-Scan oder FritzBox-Scan),
+ * angezeigt im Adminbereich unter "Logs".
+ */
+export const scanLogs = sqliteTable("scan_logs", {
+  id: text("id").primaryKey(),
+  type: text("type").notNull(), // "device" | "fritzbox"
+  targetId: text("target_id"), // Geräte-ID bei type "device", sonst null
+  level: text("level").notNull(), // "info" | "error"
+  message: text("message").notNull(),
+  createdAt: text("created_at").notNull(),
+});
--- a/apps/backend/src/index.ts
+++ b/apps/backend/src/index.ts
@@ -7,6 +7,7 @@ import { deviceRoutes } from "./routes/devices.js";
 import { serviceRoutes } from "./routes/services.js";
 import { categoryRoutes } from "./routes/categories.js";
 import { scanRoutes } from "./routes/scan.js";
+import { logRoutes } from "./routes/logs.js";

 const PORT = Number(process.env.PORT ?? 3001);
 const HOST = process.env.HOST ?? "0.0.0.0";
@@ -33,6 +34,7 @@ async function main() {
  await app.register(serviceRoutes);
  await app.register(categoryRoutes);
  await app.register(scanRoutes);
+  await app.register(logRoutes);

  app.get("/", async () => {
    return { name: "LaunchPad API", status: "running" };
--- a/apps/backend/src/routes/logs.ts
+++ b/apps/backend/src/routes/logs.ts
@@ -0,0 +1,10 @@
+import type { FastifyInstance } from "fastify";
+import * as logRepo from "../db/repositories/logs.js";
+
+export async function logRoutes(app: FastifyInstance): Promise<void> {
+  app.get("/api/logs", async (request) => {
+    const query = request.query as { limit?: string };
+    const limit = query.limit ? Math.min(Number(query.limit), 500) : 100;
+    return logRepo.listLogs(limit);
+  });
+}
--- a/apps/backend/src/routes/scan.ts
+++ b/apps/backend/src/routes/scan.ts
@@ -1,17 +1,17 @@
 import type { FastifyInstance } from "fastify";
 import * as deviceRepo from "../db/repositories/devices.js";
 import * as serviceRepo from "../db/repositories/services.js";
+import * as logRepo from "../db/repositories/logs.js";
 import { scanDeviceServices } from "../scanner/networkScanner.js";
 import { fetchFritzBoxHosts } from "../scanner/fritzbox.js";

 /**
 * Scan-Endpunkte. Werden ausschließlich manuell per Knopfdruck ("Jetzt
- * scannen") aus der Admin-UI (Commit 6) ausgelöst – es gibt keinerlei
- * automatischen/zeitgesteuerten Scan.
+ * scannen") aus der Admin-UI ausgelöst – es gibt keinerlei automatischen/
+ * zeitgesteuerten Scan. Jeder Versuch (Erfolg oder Fehler) wird in scan_logs
+ * protokolliert und ist unter Admin -> Logs einsehbar.
 */
 export async function scanRoutes(app: FastifyInstance): Promise<void> {
-  // Netzwerk-Scan für ein einzelnes, bereits bekanntes Gerät: DNS-Kandidaten,
-  // Port 80/443 + typische Ports, Titel/Favicon, Softwareerkennung.
  app.post("/api/scan/devices/:id", async (request, reply) => {
    const { id } = request.params as { id: string };
    const device = deviceRepo.getDevice(id);
@@ -19,39 +19,61 @@ export async function scanRoutes(app: FastifyInstance): Promise<void> {
      return reply.code(404).send({ error: "Gerät nicht gefunden" });
    }

-    const discovered = await scanDeviceServices(device);
+    try {
+      const discovered = await scanDeviceServices(device);

-    const results = discovered.map((found) =>
-      serviceRepo.upsertServiceFromScan({
+      const results = discovered.map((found) =>
+        serviceRepo.upsertServiceFromScan({
+          deviceId: device.id,
+          hostname: found.hostname,
+          url: found.url,
+          https: found.https,
+          port: found.port,
+          favicon: found.favicon,
+          description: found.description,
+          suggestedDisplayName: found.suggestedDisplayName,
+          suggestedCategory: found.category,
+        })
+      );
+
+      deviceRepo.upsertDeviceFromScan({
+        hostname: device.hostname,
+        ip: device.ip,
+        mac: device.mac,
+        manufacturer: device.manufacturer,
+        model: device.model,
+        online: discovered.length > 0,
+        source: device.source,
+      });
+
+      const created = results.filter((r) => r.created).length;
+      const updated = results.filter((r) => !r.created).length;
+
+      logRepo.logScan({
+        type: "device",
+        targetId: device.id,
+        level: "info",
+        message: `${device.hostname} (${device.ip}): ${discovered.length} Dienst(e) gefunden, ${created} neu, ${updated} aktualisiert`,
+      });
+
+      return {
        deviceId: device.id,
-        hostname: found.hostname,
-        url: found.url,
-        https: found.https,
-        port: found.port,
-        favicon: found.favicon,
-        description: found.description,
-        suggestedDisplayName: found.suggestedDisplayName,
-        suggestedCategory: found.category,
-      })
-    );
-
-    deviceRepo.upsertDeviceFromScan({
-      hostname: device.hostname,
-      ip: device.ip,
-      mac: device.mac,
-      manufacturer: device.manufacturer,
-      model: device.model,
-      online: discovered.length > 0,
-      source: device.source,
-    });
-
-    return {
-      deviceId: device.id,
-      scannedPorts: discovered.length,
-      created: results.filter((r) => r.created).length,
-      updated: results.filter((r) => !r.created).length,
-      services: results.map((r) => r.service),
-    };
+        scannedPorts: discovered.length,
+        created,
+        updated,
+        services: results.map((r) => r.service),
+      };
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      logRepo.logScan({
+        type: "device",
+        targetId: device.id,
+        level: "error",
+        message: `${device.hostname} (${device.ip}): Scan fehlgeschlagen – ${detail}`,
+      });
+      request.log.error(err);
+      return reply.code(500).send({ error: "Geräte-Scan fehlgeschlagen", detail });
+    }
  });

  // FritzBox-Scan: liest die Geräteliste per TR-064 und legt/aktualisiert Geräte.
@@ -82,13 +104,23 @@ export async function scanRoutes(app: FastifyInstance): Promise<void> {
          source: "fritzbox",
        })
      );
+
+      logRepo.logScan({
+        type: "fritzbox",
+        level: "info",
+        message: `FritzBox-Scan: ${hosts.length} Gerät(e) gefunden`,
+      });
+
      return { found: hosts.length, devices };
    } catch (err) {
-      request.log.error(err);
-      return reply.code(502).send({
-        error: "FritzBox-Scan fehlgeschlagen",
-        detail: err instanceof Error ? err.message : String(err),
+      const detail = err instanceof Error ? err.message : String(err);
+      logRepo.logScan({
+        type: "fritzbox",
+        level: "error",
+        message: `FritzBox-Scan fehlgeschlagen – ${detail}`,
      });
+      request.log.error(err);
+      return reply.code(502).send({ error: "FritzBox-Scan fehlgeschlagen", detail });
    }
  });
 }
--- a/apps/frontend/package.json
+++ b/apps/frontend/package.json
@@ -13,6 +13,7 @@
    "@launchpad/shared": "workspace:*",
    "@launchpad/ui": "workspace:*",
    "@tanstack/react-query": "^5.51.23",
+    "@tanstack/react-router": "^1.58.3",
    "react": "^18.3.1",
    "react-dom": "^18.3.1"
  },
--- a/apps/frontend/src/hooks/useBackendHealth.ts
+++ b/apps/frontend/src/hooks/useBackendHealth.ts
@@ -0,0 +1,34 @@
+import { useEffect, useState } from "react";
+import type { HealthStatus } from "@launchpad/shared";
+
+export function useBackendHealth() {
+  const [health, setHealth] = useState<HealthStatus | null>(null);
+  const [error, setError] = useState(false);
+
+  useEffect(() => {
+    let cancelled = false;
+
+    async function check() {
+      try {
+        const res = await fetch("/api/health");
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        const data: HealthStatus = await res.json();
+        if (!cancelled) {
+          setHealth(data);
+          setError(false);
+        }
+      } catch {
+        if (!cancelled) setError(true);
+      }
+    }
+
+    check();
+    const interval = setInterval(check, 10_000);
+    return () => {
+      cancelled = true;
+      clearInterval(interval);
+    };
+  }, []);
+
+  return { health, error };
+}
--- a/apps/frontend/src/hooks/useCategories.ts
+++ b/apps/frontend/src/hooks/useCategories.ts
@@ -0,0 +1,17 @@
+import { useQuery } from "@tanstack/react-query";
+import type { Category } from "@launchpad/shared";
+
+async function fetchCategories(): Promise<Category[]> {
+  const res = await fetch("/api/categories");
+  if (!res.ok) {
+    throw new Error(`Kategorien konnten nicht geladen werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+export function useCategories() {
+  return useQuery({
+    queryKey: ["categories"],
+    queryFn: fetchCategories,
+  });
+}
--- a/apps/frontend/src/hooks/useDevices.ts
+++ b/apps/frontend/src/hooks/useDevices.ts
@@ -0,0 +1,21 @@
+import { useQuery } from "@tanstack/react-query";
+import type { Device, Service } from "@launchpad/shared";
+
+export interface DeviceWithServices extends Device {
+  services: Service[];
+}
+
+async function fetchDevices(): Promise<DeviceWithServices[]> {
+  const res = await fetch("/api/devices");
+  if (!res.ok) {
+    throw new Error(`Geräte konnten nicht geladen werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+export function useDevices() {
+  return useQuery({
+    queryKey: ["devices"],
+    queryFn: fetchDevices,
+  });
+}
--- a/apps/frontend/src/hooks/useLogs.ts
+++ b/apps/frontend/src/hooks/useLogs.ts
@@ -0,0 +1,18 @@
+import { useQuery } from "@tanstack/react-query";
+import type { ScanLogEntry } from "@launchpad/shared";
+
+async function fetchLogs(): Promise<ScanLogEntry[]> {
+  const res = await fetch("/api/logs");
+  if (!res.ok) {
+    throw new Error(`Logs konnten nicht geladen werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+export function useLogs() {
+  return useQuery({
+    queryKey: ["logs"],
+    queryFn: fetchLogs,
+    refetchInterval: 5000,
+  });
+}
--- a/apps/frontend/src/hooks/useTheme.ts
+++ b/apps/frontend/src/hooks/useTheme.ts
@@ -0,0 +1,22 @@
+import { useEffect, useState } from "react";
+
+export type Theme = "light" | "dark";
+
+export function useTheme(): [Theme, () => void] {
+  const [theme, setTheme] = useState<Theme>(() => {
+    if (typeof window === "undefined") return "dark";
+    const stored = window.localStorage.getItem("launchpad-theme");
+    if (stored === "light" || stored === "dark") return stored;
+    return window.matchMedia("(prefers-color-scheme: dark)").matches
+      ? "dark"
+      : "light";
+  });
+
+  useEffect(() => {
+    document.documentElement.classList.toggle("dark", theme === "dark");
+    window.localStorage.setItem("launchpad-theme", theme);
+  }, [theme]);
+
+  const toggle = () => setTheme((t) => (t === "dark" ? "light" : "dark"));
+  return [theme, toggle];
+}
--- a/apps/frontend/src/main.tsx
+++ b/apps/frontend/src/main.tsx
@@ -1,7 +1,8 @@
 import React from "react";
 import ReactDOM from "react-dom/client";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import App from "./App.js";
+import { RouterProvider } from "@tanstack/react-router";
+import { router } from "./router.js";
 import "./index.css";

 const queryClient = new QueryClient({
@@ -16,7 +17,7 @@ const queryClient = new QueryClient({
 ReactDOM.createRoot(document.getElementById("root")!).render(
  <React.StrictMode>
    <QueryClientProvider client={queryClient}>
-      <App />
+      <RouterProvider router={router} />
    </QueryClientProvider>
  </React.StrictMode>
 );
--- a/apps/frontend/src/router.tsx
+++ b/apps/frontend/src/router.tsx
@@ -0,0 +1,107 @@
+import { Outlet, createRootRoute, createRoute, createRouter, redirect } from "@tanstack/react-router";
+import { HomePage } from "./routes/HomePage.js";
+import { AdminLayout } from "./routes/admin/AdminLayout.js";
+import { DashboardPage } from "./routes/admin/DashboardPage.js";
+import { DevicesPage } from "./routes/admin/DevicesPage.js";
+import { ServicesPage } from "./routes/admin/ServicesPage.js";
+import { CategoriesPage } from "./routes/admin/CategoriesPage.js";
+import { ScannerPage } from "./routes/admin/ScannerPage.js";
+import { PluginsPage } from "./routes/admin/PluginsPage.js";
+import { SettingsPage } from "./routes/admin/SettingsPage.js";
+import { LogsPage } from "./routes/admin/LogsPage.js";
+
+const rootRoute = createRootRoute({
+  component: () => <Outlet />,
+});
+
+const indexRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/",
+  component: HomePage,
+});
+
+const adminRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/admin",
+  component: AdminLayout,
+});
+
+// /admin ohne weiteren Pfad -> Dashboard
+const adminIndexRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/",
+  loader: () => {
+    throw redirect({ to: "/admin/dashboard" });
+  },
+});
+
+const adminDashboardRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/dashboard",
+  component: DashboardPage,
+});
+
+const adminDevicesRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/devices",
+  component: DevicesPage,
+});
+
+const adminServicesRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/services",
+  component: ServicesPage,
+});
+
+const adminCategoriesRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/categories",
+  component: CategoriesPage,
+});
+
+const adminScannerRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/scanner",
+  component: ScannerPage,
+});
+
+const adminPluginsRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/plugins",
+  component: PluginsPage,
+});
+
+const adminSettingsRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/settings",
+  component: SettingsPage,
+});
+
+const adminLogsRoute = createRoute({
+  getParentRoute: () => adminRoute,
+  path: "/logs",
+  component: LogsPage,
+});
+
+const routeTree = rootRoute.addChildren([
+  indexRoute,
+  adminRoute.addChildren([
+    adminIndexRoute,
+    adminDashboardRoute,
+    adminDevicesRoute,
+    adminServicesRoute,
+    adminCategoriesRoute,
+    adminScannerRoute,
+    adminPluginsRoute,
+    adminSettingsRoute,
+    adminLogsRoute,
+  ]),
+]);
+
+export const router = createRouter({ routeTree });
+
+declare module "@tanstack/react-router" {
+  interface Register {
+    router: typeof router;
+  }
+}
--- a/apps/frontend/src/routes/HomePage.tsx
+++ b/apps/frontend/src/routes/HomePage.tsx
@@ -1,61 +1,11 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Link } from "@tanstack/react-router";
 import { SearchInput, StatusBadge, ResultsList } from "@launchpad/ui";
-import { rankServices, type Service, type HealthStatus } from "@launchpad/shared";
-import { useServices } from "./hooks/useServices.js";
-
-type Theme = "light" | "dark";
-
-function useTheme(): [Theme, () => void] {
-  const [theme, setTheme] = useState<Theme>(() => {
-    if (typeof window === "undefined") return "dark";
-    const stored = window.localStorage.getItem("launchpad-theme");
-    if (stored === "light" || stored === "dark") return stored;
-    return window.matchMedia("(prefers-color-scheme: dark)").matches
-      ? "dark"
-      : "light";
-  });
-
-  useEffect(() => {
-    document.documentElement.classList.toggle("dark", theme === "dark");
-    window.localStorage.setItem("launchpad-theme", theme);
-  }, [theme]);
-
-  const toggle = () => setTheme((t) => (t === "dark" ? "light" : "dark"));
-  return [theme, toggle];
-}
-
-function useBackendHealth() {
-  const [health, setHealth] = useState<HealthStatus | null>(null);
-  const [error, setError] = useState(false);
-
-  useEffect(() => {
-    let cancelled = false;
-
-    async function check() {
-      try {
-        const res = await fetch("/api/health");
-        if (!res.ok) throw new Error(`HTTP ${res.status}`);
-        const data: HealthStatus = await res.json();
-        if (!cancelled) {
-          setHealth(data);
-          setError(false);
-        }
-      } catch {
-        if (!cancelled) setError(true);
-      }
-    }
-
-    check();
-    const interval = setInterval(check, 10_000);
-    return () => {
-      cancelled = true;
-      clearInterval(interval);
-    };
-  }, []);
-
-  return { health, error };
-}
+import { rankServices, type Service } from "@launchpad/shared";
+import { useServices } from "../hooks/useServices.js";
+import { useBackendHealth } from "../hooks/useBackendHealth.js";
+import { useTheme } from "../hooks/useTheme.js";

 function openService(service: Service) {
  window.open(service.url, "_blank", "noopener,noreferrer");
@@ -73,7 +23,7 @@ async function toggleServiceFavorite(service: Service): Promise<Service> {
  return res.json();
 }

-export default function App() {
+export function HomePage() {
  const [theme, toggleTheme] = useTheme();
  const [query, setQuery] = useState("");
  const [selectedIndex, setSelectedIndex] = useState(0);
@@ -136,14 +86,24 @@ export default function App() {

  return (
    <div className="flex min-h-screen flex-col items-center justify-start gap-8 bg-gradient-to-b from-white to-neutral-100 px-6 pt-[15vh] dark:from-black dark:to-neutral-950">
-      <button
-        onClick={toggleTheme}
-        aria-label="Theme wechseln"
-        className="fixed right-6 top-6 rounded-full border border-black/10 p-2 text-black/60
-          transition-colors hover:bg-black/5 dark:border-white/10 dark:text-white/60 dark:hover:bg-white/5"
-      >
-        {theme === "dark" ? "☀️" : "🌙"}
-      </button>
+      <div className="fixed right-6 top-6 flex items-center gap-2">
+        <Link
+          to="/admin"
+          aria-label="Adminbereich öffnen"
+          className="rounded-full border border-black/10 p-2 text-black/60 transition-colors
+            hover:bg-black/5 dark:border-white/10 dark:text-white/60 dark:hover:bg-white/5"
+        >
+          ⚙️
+        </Link>
+        <button
+          onClick={toggleTheme}
+          aria-label="Theme wechseln"
+          className="rounded-full border border-black/10 p-2 text-black/60 transition-colors
+            hover:bg-black/5 dark:border-white/10 dark:text-white/60 dark:hover:bg-white/5"
+        >
+          {theme === "dark" ? "☀️" : "🌙"}
+        </button>
+      </div>

      <div className="flex flex-col items-center gap-2 text-center">
        <h1 className="text-4xl font-semibold tracking-tight text-black dark:text-white">
@@ -181,7 +141,7 @@ export default function App() {
            onToggleFavorite={(service) => toggleFavorite.mutate(service)}
            emptyLabel={
              (services?.length ?? 0) === 0
-                ? "Noch keine Dienste angelegt. Füge welche über die API hinzu."
+                ? "Noch keine Dienste angelegt. Füge welche im Adminbereich hinzu."
                : "Keine Treffer für deine Suche."
            }
          />
--- a/apps/frontend/src/routes/admin/AdminLayout.tsx
+++ b/apps/frontend/src/routes/admin/AdminLayout.tsx
@@ -0,0 +1,64 @@
+import { Link, Outlet, useRouterState } from "@tanstack/react-router";
+
+const NAV_ITEMS = [
+  { to: "/admin/dashboard", label: "Dashboard", icon: "📊" },
+  { to: "/admin/devices", label: "Geräte", icon: "🖥️" },
+  { to: "/admin/services", label: "Dienste", icon: "🔗" },
+  { to: "/admin/scanner", label: "Scanner", icon: "🔍" },
+  { to: "/admin/categories", label: "Kategorien", icon: "🏷️" },
+  { to: "/admin/plugins", label: "Plugins", icon: "🧩" },
+  { to: "/admin/settings", label: "Einstellungen", icon: "⚙️" },
+  { to: "/admin/logs", label: "Logs", icon: "📜" },
+] as const;
+
+export function AdminLayout() {
+  const pathname = useRouterState({ select: (s) => s.location.pathname });
+
+  return (
+    <div className="flex min-h-screen bg-neutral-50 dark:bg-neutral-950">
+      <aside className="flex w-56 shrink-0 flex-col border-r border-black/10 bg-white/70 dark:border-white/10 dark:bg-white/5">
+        <div className="flex items-center gap-2 border-b border-black/10 px-5 py-4 dark:border-white/10">
+          <Link to="/" className="text-lg font-semibold text-black dark:text-white">
+            LaunchPad
+          </Link>
+        </div>
+
+        <nav className="flex flex-1 flex-col gap-0.5 p-3">
+          {NAV_ITEMS.map((item) => {
+            const active = pathname.startsWith(item.to);
+            return (
+              <Link
+                key={item.to}
+                to={item.to}
+                className={`flex items-center gap-2.5 rounded-lg px-3 py-2 text-sm font-medium transition-colors ${
+                  active
+                    ? "bg-black/5 text-black dark:bg-white/10 dark:text-white"
+                    : "text-black/60 hover:bg-black/5 hover:text-black dark:text-white/60 dark:hover:bg-white/5 dark:hover:text-white"
+                }`}
+              >
+                <span aria-hidden>{item.icon}</span>
+                {item.label}
+              </Link>
+            );
+          })}
+        </nav>
+
+        <div className="border-t border-black/10 p-3 dark:border-white/10">
+          <Link
+            to="/"
+            className="flex items-center gap-2.5 rounded-lg px-3 py-2 text-sm font-medium
+              text-black/60 transition-colors hover:bg-black/5 hover:text-black
+              dark:text-white/60 dark:hover:bg-white/5 dark:hover:text-white"
+          >
+            <span aria-hidden>←</span>
+            Zurück zur Suche
+          </Link>
+        </div>
+      </aside>
+
+      <main className="flex-1 overflow-y-auto p-8">
+        <Outlet />
+      </main>
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/AdminPageHeader.tsx
+++ b/apps/frontend/src/routes/admin/AdminPageHeader.tsx
@@ -0,0 +1,21 @@
+import type { ReactNode } from "react";
+
+export interface AdminPageHeaderProps {
+  title: string;
+  description?: string;
+  actions?: ReactNode;
+}
+
+export function AdminPageHeader({ title, description, actions }: AdminPageHeaderProps) {
+  return (
+    <div className="mb-6 flex items-start justify-between gap-4">
+      <div>
+        <h1 className="text-2xl font-semibold text-black dark:text-white">{title}</h1>
+        {description ? (
+          <p className="mt-1 text-sm text-black/50 dark:text-white/50">{description}</p>
+        ) : null}
+      </div>
+      {actions ? <div className="flex shrink-0 items-center gap-2">{actions}</div> : null}
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/CategoriesPage.tsx
+++ b/apps/frontend/src/routes/admin/CategoriesPage.tsx
@@ -0,0 +1,243 @@
+import { useState, type DragEvent, type FormEvent } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Button } from "@launchpad/ui";
+import type { Category } from "@launchpad/shared";
+import { useCategories } from "../../hooks/useCategories.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+async function createCategory(name: string): Promise<Category> {
+  const res = await fetch("/api/categories", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ name }),
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `Kategorie konnte nicht angelegt werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+async function renameCategory(id: string, name: string): Promise<Category> {
+  const res = await fetch(`/api/categories/${id}`, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ name }),
+  });
+  if (!res.ok) {
+    throw new Error(`Kategorie konnte nicht umbenannt werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+async function deleteCategoryRequest(id: string) {
+  const res = await fetch(`/api/categories/${id}`, { method: "DELETE" });
+  if (!res.ok && res.status !== 404) {
+    throw new Error(`Kategorie konnte nicht gelöscht werden (HTTP ${res.status})`);
+  }
+}
+
+async function reorderCategories(entries: { id: string; order: number }[]) {
+  const res = await fetch("/api/categories/reorder", {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(entries),
+  });
+  if (!res.ok) {
+    throw new Error(`Reihenfolge konnte nicht gespeichert werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+function CategoryRow({
+  category,
+  onDragStart,
+  onDragOver,
+  onDrop,
+  isDragging,
+}: {
+  category: Category;
+  onDragStart: (e: DragEvent<HTMLLIElement>) => void;
+  onDragOver: (e: DragEvent<HTMLLIElement>) => void;
+  onDrop: (e: DragEvent<HTMLLIElement>) => void;
+  isDragging: boolean;
+}) {
+  const queryClient = useQueryClient();
+  const [editing, setEditing] = useState(false);
+  const [name, setName] = useState(category.name);
+
+  const renameMutation = useMutation({
+    mutationFn: () => renameCategory(category.id, name.trim()),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["categories"] });
+      setEditing(false);
+    },
+  });
+
+  const deleteMutation = useMutation({
+    mutationFn: () => deleteCategoryRequest(category.id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["categories"] });
+      queryClient.invalidateQueries({ queryKey: ["services"] });
+    },
+  });
+
+  return (
+    <li
+      draggable
+      onDragStart={onDragStart}
+      onDragOver={onDragOver}
+      onDrop={onDrop}
+      data-category-id={category.id}
+      className={`flex items-center gap-3 border-b border-black/5 px-4 py-3 last:border-0
+        dark:border-white/5 ${isDragging ? "opacity-40" : ""}`}
+    >
+      <span className="cursor-grab select-none text-black/30 dark:text-white/30" aria-hidden>
+        ⠿⠿
+      </span>
+
+      {editing ? (
+        <>
+          <input
+            value={name}
+            onChange={(e) => setName(e.target.value)}
+            autoFocus
+            className="flex-1 rounded-lg border border-black/10 bg-white px-2 py-1 text-sm
+              dark:border-white/10 dark:bg-white/10 dark:text-white"
+          />
+          <Button size="sm" variant="primary" onClick={() => renameMutation.mutate()} disabled={renameMutation.isPending}>
+            Speichern
+          </Button>
+          <Button size="sm" variant="ghost" onClick={() => setEditing(false)}>
+            Abbrechen
+          </Button>
+        </>
+      ) : (
+        <>
+          <span className="flex-1 text-sm font-medium text-black dark:text-white">{category.name}</span>
+          <Button size="sm" onClick={() => setEditing(true)}>
+            Umbenennen
+          </Button>
+          <Button size="sm" variant="danger" onClick={() => deleteMutation.mutate()} disabled={deleteMutation.isPending}>
+            Löschen
+          </Button>
+        </>
+      )}
+    </li>
+  );
+}
+
+export function CategoriesPage() {
+  const { data: categories, isLoading, isError } = useCategories();
+  const queryClient = useQueryClient();
+  const [newName, setNewName] = useState("");
+  const [draggedId, setDraggedId] = useState<string | null>(null);
+  const [localOrder, setLocalOrder] = useState<Category[] | null>(null);
+
+  const createMutation = useMutation({
+    mutationFn: () => createCategory(newName.trim()),
+    onSuccess: () => {
+      setNewName("");
+      queryClient.invalidateQueries({ queryKey: ["categories"] });
+    },
+  });
+
+  const reorderMutation = useMutation({
+    mutationFn: reorderCategories,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["categories"] });
+      setLocalOrder(null);
+    },
+    onError: () => setLocalOrder(null),
+  });
+
+  const list = localOrder ?? categories ?? [];
+
+  function handleSubmit(e: FormEvent) {
+    e.preventDefault();
+    if (!newName.trim()) return;
+    createMutation.mutate();
+  }
+
+  function handleDragStart(id: string) {
+    return (_e: DragEvent<HTMLLIElement>) => setDraggedId(id);
+  }
+
+  function handleDragOver(targetId: string) {
+    return (e: DragEvent<HTMLLIElement>) => {
+      e.preventDefault();
+      if (!draggedId || draggedId === targetId) return;
+
+      const current = localOrder ?? categories ?? [];
+      const fromIndex = current.findIndex((c) => c.id === draggedId);
+      const toIndex = current.findIndex((c) => c.id === targetId);
+      if (fromIndex === -1 || toIndex === -1) return;
+
+      const next = [...current];
+      const [moved] = next.splice(fromIndex, 1);
+      next.splice(toIndex, 0, moved);
+      setLocalOrder(next);
+    };
+  }
+
+  function handleDrop() {
+    return (e: DragEvent<HTMLLIElement>) => {
+      e.preventDefault();
+      setDraggedId(null);
+      const current = localOrder ?? categories ?? [];
+      reorderMutation.mutate(current.map((c, index) => ({ id: c.id, order: index })));
+    };
+  }
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Kategorien"
+        description="Per Drag & Drop sortieren. Favoriten erscheinen in der Suche trotzdem immer zuerst."
+      />
+
+      <form onSubmit={handleSubmit} className="mb-6 flex items-end gap-2">
+        <div>
+          <label className="mb-1 block text-xs font-medium text-black/50 dark:text-white/50">
+            Neue Kategorie
+          </label>
+          <input
+            value={newName}
+            onChange={(e) => setNewName(e.target.value)}
+            placeholder="z. B. Medien"
+            className="rounded-lg border border-black/10 bg-white px-3 py-1.5 text-sm
+              text-black outline-none focus:border-black/30 dark:border-white/10
+              dark:bg-white/5 dark:text-white dark:focus:border-white/30"
+          />
+        </div>
+        <Button type="submit" variant="primary" disabled={createMutation.isPending}>
+          Anlegen
+        </Button>
+        {createMutation.isError ? (
+          <span className="text-xs text-red-500">{(createMutation.error as Error).message}</span>
+        ) : null}
+      </form>
+
+      {isLoading ? (
+        <p className="text-sm text-black/40 dark:text-white/40">Lade Kategorien …</p>
+      ) : isError ? (
+        <p className="text-sm text-red-500">Kategorien konnten nicht geladen werden.</p>
+      ) : list.length > 0 ? (
+        <ul className="overflow-hidden rounded-2xl border border-black/10 dark:border-white/10">
+          {list.map((category) => (
+            <CategoryRow
+              key={category.id}
+              category={category}
+              isDragging={draggedId === category.id}
+              onDragStart={handleDragStart(category.id)}
+              onDragOver={handleDragOver(category.id)}
+              onDrop={handleDrop()}
+            />
+          ))}
+        </ul>
+      ) : (
+        <p className="text-sm text-black/40 dark:text-white/40">Noch keine Kategorien angelegt.</p>
+      )}
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/DashboardPage.tsx
+++ b/apps/frontend/src/routes/admin/DashboardPage.tsx
@@ -0,0 +1,84 @@
+import { useServices } from "../../hooks/useServices.js";
+import { useDevices } from "../../hooks/useDevices.js";
+import { useCategories } from "../../hooks/useCategories.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+function StatCard({ label, value }: { label: string; value: number | string }) {
+  return (
+    <div className="rounded-2xl border border-black/10 bg-white p-5 dark:border-white/10 dark:bg-white/5">
+      <div className="text-3xl font-semibold text-black dark:text-white">{value}</div>
+      <div className="mt-1 text-sm text-black/50 dark:text-white/50">{label}</div>
+    </div>
+  );
+}
+
+export function DashboardPage() {
+  const { data: services } = useServices();
+  const { data: devices } = useDevices();
+  const { data: categories } = useCategories();
+
+  const onlineDevices = devices?.filter((d) => d.online).length ?? 0;
+  const favoriteServices = services?.filter((s) => s.favorite).length ?? 0;
+
+  const recentlyScanned = [...(devices ?? [])]
+    .filter((d) => d.lastScan)
+    .sort((a, b) => (b.lastScan ?? "").localeCompare(a.lastScan ?? ""))
+    .slice(0, 5);
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Dashboard"
+        description="Überblick über dein Homelab."
+      />
+
+      <div className="grid grid-cols-2 gap-4 sm:grid-cols-4">
+        <StatCard label="Geräte" value={devices?.length ?? 0} />
+        <StatCard label="davon online" value={onlineDevices} />
+        <StatCard label="Dienste" value={services?.length ?? 0} />
+        <StatCard label="Favoriten" value={favoriteServices} />
+      </div>
+
+      <div className="mt-8">
+        <h2 className="mb-3 text-sm font-semibold text-black/60 dark:text-white/60">
+          Zuletzt gescannte Geräte
+        </h2>
+        {recentlyScanned.length === 0 ? (
+          <p className="text-sm text-black/40 dark:text-white/40">
+            Noch keine Scans durchgeführt. Starte einen Scan unter „Geräte“ oder „Scanner“.
+          </p>
+        ) : (
+          <div className="overflow-hidden rounded-2xl border border-black/10 dark:border-white/10">
+            <table className="w-full text-sm">
+              <tbody>
+                {recentlyScanned.map((device) => (
+                  <tr
+                    key={device.id}
+                    className="border-b border-black/5 last:border-0 dark:border-white/5"
+                  >
+                    <td className="px-4 py-3 font-medium text-black dark:text-white">
+                      {device.hostname}
+                    </td>
+                    <td className="px-4 py-3 text-black/40 dark:text-white/40">{device.ip}</td>
+                    <td className="px-4 py-3 text-black/40 dark:text-white/40">
+                      {device.lastScan ? new Date(device.lastScan).toLocaleString("de-DE") : "–"}
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        )}
+      </div>
+
+      <div className="mt-8">
+        <h2 className="mb-3 text-sm font-semibold text-black/60 dark:text-white/60">
+          Kategorien
+        </h2>
+        <p className="text-sm text-black/40 dark:text-white/40">
+          {categories?.length ?? 0} Kategorie(n) angelegt.
+        </p>
+      </div>
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/DevicesPage.tsx
+++ b/apps/frontend/src/routes/admin/DevicesPage.tsx
@@ -0,0 +1,220 @@
+import { useState, type FormEvent } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Button } from "@launchpad/ui";
+import { useDevices, type DeviceWithServices } from "../../hooks/useDevices.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+async function createDevice(input: { hostname: string; ip: string }) {
+  const res = await fetch("/api/devices", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(input),
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `Gerät konnte nicht angelegt werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+async function deleteDevice(id: string) {
+  const res = await fetch(`/api/devices/${id}`, { method: "DELETE" });
+  if (!res.ok && res.status !== 404) {
+    throw new Error(`Gerät konnte nicht gelöscht werden (HTTP ${res.status})`);
+  }
+}
+
+interface ScanResult {
+  scannedPorts: number;
+  created: number;
+  updated: number;
+}
+
+async function scanDevice(id: string): Promise<ScanResult> {
+  const res = await fetch(`/api/scan/devices/${id}`, { method: "POST" });
+  const body = await res.json();
+  if (!res.ok) {
+    throw new Error(body.detail ?? body.error ?? `Scan fehlgeschlagen (HTTP ${res.status})`);
+  }
+  return body;
+}
+
+function DeviceRow({ device }: { device: DeviceWithServices }) {
+  const queryClient = useQueryClient();
+  const [scanMessage, setScanMessage] = useState<string | null>(null);
+
+  const scanMutation = useMutation({
+    mutationFn: () => scanDevice(device.id),
+    onSuccess: (result) => {
+      setScanMessage(
+        `${result.scannedPorts} Port(s) offen · ${result.created} neu · ${result.updated} aktualisiert`
+      );
+      queryClient.invalidateQueries({ queryKey: ["devices"] });
+      queryClient.invalidateQueries({ queryKey: ["services"] });
+    },
+    onError: (err: Error) => setScanMessage(err.message),
+  });
+
+  const deleteMutation = useMutation({
+    mutationFn: () => deleteDevice(device.id),
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: ["devices"] }),
+  });
+
+  return (
+    <tr className="border-b border-black/5 last:border-0 dark:border-white/5">
+      <td className="px-4 py-3">
+        <div className="font-medium text-black dark:text-white">{device.hostname}</div>
+        <div className="text-xs text-black/40 dark:text-white/40">{device.ip}</div>
+      </td>
+      <td className="px-4 py-3">
+        <span
+          className={`inline-flex items-center gap-1.5 text-xs ${
+            device.online ? "text-emerald-600 dark:text-emerald-400" : "text-black/40 dark:text-white/40"
+          }`}
+        >
+          <span
+            className={`h-1.5 w-1.5 rounded-full ${device.online ? "bg-emerald-500" : "bg-black/20 dark:bg-white/20"}`}
+          />
+          {device.online ? "Online" : "Offline"}
+        </span>
+      </td>
+      <td className="px-4 py-3 text-black/60 dark:text-white/60">{device.services.length}</td>
+      <td className="px-4 py-3 text-xs text-black/40 dark:text-white/40">
+        {device.lastScan ? new Date(device.lastScan).toLocaleString("de-DE") : "nie gescannt"}
+      </td>
+      <td className="px-4 py-3">
+        <div className="flex items-center justify-end gap-2">
+          {scanMessage ? (
+            <span className="max-w-[16rem] truncate text-xs text-black/40 dark:text-white/40" title={scanMessage}>
+              {scanMessage}
+            </span>
+          ) : null}
+          <Button
+            size="sm"
+            onClick={() => {
+              setScanMessage(null);
+              scanMutation.mutate();
+            }}
+            disabled={scanMutation.isPending}
+          >
+            {scanMutation.isPending ? "Scanne …" : "Jetzt scannen"}
+          </Button>
+          <Button
+            size="sm"
+            variant="danger"
+            onClick={() => deleteMutation.mutate()}
+            disabled={deleteMutation.isPending}
+          >
+            Löschen
+          </Button>
+        </div>
+      </td>
+    </tr>
+  );
+}
+
+function AddDeviceForm() {
+  const queryClient = useQueryClient();
+  const [hostname, setHostname] = useState("");
+  const [ip, setIp] = useState("");
+
+  const mutation = useMutation({
+    mutationFn: createDevice,
+    onSuccess: () => {
+      setHostname("");
+      setIp("");
+      queryClient.invalidateQueries({ queryKey: ["devices"] });
+    },
+  });
+
+  function handleSubmit(e: FormEvent) {
+    e.preventDefault();
+    if (!hostname.trim() || !ip.trim()) return;
+    mutation.mutate({ hostname: hostname.trim(), ip: ip.trim() });
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="flex items-end gap-2">
+      <div>
+        <label className="mb-1 block text-xs font-medium text-black/50 dark:text-white/50">
+          Hostname
+        </label>
+        <input
+          value={hostname}
+          onChange={(e) => setHostname(e.target.value)}
+          placeholder="z. B. synology"
+          className="rounded-lg border border-black/10 bg-white px-3 py-1.5 text-sm
+            text-black outline-none focus:border-black/30 dark:border-white/10
+            dark:bg-white/5 dark:text-white dark:focus:border-white/30"
+        />
+      </div>
+      <div>
+        <label className="mb-1 block text-xs font-medium text-black/50 dark:text-white/50">
+          IP-Adresse
+        </label>
+        <input
+          value={ip}
+          onChange={(e) => setIp(e.target.value)}
+          placeholder="192.168.1.10"
+          className="rounded-lg border border-black/10 bg-white px-3 py-1.5 text-sm
+            text-black outline-none focus:border-black/30 dark:border-white/10
+            dark:bg-white/5 dark:text-white dark:focus:border-white/30"
+        />
+      </div>
+      <Button type="submit" variant="primary" disabled={mutation.isPending}>
+        Gerät hinzufügen
+      </Button>
+      {mutation.isError ? (
+        <span className="text-xs text-red-500">{(mutation.error as Error).message}</span>
+      ) : null}
+    </form>
+  );
+}
+
+export function DevicesPage() {
+  const { data: devices, isLoading, isError } = useDevices();
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Geräte"
+        description="Alle bekannten Geräte in deinem Netzwerk. Scans laufen nur auf Knopfdruck."
+      />
+
+      <div className="mb-6">
+        <AddDeviceForm />
+      </div>
+
+      {isLoading ? (
+        <p className="text-sm text-black/40 dark:text-white/40">Lade Geräte …</p>
+      ) : isError ? (
+        <p className="text-sm text-red-500">Geräte konnten nicht geladen werden.</p>
+      ) : devices && devices.length > 0 ? (
+        <div className="overflow-hidden rounded-2xl border border-black/10 dark:border-white/10">
+          <table className="w-full text-sm">
+            <thead>
+              <tr className="border-b border-black/10 bg-black/[0.02] text-left text-xs
+                uppercase tracking-wide text-black/40 dark:border-white/10 dark:bg-white/5 dark:text-white/40">
+                <th className="px-4 py-2 font-medium">Gerät</th>
+                <th className="px-4 py-2 font-medium">Status</th>
+                <th className="px-4 py-2 font-medium">Dienste</th>
+                <th className="px-4 py-2 font-medium">Letzter Scan</th>
+                <th className="px-4 py-2" />
+              </tr>
+            </thead>
+            <tbody>
+              {devices.map((device) => (
+                <DeviceRow key={device.id} device={device} />
+              ))}
+            </tbody>
+          </table>
+        </div>
+      ) : (
+        <p className="text-sm text-black/40 dark:text-white/40">
+          Noch keine Geräte angelegt. Füge oben ein Gerät hinzu oder nutze den FritzBox-Scan
+          unter „Scanner“.
+        </p>
+      )}
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/LogsPage.tsx
+++ b/apps/frontend/src/routes/admin/LogsPage.tsx
@@ -0,0 +1,59 @@
+import { useLogs } from "../../hooks/useLogs.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+export function LogsPage() {
+  const { data: logs, isLoading, isError } = useLogs();
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Logs"
+        description="Protokoll aller Scan-Versuche (Geräte-Scan und FritzBox-Scan)."
+      />
+
+      {isLoading ? (
+        <p className="text-sm text-black/40 dark:text-white/40">Lade Logs …</p>
+      ) : isError ? (
+        <p className="text-sm text-red-500">Logs konnten nicht geladen werden.</p>
+      ) : logs && logs.length > 0 ? (
+        <div className="overflow-hidden rounded-2xl border border-black/10 dark:border-white/10">
+          <table className="w-full text-sm">
+            <thead>
+              <tr className="border-b border-black/10 bg-black/[0.02] text-left text-xs
+                uppercase tracking-wide text-black/40 dark:border-white/10 dark:bg-white/5 dark:text-white/40">
+                <th className="px-4 py-2 font-medium">Zeit</th>
+                <th className="px-4 py-2 font-medium">Typ</th>
+                <th className="px-4 py-2 font-medium">Nachricht</th>
+              </tr>
+            </thead>
+            <tbody>
+              {logs.map((log) => (
+                <tr key={log.id} className="border-b border-black/5 last:border-0 dark:border-white/5">
+                  <td className="whitespace-nowrap px-4 py-3 text-xs text-black/40 dark:text-white/40">
+                    {new Date(log.createdAt).toLocaleString("de-DE")}
+                  </td>
+                  <td className="px-4 py-3">
+                    <span
+                      className={`inline-flex items-center gap-1.5 rounded-full px-2 py-0.5 text-xs font-medium ${
+                        log.level === "error"
+                          ? "bg-red-500/10 text-red-600 dark:text-red-400"
+                          : "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400"
+                      }`}
+                    >
+                      {log.type === "fritzbox" ? "FritzBox" : "Gerät"}
+                    </span>
+                  </td>
+                  <td className="px-4 py-3 text-black/70 dark:text-white/70">{log.message}</td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      ) : (
+        <p className="text-sm text-black/40 dark:text-white/40">
+          Noch keine Scans durchgeführt. Starte einen Scan unter „Geräte" oder „Scanner".
+        </p>
+      )}
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/PluginsPage.tsx
+++ b/apps/frontend/src/routes/admin/PluginsPage.tsx
@@ -0,0 +1,18 @@
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+export function PluginsPage() {
+  return (
+    <div>
+      <AdminPageHeader title="Plugins" />
+      <div className="rounded-2xl border border-dashed border-black/15 p-8 text-center dark:border-white/15">
+        <p className="text-black/60 dark:text-white/60">
+          Das Plugin-System (Scanner registrieren, Geräte importieren, Menüs erweitern,
+          Icons bereitstellen) ist noch nicht gebaut.
+        </p>
+        <p className="mt-2 text-sm text-black/40 dark:text-white/40">
+          Geplant als eigener Commit – siehe <code className="rounded bg-black/5 px-1 dark:bg-white/10">docs/ROADMAP.md</code>.
+        </p>
+      </div>
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/ScannerPage.tsx
+++ b/apps/frontend/src/routes/admin/ScannerPage.tsx
@@ -0,0 +1,121 @@
+import { useState } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Button } from "@launchpad/ui";
+import { useDevices } from "../../hooks/useDevices.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+async function scanFritzBox() {
+  const res = await fetch("/api/scan/fritzbox", { method: "POST" });
+  const body = await res.json();
+  if (!res.ok) {
+    throw new Error(body.error ?? `FritzBox-Scan fehlgeschlagen (HTTP ${res.status})`);
+  }
+  return body as { found: number };
+}
+
+async function scanDeviceById(id: string) {
+  const res = await fetch(`/api/scan/devices/${id}`, { method: "POST" });
+  const body = await res.json();
+  if (!res.ok) {
+    throw new Error(body.detail ?? body.error ?? `Scan fehlgeschlagen (HTTP ${res.status})`);
+  }
+  return body as { created: number; updated: number };
+}
+
+export function ScannerPage() {
+  const queryClient = useQueryClient();
+  const { data: devices } = useDevices();
+  const [bulkStatus, setBulkStatus] = useState<string | null>(null);
+  const [bulkRunning, setBulkRunning] = useState(false);
+
+  const fritzboxMutation = useMutation({
+    mutationFn: scanFritzBox,
+    onSuccess: (result) => {
+      queryClient.invalidateQueries({ queryKey: ["devices"] });
+      queryClient.invalidateQueries({ queryKey: ["logs"] });
+      return result;
+    },
+  });
+
+  async function scanAllDevices() {
+    if (!devices || devices.length === 0) return;
+    setBulkRunning(true);
+    let created = 0;
+    let updated = 0;
+
+    for (const device of devices) {
+      try {
+        const result = await scanDeviceById(device.id);
+        created += result.created;
+        updated += result.updated;
+        setBulkStatus(`Scanne ${device.hostname} … (${created} neu, ${updated} aktualisiert bisher)`);
+      } catch {
+        // einzelnes fehlgeschlagenes Gerät soll den Rest nicht abbrechen
+      }
+    }
+
+    setBulkStatus(`Fertig: ${devices.length} Gerät(e) gescannt, ${created} neue Dienste, ${updated} aktualisiert.`);
+    setBulkRunning(false);
+    queryClient.invalidateQueries({ queryKey: ["devices"] });
+    queryClient.invalidateQueries({ queryKey: ["services"] });
+    queryClient.invalidateQueries({ queryKey: ["logs"] });
+  }
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Scanner"
+        description="Scans laufen ausschließlich manuell – nie automatisch oder zeitgesteuert."
+      />
+
+      <div className="grid gap-4 sm:grid-cols-2">
+        <div className="rounded-2xl border border-black/10 p-5 dark:border-white/10">
+          <h2 className="font-medium text-black dark:text-white">FritzBox-Scan</h2>
+          <p className="mt-1 text-sm text-black/50 dark:text-white/50">
+            Liest die Geräteliste der FritzBox per TR-064 und legt/aktualisiert Geräte.
+            Erfordert <code className="rounded bg-black/5 px-1 dark:bg-white/10">FRITZBOX_HOST</code>,{" "}
+            <code className="rounded bg-black/5 px-1 dark:bg-white/10">FRITZBOX_USERNAME</code> und{" "}
+            <code className="rounded bg-black/5 px-1 dark:bg-white/10">FRITZBOX_PASSWORD</code> in
+            der <code className="rounded bg-black/5 px-1 dark:bg-white/10">.env</code>.
+          </p>
+          <Button
+            variant="primary"
+            className="mt-4"
+            onClick={() => fritzboxMutation.mutate()}
+            disabled={fritzboxMutation.isPending}
+          >
+            {fritzboxMutation.isPending ? "Scanne …" : "FritzBox jetzt scannen"}
+          </Button>
+          {fritzboxMutation.isSuccess ? (
+            <p className="mt-2 text-sm text-emerald-600 dark:text-emerald-400">
+              {fritzboxMutation.data.found} Gerät(e) gefunden.
+            </p>
+          ) : null}
+          {fritzboxMutation.isError ? (
+            <p className="mt-2 text-sm text-red-500">{(fritzboxMutation.error as Error).message}</p>
+          ) : null}
+        </div>
+
+        <div className="rounded-2xl border border-black/10 p-5 dark:border-white/10">
+          <h2 className="font-medium text-black dark:text-white">Alle Geräte scannen</h2>
+          <p className="mt-1 text-sm text-black/50 dark:text-white/50">
+            Führt den Netzwerk-Scan (DNS, Ports, Titel/Favicon, Softwareerkennung) nacheinander
+            für alle {devices?.length ?? 0} bekannten Geräte aus. Für ein einzelnes Gerät lieber
+            den Button in der Geräte-Tabelle nutzen.
+          </p>
+          <Button
+            variant="primary"
+            className="mt-4"
+            onClick={scanAllDevices}
+            disabled={bulkRunning || !devices || devices.length === 0}
+          >
+            {bulkRunning ? "Scanne …" : "Alle Geräte jetzt scannen"}
+          </Button>
+          {bulkStatus ? (
+            <p className="mt-2 text-sm text-black/50 dark:text-white/50">{bulkStatus}</p>
+          ) : null}
+        </div>
+      </div>
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/ServicesPage.tsx
+++ b/apps/frontend/src/routes/admin/ServicesPage.tsx
@@ -0,0 +1,218 @@
+import { useState } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Button } from "@launchpad/ui";
+import type { Service } from "@launchpad/shared";
+import { useServices } from "../../hooks/useServices.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+interface ServicePatch {
+  displayName?: string;
+  category?: string | null;
+  alias?: string[];
+  order?: number;
+  favorite?: boolean;
+}
+
+async function patchService(id: string, patch: ServicePatch): Promise<Service> {
+  const res = await fetch(`/api/services/${id}`, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(patch),
+  });
+  if (!res.ok) {
+    throw new Error(`Dienst konnte nicht aktualisiert werden (HTTP ${res.status})`);
+  }
+  return res.json();
+}
+
+async function deleteServiceRequest(id: string) {
+  const res = await fetch(`/api/services/${id}`, { method: "DELETE" });
+  if (!res.ok && res.status !== 404) {
+    throw new Error(`Dienst konnte nicht gelöscht werden (HTTP ${res.status})`);
+  }
+}
+
+function EditForm({ service, onDone }: { service: Service; onDone: () => void }) {
+  const queryClient = useQueryClient();
+  const [displayName, setDisplayName] = useState(service.displayName);
+  const [category, setCategory] = useState(service.category ?? "");
+  const [alias, setAlias] = useState(service.alias.join(", "));
+  const [order, setOrder] = useState(String(service.order));
+
+  const mutation = useMutation({
+    mutationFn: () =>
+      patchService(service.id, {
+        displayName: displayName.trim(),
+        category: category.trim() || null,
+        alias: alias
+          .split(",")
+          .map((a) => a.trim())
+          .filter(Boolean),
+        order: Number(order) || 0,
+      }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["services"] });
+      onDone();
+    },
+  });
+
+  return (
+    <tr className="border-b border-black/5 bg-black/[0.02] last:border-0 dark:border-white/5 dark:bg-white/5">
+      <td colSpan={6} className="px-4 py-3">
+        <div className="flex flex-wrap items-end gap-3">
+          <div>
+            <label className="mb-1 block text-xs text-black/50 dark:text-white/50">Name</label>
+            <input
+              value={displayName}
+              onChange={(e) => setDisplayName(e.target.value)}
+              className="rounded-lg border border-black/10 bg-white px-2 py-1 text-sm
+                dark:border-white/10 dark:bg-white/10 dark:text-white"
+            />
+          </div>
+          <div>
+            <label className="mb-1 block text-xs text-black/50 dark:text-white/50">Kategorie</label>
+            <input
+              value={category}
+              onChange={(e) => setCategory(e.target.value)}
+              className="rounded-lg border border-black/10 bg-white px-2 py-1 text-sm
+                dark:border-white/10 dark:bg-white/10 dark:text-white"
+            />
+          </div>
+          <div>
+            <label className="mb-1 block text-xs text-black/50 dark:text-white/50">
+              Alias (kommagetrennt)
+            </label>
+            <input
+              value={alias}
+              onChange={(e) => setAlias(e.target.value)}
+              className="w-48 rounded-lg border border-black/10 bg-white px-2 py-1 text-sm
+                dark:border-white/10 dark:bg-white/10 dark:text-white"
+            />
+          </div>
+          <div>
+            <label className="mb-1 block text-xs text-black/50 dark:text-white/50">Reihenfolge</label>
+            <input
+              value={order}
+              onChange={(e) => setOrder(e.target.value)}
+              type="number"
+              className="w-20 rounded-lg border border-black/10 bg-white px-2 py-1 text-sm
+                dark:border-white/10 dark:bg-white/10 dark:text-white"
+            />
+          </div>
+          <Button size="sm" variant="primary" onClick={() => mutation.mutate()} disabled={mutation.isPending}>
+            Speichern
+          </Button>
+          <Button size="sm" variant="ghost" onClick={onDone}>
+            Abbrechen
+          </Button>
+        </div>
+      </td>
+    </tr>
+  );
+}
+
+function ServiceRow({ service }: { service: Service }) {
+  const queryClient = useQueryClient();
+  const [editing, setEditing] = useState(false);
+
+  const favoriteMutation = useMutation({
+    mutationFn: () => patchService(service.id, { favorite: !service.favorite }),
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: ["services"] }),
+  });
+
+  const deleteMutation = useMutation({
+    mutationFn: () => deleteServiceRequest(service.id),
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: ["services"] }),
+  });
+
+  if (editing) {
+    return <EditForm service={service} onDone={() => setEditing(false)} />;
+  }
+
+  return (
+    <tr className="border-b border-black/5 last:border-0 dark:border-white/5">
+      <td className="px-4 py-3">
+        <button
+          onClick={() => favoriteMutation.mutate()}
+          aria-label={service.favorite ? "Favorit entfernen" : "Als Favorit markieren"}
+          className={`text-lg ${service.favorite ? "text-amber-500" : "text-black/15 hover:text-amber-400 dark:text-white/15"}`}
+        >
+          ★
+        </button>
+      </td>
+      <td className="px-4 py-3">
+        <div className="font-medium text-black dark:text-white">{service.displayName}</div>
+        <div className="text-xs text-black/40 dark:text-white/40">{service.hostname}</div>
+      </td>
+      <td className="px-4 py-3 text-black/60 dark:text-white/60">{service.category ?? "–"}</td>
+      <td className="px-4 py-3 text-black/60 dark:text-white/60">
+        {service.alias.length > 0 ? service.alias.join(", ") : "–"}
+      </td>
+      <td className="px-4 py-3">
+        <a
+          href={service.url}
+          target="_blank"
+          rel="noopener noreferrer"
+          className="text-black/60 underline decoration-black/20 hover:text-black dark:text-white/60 dark:decoration-white/20 dark:hover:text-white"
+        >
+          öffnen
+        </a>
+      </td>
+      <td className="px-4 py-3">
+        <div className="flex items-center justify-end gap-2">
+          <Button size="sm" onClick={() => setEditing(true)}>
+            Bearbeiten
+          </Button>
+          <Button size="sm" variant="danger" onClick={() => deleteMutation.mutate()} disabled={deleteMutation.isPending}>
+            Löschen
+          </Button>
+        </div>
+      </td>
+    </tr>
+  );
+}
+
+export function ServicesPage() {
+  const { data: services, isLoading, isError } = useServices();
+
+  return (
+    <div>
+      <AdminPageHeader
+        title="Dienste"
+        description="Name, Kategorie, Alias und Reihenfolge bleiben bei erneuten Scans erhalten."
+      />
+
+      {isLoading ? (
+        <p className="text-sm text-black/40 dark:text-white/40">Lade Dienste …</p>
+      ) : isError ? (
+        <p className="text-sm text-red-500">Dienste konnten nicht geladen werden.</p>
+      ) : services && services.length > 0 ? (
+        <div className="overflow-hidden rounded-2xl border border-black/10 dark:border-white/10">
+          <table className="w-full text-sm">
+            <thead>
+              <tr className="border-b border-black/10 bg-black/[0.02] text-left text-xs
+                uppercase tracking-wide text-black/40 dark:border-white/10 dark:bg-white/5 dark:text-white/40">
+                <th className="px-4 py-2 font-medium" />
+                <th className="px-4 py-2 font-medium">Dienst</th>
+                <th className="px-4 py-2 font-medium">Kategorie</th>
+                <th className="px-4 py-2 font-medium">Alias</th>
+                <th className="px-4 py-2 font-medium">URL</th>
+                <th className="px-4 py-2" />
+              </tr>
+            </thead>
+            <tbody>
+              {services.map((service) => (
+                <ServiceRow key={service.id} service={service} />
+              ))}
+            </tbody>
+          </table>
+        </div>
+      ) : (
+        <p className="text-sm text-black/40 dark:text-white/40">
+          Noch keine Dienste vorhanden. Scanne ein Gerät unter „Geräte“, um automatisch welche
+          zu finden.
+        </p>
+      )}
+    </div>
+  );
+}
--- a/apps/frontend/src/routes/admin/SettingsPage.tsx
+++ b/apps/frontend/src/routes/admin/SettingsPage.tsx
@@ -0,0 +1,55 @@
+import { useBackendHealth } from "../../hooks/useBackendHealth.js";
+import { useTheme } from "../../hooks/useTheme.js";
+import { AdminPageHeader } from "./AdminPageHeader.js";
+
+function InfoRow({ label, value }: { label: string; value: string }) {
+  return (
+    <div className="flex items-center justify-between border-b border-black/5 py-3 last:border-0 dark:border-white/5">
+      <span className="text-sm text-black/50 dark:text-white/50">{label}</span>
+      <span className="text-sm font-medium text-black dark:text-white">{value}</span>
+    </div>
+  );
+}
+
+export function SettingsPage() {
+  const { health, error } = useBackendHealth();
+  const [theme, toggleTheme] = useTheme();
+
+  return (
+    <div>
+      <AdminPageHeader title="Einstellungen" />
+
+      <div className="max-w-lg space-y-6">
+        <div className="rounded-2xl border border-black/10 p-5 dark:border-white/10">
+          <h2 className="mb-2 font-medium text-black dark:text-white">Darstellung</h2>
+          <div className="flex items-center justify-between py-2">
+            <span className="text-sm text-black/50 dark:text-white/50">Theme</span>
+            <button
+              onClick={toggleTheme}
+              className="rounded-lg border border-black/10 px-3 py-1.5 text-sm text-black
+                transition-colors hover:bg-black/5 dark:border-white/10 dark:text-white
+                dark:hover:bg-white/10"
+            >
+              {theme === "dark" ? "🌙 Dunkel" : "☀️ Hell"} – wechseln
+            </button>
+          </div>
+        </div>
+
+        <div className="rounded-2xl border border-black/10 p-5 dark:border-white/10">
+          <h2 className="mb-2 font-medium text-black dark:text-white">Backend</h2>
+          {error ? (
+            <p className="text-sm text-red-500">Backend nicht erreichbar.</p>
+          ) : health ? (
+            <div>
+              <InfoRow label="Status" value={health.status} />
+              <InfoRow label="Version" value={health.version} />
+              <InfoRow label="Läuft seit" value={`${health.uptimeSeconds}s`} />
+            </div>
+          ) : (
+            <p className="text-sm text-black/40 dark:text-white/40">Lade …</p>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -50,10 +50,27 @@ Grundgerüst aus Commit 1.
 > FritzBox-SOAP-/Digest-Auth-Ablauf inkl. Fehlerfall bei falschem Passwort).
 > Ein Test gegen eine echte FritzBox war in dieser Umgebung nicht möglich.

-## Commit 6 — Adminbereich
+## ✅ Commit 6 — Adminbereich (erledigt)

- Menüpunkte: Dashboard, Geräte, Dienste, Scanner, Kategorien, Plugins,
-  Einstellungen, Logs
+- TanStack Router (code-basiert): `/` (Startseite) + `/admin/*`
+- Menüpunkte wie spezifiziert: Dashboard, Geräte, Dienste, Scanner, Kategorien,
+  Plugins, Einstellungen, Logs
+- Geräte-Seite: anlegen, löschen, **„Jetzt scannen"-Button** pro Gerät
+- Dienste-Seite: Inline-Bearbeitung von Name/Kategorie/Alias/Reihenfolge, Favoriten-Toggle
+- Kategorien-Seite: anlegen, umbenennen, löschen, **natives Drag & Drop** (kein
+  zusätzliches Package nötig)
+- Scanner-Seite: FritzBox-Trigger + Sammel-Scan aller Geräte
+- Logs-Seite: Scan-Historie (neue `scan_logs`-Tabelle, jeder Scan-Versuch wird protokolliert)
+- Einstellungen: Live-Backend-Status + Theme-Umschalter
+- Plugins: ehrlicher Hinweis, dass das Plugin-System noch nicht existiert
+  (statt einer vorgetäuschten Funktion)
+
+> Verifiziert per Docker-Build-Simulation (Frontend + Backend inkl.
+> `pnpm deploy --prod`) und Backend-Smoke-Test aller von den Admin-Seiten
+> verwendeten Endpunkte. Die UI selbst konnte in dieser Umgebung nicht in
+> einem echten Browser durchgeklickt werden (kein Browser-Tool verfügbar) –
+> Verifikation stützt sich auf erfolgreichen TypeScript-/Vite-Build und
+> Codeprüfung.

 ## Commit 7 — PWA

--- a/packages/shared/src/index.ts
+++ b/packages/shared/src/index.ts
@@ -52,6 +52,15 @@ export interface Category {
  order: number;
 }

+export interface ScanLogEntry {
+  id: string;
+  type: "device" | "fritzbox";
+  targetId: string | null;
+  level: "info" | "error";
+  message: string;
+  createdAt: string;
+}
+
 /**
 * Ranking-Stufen für die Suche, gemäß Spezifikation:
 * 1. Displayname beginnt mit Suchtext
--- a/packages/ui/src/Button.tsx
+++ b/packages/ui/src/Button.tsx
@@ -0,0 +1,38 @@
+import { forwardRef, type ButtonHTMLAttributes } from "react";
+
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "primary" | "secondary" | "danger" | "ghost";
+  size?: "sm" | "md";
+}
+
+const VARIANT_CLASSES: Record<NonNullable<ButtonProps["variant"]>, string> = {
+  primary:
+    "bg-black text-white hover:bg-black/80 dark:bg-white dark:text-black dark:hover:bg-white/80",
+  secondary:
+    "bg-black/5 text-black hover:bg-black/10 dark:bg-white/10 dark:text-white dark:hover:bg-white/20",
+  danger: "bg-red-500/10 text-red-600 hover:bg-red-500/20 dark:text-red-400",
+  ghost:
+    "bg-transparent text-black/60 hover:bg-black/5 dark:text-white/60 dark:hover:bg-white/10",
+};
+
+const SIZE_CLASSES: Record<NonNullable<ButtonProps["size"]>, string> = {
+  sm: "px-3 py-1.5 text-sm",
+  md: "px-4 py-2 text-sm",
+};
+
+export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ variant = "secondary", size = "md", className = "", disabled, ...props }, ref) => {
+    return (
+      <button
+        ref={ref}
+        disabled={disabled}
+        className={`inline-flex items-center justify-center gap-2 rounded-lg font-medium
+          transition-colors disabled:cursor-not-allowed disabled:opacity-50
+          ${VARIANT_CLASSES[variant]} ${SIZE_CLASSES[size]} ${className}`}
+        {...props}
+      />
+    );
+  }
+);
+
+Button.displayName = "Button";
--- a/packages/ui/src/index.ts
+++ b/packages/ui/src/index.ts
@@ -6,3 +6,6 @@ export type { StatusBadgeProps } from "./StatusBadge.js";

 export { ResultsList } from "./ResultsList.js";
 export type { ResultsListProps } from "./ResultsList.js";
+
+export { Button } from "./Button.js";
+export type { ButtonProps } from "./Button.js";
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -63,6 +63,9 @@ importers:
      '@tanstack/react-query':
        specifier: ^5.51.23
        version: 5.101.2(react@18.3.1)
+      '@tanstack/react-router':
+        specifier: ^1.58.3
+        version: 1.170.18(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
      react:
        specifier: ^18.3.1
        version: 18.3.1
@@ -959,6 +962,10 @@ packages:
    cpu: [x64]
    os: [win32]

+  '@tanstack/history@1.162.0':
+    resolution: {integrity: sha512-79pf/RkhteYZTRgcR4F9kbk84P2N8rugQJswxfIqovlbRiT3yI7eBE+5QorIrZaOKktsgzRlXh1l/du/xpl4iA==}
+    engines: {node: '>=20.19'}
+
  '@tanstack/query-core@5.101.2':
    resolution: {integrity: sha512-hH5MLoJhF7KaIGd7q3xTXGXvslI+GYlM1Z/35aSHHWaCJWB7XvTSHYuV3eM7tw+aE0mT/xMro4M4Q9rCGHT0lw==}

@@ -967,6 +974,26 @@ packages:
    peerDependencies:
      react: ^18 || ^19

+  '@tanstack/react-router@1.170.18':
+    resolution: {integrity: sha512-wpbGYZEp/fmz1q4bn7BD8VZ+/VZ7GBqSJv5V969pU+chP8y7dquWDmKTFMohvUegb9lg12m1uPVvD6kB2wORvQ==}
+    engines: {node: '>=20.19'}
+    peerDependencies:
+      react: '>=18.0.0 || >=19.0.0'
+      react-dom: '>=18.0.0 || >=19.0.0'
+
+  '@tanstack/react-store@0.9.3':
+    resolution: {integrity: sha512-y2iHd/N9OkoQbFJLUX1T9vbc2O9tjH0pQRgTcx1/Nz4IlwLvkgpuglXUx+mXt0g5ZDFrEeDnONPqkbfxXJKwRg==}
+    peerDependencies:
+      react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+      react-dom: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
+  '@tanstack/router-core@1.171.15':
+    resolution: {integrity: sha512-IILCDcLaItMZQ2jEmCABHY1Nhjjn5XUvwpQp3e4Nmu+vfg0BgYFuu/QASz2SwE2ZNbVMrvt8X/wxa+Gg5aErxA==}
+    engines: {node: '>=20.19'}
+
+  '@tanstack/store@0.9.3':
+    resolution: {integrity: sha512-8reSzl/qGWGGVKhBoxXPMWzATSbZLZFWhwBAFO9NAyp0TxzfBP0mIrGb8CP8KrQTmvzXlR/vFPPUrHTLBGyFyw==}
+
  '@types/babel__core@7.20.5':
    resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==}

@@ -1118,6 +1145,9 @@ packages:
  convert-source-map@2.0.0:
    resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}

+  cookie-es@3.1.1:
+    resolution: {integrity: sha512-UaXxwISYJPTr9hwQxMFYZ7kNhSXboMXP+Z3TRX6f1/NyaGPfuNUZOWP1pUEb75B2HjfklIYLVRfWiFZJyC6Npg==}
+
  cookie@0.7.2:
    resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==}
    engines: {node: '>= 0.6'}
@@ -1444,6 +1474,10 @@ packages:
    resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
    engines: {node: '>=0.12.0'}

+  isbot@5.2.1:
+    resolution: {integrity: sha512-dJ+LpKyClQZ7NG+j3OensC/mAZkGpukE9YUrgPYvAZj2doVL0edfDgywTUh5CXa0o+nW9a1V9e5+CJTX8+SxRw==}
+    engines: {node: '>=18'}
+
  jiti@1.21.7:
    resolution: {integrity: sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==}
    hasBin: true
@@ -1757,6 +1791,16 @@ packages:
    engines: {node: '>=10'}
    hasBin: true

+  seroval-plugins@1.5.5:
+    resolution: {integrity: sha512-+BDhqYM6CEn3x09v44dpa9p6974FuUB2dxk+Ctn04k0cO1Zt6QODTXfmEZK0eBaTe/fJBvP4NMGuNJ+R8T+QMg==}
+    engines: {node: '>=10'}
+    peerDependencies:
+      seroval: ^1.0
+
+  seroval@1.5.5:
+    resolution: {integrity: sha512-bSjOuPcwPKLSJNhr9+bZxA20nQxVle5J5MNsYRVE6cIg7KpRLXGupymePavu0jrxlPiPsr4xGZSB8yUY2sH2sw==}
+    engines: {node: '>=10'}
+
  set-cookie-parser@2.7.2:
    resolution: {integrity: sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==}

@@ -1863,6 +1907,11 @@ packages:
    peerDependencies:
      browserslist: '>= 4.21.0'

+  use-sync-external-store@1.6.0:
+    resolution: {integrity: sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==}
+    peerDependencies:
+      react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
  util-deprecate@1.0.2:
    resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}

@@ -2447,6 +2496,8 @@ snapshots:
  '@rollup/rollup-win32-x64-msvc@4.62.2':
    optional: true

+  '@tanstack/history@1.162.0': {}
+
  '@tanstack/query-core@5.101.2': {}

  '@tanstack/react-query@5.101.2(react@18.3.1)':
@@ -2454,6 +2505,31 @@ snapshots:
      '@tanstack/query-core': 5.101.2
      react: 18.3.1

+  '@tanstack/react-router@1.170.18(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@tanstack/history': 1.162.0
+      '@tanstack/react-store': 0.9.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@tanstack/router-core': 1.171.15
+      isbot: 5.2.1
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@tanstack/react-store@0.9.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@tanstack/store': 0.9.3
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
+
+  '@tanstack/router-core@1.171.15':
+    dependencies:
+      '@tanstack/history': 1.162.0
+      cookie-es: 3.1.1
+      seroval: 1.5.5
+      seroval-plugins: 1.5.5(seroval@1.5.5)
+
+  '@tanstack/store@0.9.3': {}
+
  '@types/babel__core@7.20.5':
    dependencies:
      '@babel/parser': 7.29.7
@@ -2623,6 +2699,8 @@ snapshots:

  convert-source-map@2.0.0: {}

+  cookie-es@3.1.1: {}
+
  cookie@0.7.2: {}

  cssesc@3.0.0: {}
@@ -2928,6 +3006,8 @@ snapshots:

  is-number@7.0.0: {}

+  isbot@5.2.1: {}
+
  jiti@1.21.7: {}

  joycon@3.1.1: {}
@@ -3246,6 +3326,12 @@ snapshots:

  semver@7.8.5: {}

+  seroval-plugins@1.5.5(seroval@1.5.5):
+    dependencies:
+      seroval: 1.5.5
+
+  seroval@1.5.5: {}
+
  set-cookie-parser@2.7.2: {}

  simple-concat@1.0.1: {}
@@ -3379,6 +3465,10 @@ snapshots:
      escalade: 3.2.0
      picocolors: 1.1.1

+  use-sync-external-store@1.6.0(react@18.3.1):
+    dependencies:
+      react: 18.3.1
+
  util-deprecate@1.0.2: {}

  vite@5.4.21(@types/node@20.19.43):