@bractjs/bractjs 0.1.20 → 0.1.21

package/bin/cli.ts

@@ -75,7 +75,16 @@ switch (command) {
     // server build (react-dom/server.bun production) instead of the dev one.
     if (!process.env.NODE_ENV) process.env.NODE_ENV = "production";
     const { runBuild } = await import("../src/build/bundler.ts");
-    await runBuild({ port: 3000, appDir: "./app", publicDir: "./public", buildDir: "./build", manifest: { clientEntry: "", routes: {} } });
+    const { loadUserConfig } = await import("../src/config/load.ts");
+    const userCfg = await loadUserConfig();
+    await runBuild({
+      port: 3000,
+      appDir: "./app",
+      publicDir: "./public",
+      buildDir: "./build",
+      manifest: { clientEntry: "", routes: {} },
+      ...userCfg,
+    });
     break;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bractjs/bractjs",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Production-grade SSR framework for Bun + React 19. File-based routing, streaming SSR, server actions, typed routes.",
   "license": "MIT",
   "homepage": "https://github.com/bractjs/bractjs#readme",

package/src/build/bundler.ts

@@ -54,7 +54,7 @@ export async function runBuild(config: BractJSConfig): Promise<void> {
     minify: config.minify ?? true,
     sourcemap: config.sourcemap ?? "external",
     define: buildDefines(config),
-    plugins: [serverOnlyPlugin, useServerProxyPlugin, clientEnvPlugin(config.clientEnv ?? [], Bun.env as Record<string, string>), cssModulesPlugin],
+    plugins: [serverOnlyPlugin, useServerProxyPlugin, clientEnvPlugin(config.clientEnv ?? [], Bun.env as Record<string, string>), cssModulesPlugin, ...(config.plugins ?? [])],
   });
   if (!clientResult.success) throw new AggregateError(clientResult.logs, "Client build failed");
 

package/src/config/load.ts

@@ -0,0 +1,17 @@
+import { resolve } from "node:path";
+import type { BractJSConfig } from "../server/serve.ts";
+
+/**
+ * Load `bractjs.config.ts` (or `.js`) from the user's cwd if present.
+ * Returns an empty object when no file exists — callers fall back to defaults.
+ */
+export async function loadUserConfig(): Promise<Partial<BractJSConfig>> {
+  for (const name of ["bractjs.config.ts", "bractjs.config.js"]) {
+    const path = resolve(process.cwd(), name);
+    if (!(await Bun.file(path).exists())) continue;
+    const mod = await import(path);
+    const cfg = (mod.default ?? mod) as Partial<BractJSConfig>;
+    return cfg ?? {};
+  }
+  return {};
+}

package/src/dev/rebuilder.ts

@@ -48,7 +48,7 @@ export async function rebuildClient(
       // structure. publicPath + ../ traversals produce wrong absolute URLs.
       minify: false,
       sourcemap: "inline",
-      plugins: [useServerProxyPlugin],
+      plugins: [useServerProxyPlugin, ...(config?.plugins ?? [])],
     });
   } finally {
     await rm(shimPath, { force: true });

package/src/dev/server.ts

@@ -6,15 +6,18 @@ import { rebuildClient } from "./rebuilder.ts";
 import { filePathToPattern } from "../server/scanner.ts";
 import { basename, extname } from "node:path";
 import type { LifecycleHooks } from "../server/lifecycle.ts";
+import { loadUserConfig } from "../config/load.ts";
 
 // Must precede any user-code import so SSR-time isDevRuntime() checks
 // (e.g. inside <LiveReload>) observe the dev mode.
 setRuntimeMode("dev");
 
+const userConfig = await loadUserConfig();
+
 const hmr = createHmrServer(3001);
 
 // Build client bundle before the HTTP server starts accepting requests
-const { duration: initialMs } = await rebuildClient();
+const { duration: initialMs } = await rebuildClient(userConfig);
 console.log(`[bractjs] initial client build in ${initialMs}ms`);
 
 // Load user lifecycle hooks if defined (e.g. app/lifecycle.ts)
@@ -27,10 +30,10 @@ try {
   // No lifecycle file — that's fine
 }
 
-createServer({ port: 3000, ...lifecycle });
+createServer({ port: 3000, ...userConfig, ...lifecycle });
 
-watchApp("./app", async (file) => {
-  const { duration } = await rebuildClient();
+watchApp(userConfig.appDir ?? "./app", async (file) => {
+  const { duration } = await rebuildClient(userConfig);
 
   // Route files (not layout): do a fine-grained module swap without full reload.
   // Root, layouts, and other files: fall back to full page reload.

package/src/server/serve.ts

@@ -29,6 +29,8 @@ export interface BractJSConfig {
   sourcemap?: "none" | "linked" | "inline" | "external";
   minify?: boolean;
   clientEnv?: string[];
+  /** User Bun bundler plugins appended to the client build (e.g. bun-plugin-tailwind). */
+  plugins?: import("bun").BunPlugin[];
   buildDir?: string;
   /** Directory for transformed image cache. Defaults to .bract-image-cache */
   imageCacheDir?: string;

package/types/config.d.ts

@@ -1,3 +1,5 @@
+import type { BunPlugin } from "bun";
+
 export interface BractJSConfig {
   /** TCP port to listen on. Default: 3000. */
   port: number;
@@ -15,6 +17,8 @@ export interface BractJSConfig {
   minify?: boolean;
   /** process.env keys allowed to be inlined into client bundles. */
   clientEnv?: string[];
+  /** User Bun bundler plugins appended to the client build (e.g. bun-plugin-tailwind). */
+  plugins?: BunPlugin[];
   /** Called once after the server starts listening. Use to open DB connections, warm caches, etc. */
   onStart?: () => Promise<void> | void;
   /** Called before the process exits (any signal or uncaught error). Use to close DB connections, flush queues, etc. */