@akanjs/cli 3.0.0-alpha.4 → 3.0.0-alpha.5

package/.build-stamp

@@ -1 +1 @@
-52e4d869ab5170b4db59ce979635a10421003c20193f71051a8df3007f2ecf38
+a0eaadfb9b58c3aa21817d33fb8bc0ad7889c719fb293715682a39a426dc01b9

package/{abstractCompactor-rk6twzvj.js → abstractCompactor-e5yq60qz.js}

@@ -1,11 +1,11 @@
 // @bun
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   AbstractDoc
 } from "./index-0wae5ebk.js";
-import"./index-6pz1j0zj.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{agent.command-jfz8yfwy.js → agent.command-b0fcx3r2.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   AgentScript
-} from "./index-n0z3f2xg.js";
-import"./index-4yp06pn1.js";
-import"./index-4zgs8g1w.js";
-import"./index-xwgm94zr.js";
+} from "./index-nfxq39kj.js";
+import"./index-jn9vfpwz.js";
+import"./index-m4kpmmtj.js";
+import"./index-qp089jp0.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-jkynkyfk.js";
+import"./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{application.command-mxyqtd6p.js → application.command-cgmy00gd.js}

@@ -4,22 +4,22 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-tq1y56tp.js";
+} from "./index-nx1vbtsc.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
-import"./index-cn24dcqn.js";
+import"./index-exhpp31y.js";
 import {
   App,
   Exec,
   Sys,
   Workspace,
   command
-} from "./index-jk9q6pse.js";
+} from "./index-jkynkyfk.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{applicationBuildRunner-cwk52sb7.js → applicationBuildRunner-n1svrwgt.js}

@@ -4,13 +4,13 @@ import {
   CsrArtifactBuilder,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-cap2k2ch.js";
+} from "./index-0fj4yg7k.js";
 import"./index-xjd3rqzj.js";
-import"./index-rh16j3c7.js";
+import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import"./index-r24hmh0q.js";
 
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts
@@ -66,7 +66,7 @@ class ApplicationBuildRunner {
     await this.#runPhase("backend", "Compiling backend", () => this.#buildBackend(), (result) => `${result.entrypoints} entrypoints, ${result.outputs} outputs`, phaseOptions);
     await this.#runPhase("ssr", "Building SSR route artifacts", () => this.#buildSsr(), (result) => result ? `${result.allRoutes.manifest.routeIds.length} routes, ${result.allRoutes.manifest.knownEntries.length} entries` : "skipped", phaseOptions);
     await this.#runPhase("csr", "Building CSR assets", () => this.#buildCsr(), (result) => result?.outputDir ?? "skipped", phaseOptions);
-    await this.#runPhase("compress", "Compressing static assets", () => precompressArtifacts(this.#app), (result) => result.files > 0 ? `${result.files} files, ${ApplicationBuildRunner.formatBytes(result.inputBytes)} -> ${ApplicationBuildRunner.formatBytes(result.outputBytes)}` : "no files", phaseOptions);
+    await this.#runPhase("compress", "Compressing static assets", () => precompressArtifacts(this.#app), (result) => result.files > 0 ? `${result.files} files, ${ApplicationBuildRunner.formatBytes(result.inputBytes)} -> gzip ${ApplicationBuildRunner.formatBytes(result.outputBytes)} / br ${ApplicationBuildRunner.formatBytes(result.brotliBytes)}` : "no files", phaseOptions);
     await this.#runPhase("metadata", "Writing production metadata", () => this.#buildAppMeta(), undefined, {
       spinner
     });

package/{applicationReleasePackager-yrrhbkv3.js → applicationReleasePackager-gg8ccbeh.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/buildBatch.proc.js

@@ -5,15 +5,15 @@ import {
   FontOptimizer,
   PagesBundleBuilder,
   SsrBaseArtifactBuilder
-} from "./index-cap2k2ch.js";
+} from "./index-0fj4yg7k.js";
 import"./index-xjd3rqzj.js";
-import"./index-rh16j3c7.js";
+import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{capacitorApp-j357ak1g.js → capacitorApp-yyw35vg4.js}

@@ -11,7 +11,6 @@ import {
   formatAndroidReleaseSigningError,
   formatIosRunFailureMessage,
   getAdbDeviceStateIssues,
-  getAndroidLocalServerHost,
   getMissingAndroidReleaseSigningKeys,
   isPlaceholderAppId,
   materializeCapacitorConfig,
@@ -25,10 +24,10 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-y0k42k04.js";
+} from "./index-mterpj70.js";
 import"./index-76rn3g2c.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 export {
@@ -45,7 +44,6 @@ export {
   materializeCapacitorConfig,
   isPlaceholderAppId,
   getMissingAndroidReleaseSigningKeys,
-  getAndroidLocalServerHost,
   getAdbDeviceStateIssues,
   formatIosRunFailureMessage,
   formatAndroidReleaseSigningError,

package/{cloud.command-f87dwe52.js → cloud.command-1m7hfdpk.js}

@@ -1,23 +1,23 @@
 // @bun
 import {
   CloudScript
-} from "./index-ybybkec0.js";
-import"./index-xj8bks3p.js";
-import"./index-e3qskyt2.js";
+} from "./index-mn96y1nk.js";
+import"./index-p6txr1ss.js";
+import"./index-meh7mmz9.js";
 import {
   GlobalConfig
-} from "./index-3pgtw35d.js";
-import"./index-tq1y56tp.js";
+} from "./index-0cj2zxbm.js";
+import"./index-nx1vbtsc.js";
 import"./index-76rn3g2c.js";
-import"./index-cn24dcqn.js";
+import"./index-exhpp31y.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
+} from "./index-jkynkyfk.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-46tjzh6s.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{context.command-z5bf8bn7.js → context.command-b5heat2a.js}

@@ -1,26 +1,26 @@
 // @bun
 import {
   ContextScript
-} from "./index-1s71fwrq.js";
-import"./index-b978vs2e.js";
-import"./index-csqk9z5j.js";
-import"./index-r4w8cry5.js";
-import"./index-vhv3xnjz.js";
-import"./index-hjzr8ja1.js";
-import"./index-fmgbwsr5.js";
+} from "./index-p69fcwe1.js";
+import"./index-6npsfpxr.js";
+import"./index-c94nq3c1.js";
+import"./index-pfrt7qwh.js";
+import"./index-60a3jfcz.js";
+import"./index-hrwzz2wf.js";
+import"./index-wrrb8rxk.js";
 import"./index-ss469dec.js";
-import"./index-y0k42k04.js";
-import"./index-3pgtw35d.js";
-import"./index-4yp06pn1.js";
-import"./index-4zgs8g1w.js";
-import"./index-xwgm94zr.js";
+import"./index-mterpj70.js";
+import"./index-0cj2zxbm.js";
+import"./index-jn9vfpwz.js";
+import"./index-m4kpmmtj.js";
+import"./index-qp089jp0.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-jkynkyfk.js";
+import"./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{guideline.command-1m1ctar3.js → guideline.command-9ew6aqhm.js}

@@ -1,20 +1,20 @@
 // @bun
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-qp089jp0.js";
 import {
   Workspace,
   command,
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-jkynkyfk.js";
 import {
   getDirname
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/guidelines/ssrRule/ssrRule.generate.json

@@ -0,0 +1,31 @@
+{
+  "title": "SSR Rule",
+  "description": "Akan SSR-first rendering rules — keep JSX on the server and justify every client boundary",
+  "group": "core",
+  "codegenPriority": 3,
+  "deprecated": false,
+  "scans": [
+    {
+      "type": "example",
+      "description": "Client boundary shells that render server children untouched",
+      "path": "{apps,libs}/*/ui/**/*.tsx",
+      "sample": 4
+    },
+    {
+      "type": "example",
+      "description": "Module UI split across client Zone/Template/Util and server Unit/View",
+      "path": "{apps,libs}/*/lib/*/*.tsx",
+      "sample": 4
+    }
+  ],
+  "update": {
+    "filePath": "./ssrRule.instruction.md",
+    "contents": ["purpose", "when a client boundary is earned", "quality rules", "implementation playbook"],
+    "rules": [
+      "Use current Akan APIs only",
+      "Keep output parseable for codegen",
+      "Name the akan.ssr.* rule ids the quality scanner emits",
+      "Ground every pattern in a file that exists in the workspace"
+    ]
+  }
+}

package/guidelines/ssrRule/ssrRule.instruction.md

@@ -0,0 +1,108 @@
+# Akan SSR Rule Guideline
+
+## Purpose
+Use this when writing or reviewing any `.tsx` file. Akan is SSR-first: an element rendered on the server ships as
+HTML and costs nothing to hydrate, while an element behind `"use client"` ships twice — as markup and as bundled JS
+that re-runs in the browser. The boundary question is never "may this file be client", it is **how little ends up
+on the client side**.
+
+## When A Client Boundary Is Earned
+- A component earns `"use client"` only by using a client-only capability: a React hook, a JSX event handler, the
+  store (`st.use.*` / `st.do.*`), a browser global (`window`, `document`, `navigator`, `localStorage`, …), or a
+  client-only third-party package.
+- Rendering markup, mapping over data, reading a route param, and calling `l()` are server work. `usePage()` and
+  `getSelf()` are legal in server components and never force a boundary.
+- In domain UI the file role fixes the directive: `Template`, `Zone`, and `Util` are client; `Unit` and `View` are
+  server. That decides *where* the boundary sits, not how much markup sits behind it — a `Zone` that hoards markup
+  is still an SSR regression.
+- Measure with `akan quality ssr` (`--format json` for tooling). It reports the server render share per app and
+  lib as server-rendered JSX elements over total. Treat **50% server share as the floor** and a falling share as a
+  regression to justify or revert.
+
+## Quality Rules
+- `akan.ssr.unnecessary-use-client` — the directive is present but nothing in the file needs it. Delete it. If the
+  file exists only to wrap one client child, drop the wrapper and use the child directly.
+- `akan.ssr.client-static-component` — a component inside a client file renders real markup with zero client-only
+  capability. Move it to a server file: a `<Model>.Unit.tsx` / `<Model>.View.tsx` for a module, or a `ui/` file with
+  no directive.
+- `akan.ssr.client-static-markup` — a large subtree wraps one or two interactive touches. Keep the interactive
+  element in the client component and hoist the static subtree into a server component received as `children`.
+- `akan.ssr.client-mount-load` — a `useEffect(…, [])` loads server data. Fetch it in the route and pass the
+  init/view object down.
+- `akan.ssr.module-missing-server-view` — a module renders only from `Template`/`Zone`/`Util` and declares no
+  `Unit`/`View`. Add them and have the `Zone` delegate.
+- `akan.ssr.template-client-state` — a `Template` holds form state in `useState`. Bind to the store instead:
+  `value={xForm.field}` with `onChange={st.do.setFieldOnX}`.
+
+A third-party client package and the `ui/<Folder>/index_.tsx` + `lazy()` boundary both justify the directive and are
+not flagged. Interaction-driven `fetch.*` inside an `onClick` is not flagged either — only mount-time loads are,
+because those are the ones the server could have performed.
+
+## Implementation Playbook
+
+**① Wrap the interaction, not the UI.** The smallest useful client component adds one behaviour and renders
+`children` untouched, so the markup inside never reaches the bundle.
+
+```tsx
+"use client";
+export const ClickWrapper = ({ children, onPick }: ClickWrapperProps) => <div onClick={onPick}>{children}</div>;
+```
+
+`libs/shared/ui/Only/User.tsx` is the same shape: it reads auth state on the client and returns `{children}`.
+
+**② Split compound components so panels stay on the server.** A tab, accordion, or disclosure needs client state
+only for *which* part is visible, never for what the parts contain. `Tab` / `Tab.Menus` / `Tab.Menu` / `Tab.Panel`
+in `akanjs/ui` is the reference: only the provider and menu hold state, and `<Tab.Panel>` renders its children
+as-is, so a server `Unit`/`View` passed in stays server-rendered.
+
+```tsx
+<Tab defaultMenu="detail">
+  <Tab.Menus>
+    <Tab.Menu menu="detail">{l("post.detail")}</Tab.Menu>
+    <Tab.Menu menu="history">{l("post.history")}</Tab.Menu>
+  </Tab.Menus>
+  <Tab.Panel menu="detail">
+    <Post.View.General post={post} />
+  </Tab.Panel>
+</Tab>
+```
+
+Never collapse this into one client file with a mode `useState` and every panel body inlined.
+
+**③ Sync state instead of fetching it.** A server component cannot hold state, so render the initial data on the
+server and hand it across as a serializable object. The route calls `fetch.initXInY(...)` / `fetch.viewX(...)` and
+passes the result into a `Zone`; `Load.Units` / `Load.View` hydrate the store from it. A `useEffect(…, [])` that
+fetches on mount renders an empty shell, hydrates, then round-trips for data the server already had.
+
+**④ Push the boundary down to the leaf that needs it.** A store-reading `Zone` should hold zero markup and delegate
+to a server `View` — `User.Zone.Self` is one line, `st.use.self()` into `<User.View.General user={self} />`, so the
+whole detail surface renders server-side wherever a route uses the `View` directly.
+
+**⑤ Hand the promise across, not the awaited value.** `ClientInit` / `ClientView` are `PromiseOrObject<T>`, so a
+route may pass an unawaited `fetch.initX(...)` and `Load.*` resolves it behind a skeleton. `await` blocks the shell
+for data the page needs immediately; the promise streams the rest. Independent fetches still go through one
+`Promise.all`.
+
+**⑥ Use named `ReactNode` slots, not just `children`.** `Layout.Navbar` accepts `title`, `back`, `left`, `right`,
+and `children`, so a client shell composes server-rendered content in five places instead of absorbing it.
+
+**⑦ Let the server do the derived work.** Display and predicate logic belongs on `Light<Model>` (`isNew()`,
+`canWrite(user?)`, `formatTimes()`), and enum→class lookups belong in a module-scope `as const` map. Both sides call
+the same method, so a client component that exists only to compute a label is markup in the wrong place.
+
+**⑧ Gate auth on the server.** `getSelf({ unauthorize: "/signin" })` in `_layout.tsx` redirects before any HTML is
+sent. A client-side check costs a hydration round-trip and flashes the wrong UI first.
+
+**⑨ Prefer CSS over client state for pure visibility.** A `data-*` attribute plus `group-data-[…]` variants (see
+`libs/util/ui/Grid/*`) or `<details>`/`<summary>` keeps both branches server-rendered. Reach for `useState` when the
+state is real, not when a Tailwind variant would do.
+
+**⑩ Keep the heavy island out of the first load.** A large client-only widget goes behind the
+`ui/<Folder>/index_.tsx` + `lazy()` pair so the server renders the page around it.
+
+## Review Checklist
+- Does every `"use client"` in the diff name a capability that requires it?
+- Does each client component hold only interaction, with markup delegated to `children`, a slot prop, or a
+  `Unit`/`View`?
+- Is initial data fetched in the route and passed as `init`/`view`, with no mount-only load effect?
+- Did `akan quality ssr` hold or improve the server share for every touched app and lib?

package/incrementalBuilder.proc.js

@@ -8,7 +8,7 @@ import {
   DevGeneratedIndexSync,
   GraphClientEntryDiscovery,
   RouteClientBuilder
-} from "./index-rh16j3c7.js";
+} from "./index-j9cxndc0.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -16,8 +16,8 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-47qxw1tz.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{index-3pgtw35d.js → index-0cj2zxbm.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-cap2k2ch.js → index-0fj4yg7k.js}

@@ -9,7 +9,7 @@ import {
   createTsconfigPackageResolver,
   rewriteBarrelImports,
   transformUseClient
-} from "./index-rh16j3c7.js";
+} from "./index-j9cxndc0.js";
 import {
   __require
 } from "./index-r24hmh0q.js";
@@ -415,11 +415,21 @@ class AllRoutesBuilder {
     const seedIndex = computeRouteSeedIndex(pageEntries);
     this.#app.verbose(`[build-all] discovered ${seedIndex.entries.length} routes`);
     this.#discovery = await GraphClientEntryDiscovery.create(this.#app);
+    const allEntries = [];
+    const seen = new Set;
     for (const entry of seedIndex.entries) {
       const seeds = Array.from(new Set([...seedIndex.globalLayoutFiles, ...entry.seeds]));
-      const delta = await this.#buildRoute(entry.routeId, seeds);
-      this.#mergeRoute(entry.routeId, delta);
+      for (const discovered of await this.#discovery.discover(seeds)) {
+        if (seen.has(discovered))
+          continue;
+        seen.add(discovered);
+        allEntries.push(discovered);
+      }
+      this.#routeIds.push(entry.routeId);
     }
+    this.#app.verbose(`[build-all] ${allEntries.length} client entries across ${this.#routeIds.length} routes`);
+    const delta = await this.#buildEntries(allEntries);
+    this.#mergeDelta(delta);
     this.#merged.knownEntries = Array.from(this.#knownSet);
     const manifest = {
       routeIds: this.#routeIds,
@@ -433,23 +443,30 @@ class AllRoutesBuilder {
     this.#app.verbose(`[build-all] wrote ${manifestPath} routes=${this.#routeIds.length} entries=${this.#merged.knownEntries.length}`);
     return { manifest, manifestPath, seedIndex };
   }
-  async#buildRoute(routeId, seeds) {
+  async#buildEntries(entries) {
     if (!this.#discovery)
       throw new Error("[build-all] client entry discovery is not initialized");
+    if (entries.length === 0)
+      return {
+        manifestDelta: {},
+        ssrManifestDelta: { moduleLoading: null, moduleMap: {} },
+        newEntries: [],
+        clientDeps: []
+      };
     const started = Date.now();
     const delta = await new RouteClientBuilder({
       app: this.#app,
-      routeId,
-      seeds,
+      seeds: [],
+      entries,
       artifact: this.#artifact,
       knownEntries: this.#knownSet,
       discovery: this.#discovery,
       command: this.#command
     }).build();
-    this.#app.verbose(`[build-all] ${routeId} +${delta.newEntries.length} entries (${Date.now() - started}ms)`);
+    this.#app.verbose(`[build-all] bundled ${delta.newEntries.length} entries (${Date.now() - started}ms)`);
     return delta;
   }
-  #mergeRoute(routeId, delta) {
+  #mergeDelta(delta) {
     for (const [key, row] of Object.entries(delta.manifestDelta))
       this.#merged.clientManifest[key] = row;
     for (const [url, byName] of Object.entries(delta.ssrManifestDelta.moduleMap)) {
@@ -457,7 +474,6 @@ class AllRoutesBuilder {
     }
     for (const abs of delta.newEntries)
       this.#knownSet.add(abs);
-    this.#routeIds.push(routeId);
   }
 }
 
@@ -794,10 +810,10 @@ import { compile } from "tailwindcss";
 
 // pkgs/@akanjs/devkit/frontendBuild/cssCandidateCache.ts
 import { stat } from "fs/promises";
-var CANDIDATE_RE = /-?(?:[\w@]|\[[^\]]+\])[\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
+var CANDIDATE_RE = /-?[\w@][\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
 
 class CssCandidateCache {
-  static #version = 2;
+  static #version = 1;
   #path;
   #entries = new Map;
   #dirty = false;
@@ -2025,14 +2041,21 @@ function loaderFor2(absPath) {
 // pkgs/@akanjs/devkit/frontendBuild/precompressArtifacts.ts
 import fs2 from "fs";
 import path12 from "path";
+import zlib from "zlib";
 var COMPRESSIBLE_EXTS = new Set([".css", ".html", ".js", ".json", ".svg"]);
 var MIN_COMPRESS_BYTES = 1024;
+var BROTLI_QUALITY_BY_EXT = { ".css": 11 };
+var DEFAULT_BROTLI_QUALITY = 9;
+var GZIP_LEVEL = 9;
 async function precompressArtifacts(app) {
-  const roots = [path12.join(app.dist.cwdPath, ".akan/artifact/client")];
-  const result = { files: 0, inputBytes: 0, outputBytes: 0 };
+  const roots = [
+    path12.join(app.dist.cwdPath, ".akan/artifact/client"),
+    path12.join(app.dist.cwdPath, ".akan/artifact/styles")
+  ];
+  const result = { files: 0, inputBytes: 0, outputBytes: 0, brotliBytes: 0 };
   await Promise.all(roots.map((root) => precompressRoot(root, result)));
   if (result.files > 0) {
-    app.verbose(`[precompress] wrote ${result.files} gzip sidecars (${formatBytes(result.inputBytes)} -> ${formatBytes(result.outputBytes)})`);
+    app.verbose(`[precompress] wrote ${result.files} sidecars (${formatBytes(result.inputBytes)} -> gzip ${formatBytes(result.outputBytes)} / br ${formatBytes(result.brotliBytes)})`);
   }
   return result;
 }
@@ -2044,15 +2067,27 @@ async function precompressRoot(root, result) {
     if (!await shouldPrecompress(filePath))
       continue;
     const bytes = await Bun.file(filePath).bytes();
-    const gz = Bun.gzipSync(toArrayBuffer(bytes));
-    await Bun.write(`${filePath}.gz`, gz);
+    const buffer = toArrayBuffer(bytes);
+    const gz = Bun.gzipSync(buffer, { level: GZIP_LEVEL });
+    const br = brotliCompress(buffer, path12.extname(filePath).toLowerCase());
+    await Promise.all([Bun.write(`${filePath}.gz`, gz), Bun.write(`${filePath}.br`, br)]);
     result.files += 1;
     result.inputBytes += bytes.byteLength;
     result.outputBytes += gz.byteLength;
+    result.brotliBytes += br.byteLength;
   }
 }
+function brotliCompress(buffer, ext) {
+  const quality = BROTLI_QUALITY_BY_EXT[ext] ?? DEFAULT_BROTLI_QUALITY;
+  return zlib.brotliCompressSync(buffer, {
+    params: {
+      [zlib.constants.BROTLI_PARAM_QUALITY]: quality,
+      [zlib.constants.BROTLI_PARAM_SIZE_HINT]: buffer.byteLength
+    }
+  });
+}
 async function shouldPrecompress(filePath) {
-  if (filePath.endsWith(".gz"))
+  if (filePath.endsWith(".gz") || filePath.endsWith(".br"))
     return false;
   if (!COMPRESSIBLE_EXTS.has(path12.extname(filePath).toLowerCase()))
     return false;