constructorfabric · KvizadSaderah · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -365,6 +365,7 @@ tower-http = { version = "0.6", features = [
     "decompression-deflate",
     "follow-redirect",
     "catch-panic",
+    "fs",
 ] }
 uuid = { version = "1.23.3", features = ["serde"] }
 governor = "0.10"

diff --git a/Makefile b/Makefile
@@ -682,6 +682,14 @@ fuzz-corpus: fuzz-install
 
 # -------- Mini chat --------
 
+## Build the admin-panel SPA (apps/admin-panel/dist) so the server can serve it at /cf/admin
+admin-spa:
+	cd apps/admin-panel && npm install && npm run build
+
+## Run server with the integrated admin panel (config/admin.yaml, two-role dev auth stub); builds + serves the SPA at /cf/admin
+admin: admin-spa
+	cargo run --bin cf-gears-example-server --features account-management,static-authn,static-authz,static-idp,static-tenants,static-credstore,otel -- --config config/admin.yaml run
+
 # mini-chat targets are for running the mini-chat gear locally and in Kubernetes, with options for building Docker images and deploying with Helm.
 
 .PHONY: mini-chat mini-chat-docker mini-chat-helm mini-chat-helm-template mini-chat-up mini-chat-down mini-chat-port-forward
@@ -804,7 +812,7 @@ mini-chat-down:
 
 # -------- Main targets --------
 
-.PHONY: all check ci ci_test ci_docs build .cargo-build .split-debug quickstart example mini-chat mini-chat-docker mini-chat-helm mini-chat-helm-template mini-chat-up mini-chat-down mini-chat-port-forward
+.PHONY: all check ci ci_test ci_docs build .cargo-build .split-debug quickstart example admin admin-spa mini-chat mini-chat-docker mini-chat-helm mini-chat-helm-template mini-chat-up mini-chat-down mini-chat-port-forward
 
 # Start server with quickstart config
 quickstart:

diff --git a/README.md b/README.md
@@ -97,6 +97,23 @@ cargo run --bin cf-gears-example-server -- --config config/no-db.yaml run
 cargo run --bin cf-gears-example-server -- --config config/quickstart.yaml --mock run
 ```
 
+### Admin panel
+
+An optional Django-admin-style management console (`apps/admin-panel`, React + Refine) is
+available. It manages the platform through the Gears APIs only — with platform-admin and
+per-tenant modes — and is metadata-driven, so new resources are added by registering a
+descriptor. `make admin` builds the SPA and serves it from the example server:
+
+```bash
+make admin                       # builds the SPA, serves it at http://localhost:8087/cf/admin
+                                 #   (Gears APIs at /cf, non-prod dev tokens)
+# for frontend hot reload instead:
+cd apps/admin-panel && npm install && npm run dev
+```
+
+See the [Admin panel guide](docs/web-docs/build-with-gears/admin-panel.md) and the design set under
+[`docs/arch/admin-panel/`](docs/arch/admin-panel/) (PRD, DESIGN, ADRs).
+
 ### Example Configuration (config/quickstart.yaml)
 
 ```yaml

diff --git a/apps/admin-panel/.gitignore b/apps/admin-panel/.gitignore
@@ -0,0 +1,8 @@
+node_modules/
+dist/
+*.local
+.vite/
+*.tsbuildinfo
+test-results/
+playwright-report/
+playwright/.cache/
diff --git a/apps/admin-panel/index.html b/apps/admin-panel/index.html
@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <!-- Inline SVG favicon: avoids the browser's default /favicon.ico request,
+         which resolves to the origin root (outside /cf/admin) and 404s. -->
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='6' fill='%231677ff'/%3E%3Ctext x='16' y='23' font-size='20' text-anchor='middle' fill='white' font-family='sans-serif'%3EA%3C/text%3E%3C/svg%3E"
+    />
+    <title>CF/Gears Admin Panel</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>