+
+ );
+}
+
+export function App() {
+ return (
+
+
+
+
+ );
+}
diff --git a/frontend/packages/swarm-ui/src/colors.css b/frontend/packages/swarm-ui/src/colors.css
new file mode 100644
index 00000000..bc218783
--- /dev/null
+++ b/frontend/packages/swarm-ui/src/colors.css
@@ -0,0 +1,6 @@
+/* Standalone base16 palette — re-exports the shared base16 slots so
+ esbuild emits its own `dist/static/colors.css`, linked first by every
+ swarm-ui page (before theme.css). This is the theme swap contract: a
+ stylix-generated variant replaces only this file. See
+ @hive/shared/colors.css + docs/web-ui/css-vars.md. */
+@import "@hive/shared/colors.css";
diff --git a/frontend/packages/swarm-ui/src/index.html b/frontend/packages/swarm-ui/src/index.html
new file mode 100644
index 00000000..9ed89442
--- /dev/null
+++ b/frontend/packages/swarm-ui/src/index.html
@@ -0,0 +1,15 @@
+
+
+
+
+
+ hyperhive swarm
+
+
+
+
+
+
+
+
+
diff --git a/frontend/packages/swarm-ui/src/main.tsx b/frontend/packages/swarm-ui/src/main.tsx
new file mode 100644
index 00000000..10721697
--- /dev/null
+++ b/frontend/packages/swarm-ui/src/main.tsx
@@ -0,0 +1,7 @@
+import { render } from 'preact';
+import { App } from './App.js';
+
+const root = document.getElementById('root');
+if (root) {
+ render(, root);
+}
diff --git a/frontend/packages/swarm-ui/src/swarm-ui.css b/frontend/packages/swarm-ui/src/swarm-ui.css
new file mode 100644
index 00000000..43134567
--- /dev/null
+++ b/frontend/packages/swarm-ui/src/swarm-ui.css
@@ -0,0 +1,12 @@
+@import "@hive/shared/base.css";
+
+/* Bootstrap placeholder only — real layout comes with the first
+ route that actually needs one. */
+.swarm-ui-empty {
+ max-width: 40em;
+ margin: 4em auto;
+ padding: 0 1em;
+}
+.swarm-ui-empty h1 {
+ color: var(--purple);
+}
diff --git a/frontend/packages/swarm-ui/src/theme.css b/frontend/packages/swarm-ui/src/theme.css
new file mode 100644
index 00000000..f3b22bc5
--- /dev/null
+++ b/frontend/packages/swarm-ui/src/theme.css
@@ -0,0 +1,6 @@
+/* Standalone semantic theme layer — re-exports the shared derivation so
+ esbuild emits it as its own `dist/static/theme.css`, linked by every
+ swarm-ui page right after colors.css. The base16 slots it derives
+ from live in colors.css (the swap contract); a theme swap replaces
+ only that file. See @hive/shared/theme.css + docs/web-ui/css-vars.md. */
+@import "@hive/shared/theme.css";
diff --git a/frontend/packages/swarm-ui/tsconfig.json b/frontend/packages/swarm-ui/tsconfig.json
new file mode 100644
index 00000000..fa84fda7
--- /dev/null
+++ b/frontend/packages/swarm-ui/tsconfig.json
@@ -0,0 +1,20 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
+ "jsx": "react-jsx",
+ "jsxImportSource": "preact",
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true,
+ "skipLibCheck": true,
+ "isolatedModules": true,
+ "noEmit": true,
+ "esModuleInterop": true,
+ "forceConsistentCasingInFileNames": true
+ },
+ "include": ["src"]
+}
diff --git a/nix/checks.nix b/nix/checks.nix
index 4c0d348a..05f64b89 100644
--- a/nix/checks.nix
+++ b/nix/checks.nix
@@ -69,7 +69,14 @@ in
# every PR and only breaks when the host toplevel is built on deploy.
# Reusing the already-defined `packages..frontend` derivation
# makes such a hash mismatch a red PR instead of a red main.
- inherit (self.packages.${system}) frontend;
+ #
+ # `swarm-ui` alongside it for the same FOD-staleness reason (shares
+ # the same lockfile / `npmDepsHash`, see nix/packages/swarm-ui.nix) —
+ # plus, since it's not in `packages.default`'s dependency closure like
+ # `frontend` is, this is also the only thing that actually *builds*
+ # it in CI rather than just evaluating it (`nix flake check` doesn't
+ # build every `packages..*` output on its own).
+ inherit (self.packages.${system}) frontend swarm-ui;
# `hivectl` CLI reference freshness check. The committed
# markdown at `docs/tools/hivectl-cli.md` is the rendered
diff --git a/nix/packages/default.nix b/nix/packages/default.nix
index e8e234cd..d91e54bd 100644
--- a/nix/packages/default.nix
+++ b/nix/packages/default.nix
@@ -150,6 +150,13 @@ in
# in the daemon's package so a hive can pin one without the other.
swarmctl = mkBinPackage "swarmctl" "hyperhive swarm-level operator CLI";
+ # Static build of the swarm-level UI shell — see ./swarm-ui.nix. Same
+ # "swarm-scoped, not core-bundle" reasoning as swarm-controller/swarmctl
+ # above, kept a separate package for the same reason: not every hive
+ # runs the swarm controller, so this shouldn't ride along in
+ # `packages.default`'s closure.
+ swarm-ui = pkgs.callPackage ./swarm-ui.nix { };
+
# Bundled browser assets — see ./frontend.nix. Output is
# $out/{dashboard,agent}/ which the Rust binaries serve via
# tower_http::ServeDir.
diff --git a/nix/packages/frontend.nix b/nix/packages/frontend.nix
index 75ba75dd..0aae207e 100644
--- a/nix/packages/frontend.nix
+++ b/nix/packages/frontend.nix
@@ -40,7 +40,7 @@ buildNpmPackage {
# Update whenever the lockfile changes. Recompute locally with the
# same command (`pkgs.prefetch-npm-deps`), or let the build fail
# and copy the actual hash from the error message.
- npmDepsHash = "sha256-jRHMoaE4z9T/K+OfpXorYwGGo4Fp2Dk/+wTMR56kmdA=";
+ npmDepsHash = "sha256-LIwW5Nn9cSqJHCm1czPIVxQdP5OqWk7U/4kvkwaj2ts=";
# `npm run build` recurses into all workspaces (`--workspaces
# --if-present`). The workspaces' build scripts each run their own
diff --git a/nix/packages/swarm-ui.nix b/nix/packages/swarm-ui.nix
new file mode 100644
index 00000000..58892ea3
--- /dev/null
+++ b/nix/packages/swarm-ui.nix
@@ -0,0 +1,58 @@
+{ buildNpmPackage }:
+
+# Static build of the swarm-level UI shell (project-bootstrap scope:
+# empty start page, no functionality yet — see
+# frontend/packages/swarm-ui/package.json for the full rationale).
+# Stack: Preact + wouter + TypeScript + JSX, a real SPA shell with
+# routing/deep-links, distinct from the per-hive dashboard's
+# vanilla-JS + custom-element MPA.
+#
+# Deliberately its OWN package, not folded into `./frontend.nix`
+# (which bundles dashboard + agent into `packages.default`'s closure):
+# swarm-ui is swarm-scoped, same reasoning `swarm-controller`/`swarmctl`
+# already use for staying out of `daemonBins` — a hive that doesn't run
+# the swarm controller shouldn't carry swarm-ui bytes in its closure.
+#
+# Not yet consumed anywhere: swarm-controller only serves `/health`
+# today (swarm-controller/README.md) — this just makes the static
+# build a buildable, packageable artifact so the wiring (once auth
+# against authelia is figured out) has something to point at.
+#
+# Shares `frontend/package-lock.json` with `./frontend.nix` (same repo,
+# same npm workspace root) — `npmDepsHash` must be updated in lockstep
+# with that file's whenever the lockfile changes, since both hash the
+# same file. Scoped to build only the `swarm-ui` workspace (not the
+# whole `npm run build --workspaces` frontend.nix runs) via an explicit
+# `npm run build --workspace=…` buildPhase, so a dashboard/agent-only
+# change doesn't need to rebuild (or re-review the output of) this
+# derivation.
+
+buildNpmPackage {
+ pname = "hyperhive-swarm-ui";
+ version = "0.0.0";
+ src = ../../frontend;
+
+ # Recompute with `prefetch-npm-deps frontend/package-lock.json`
+ # whenever the lockfile changes — same value as `./frontend.nix`'s
+ # `npmDepsHash`, both hash the one shared lockfile.
+ npmDepsHash = "sha256-LIwW5Nn9cSqJHCm1czPIVxQdP5OqWk7U/4kvkwaj2ts=";
+
+ buildPhase = ''
+ runHook preBuild
+ npm run build --workspace=packages/swarm-ui
+ runHook postBuild
+ '';
+
+ dontNpmInstall = true;
+ installPhase = ''
+ runHook preInstall
+ mkdir -p $out
+ cp -r packages/swarm-ui/dist/. $out/
+ runHook postInstall
+ '';
+
+ meta = {
+ description = "hyperhive swarm-level UI static frontend build (bootstrap — empty start page)";
+ homepage = "https://forge.darkest.space/hyperhive/hyperhive";
+ };
+}