feature: Performance improvements

Lazy-load all page components in App.tsx (565KB main chunk -> 200KB,
per-page chunks fetched on nav). Register @fastify/compress globally
on the BFF (gzip/brotli, SSE exempt via reply.hijack()). Cache hashed
/assets/* for 1y immutable; index.html stays no-cache.

Targets FCP regression vs the HTMX app (1.4s vs 0.6s).

Signed-off-by: Gabriel Costa <gabrielcg@proton.me>

Author: gcgoncalves

server/package-lock.json

@@ -16,11 +16,12 @@
     "lint": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@fastify/compress": "^9.2.0",
     "@fastify/cookie": "^11.1.2",
-    "@fastify/static": "^10.1.2",
     "@fastify/csrf-protection": "^8.0.1",
     "@fastify/redis": "^8.0.0",
     "@fastify/reply-from": "^12.6.4",
+    "@fastify/static": "^10.1.2",
     "fastify": "^5.11.2",
     "fastify-plugin": "^6.0.0",
     "ioredis": "^5.11.1",

server/package.json

@@ -10,6 +10,7 @@
 import Fastify from "fastify";
 
 import { config } from "./config.js";
+import compressPlugin from "./plugins/compress.js";
 import cookiePlugin from "./plugins/cookie.js";
 import csrfPlugin from "./plugins/csrf.js";
 import redisPlugin from "./plugins/redis.js";
@@ -30,6 +31,7 @@ await fastify.register(cookiePlugin);
 await fastify.register(redisPlugin);
 await fastify.register(sessionPlugin);
 await fastify.register(csrfPlugin);
+await fastify.register(compressPlugin);
 await fastify.register(staticPlugin);
 
 fastify.get("/healthz", async () => ({ ok: true }));

server/src/index.ts

@@ -0,0 +1,20 @@
+// Location: ./client/server/src/plugins/compress.ts
+// Copyright contributors to the MCP-CONTEXT-FORGE project
+// SPDX-License-Identifier: Apache-2.0
+//
+// Global response compression (brotli > gzip > deflate, by Accept-Encoding).
+// Must be registered before staticPlugin — @fastify/compress's global hook
+// only wraps replies from routes registered after it. SSE routes are exempt
+// automatically: proxy-sse.ts calls reply.hijack(), which skips the onSend
+// chain this plugin hooks into.
+
+import fastifyCompress from "@fastify/compress";
+import type { FastifyInstance } from "fastify";
+import fp from "fastify-plugin";
+
+export default fp(
+  async function compressPlugin(fastify: FastifyInstance) {
+    await fastify.register(fastifyCompress, { global: true });
+  },
+  { name: "compressPlugin" },
+);

server/src/plugins/compress.ts

@@ -32,6 +32,11 @@ export default fp(
       root: PUBLIC_DIR,
       prefix: "/",
       index: false, // '/' is handled explicitly by routes/app.ts, for the auth check
+      // Vite content-hashes every /assets/* filename, so those are safe to
+      // cache for a year. index.html itself overrides this below — it must
+      // always revalidate, since it's what points at the current hashes.
+      maxAge: "1y",
+      immutable: true,
     });
 
     fastify.setNotFoundHandler((request: FastifyRequest, reply: FastifyReply) => {
@@ -58,7 +63,7 @@ export default fp(
           statusCode: 404,
         });
       }
-      return reply.sendFile("index.html");
+      return reply.sendFile("index.html", { maxAge: 0, immutable: false });
     });
   },
   { name: "staticPlugin" },