Bun runtime for Phoenix.ReactServer server.

This runtime uses Bun as the JavaScript runtime for rendering React components. Bun provides fast startup times and excellent performance for server-side rendering.

Configuration

Configure in runtime.exs:

import Config

config :phoenix_react_ng, Phoenix.ReactServer.Runtime.Bun,
  cd: File.cwd!(),
  cmd: System.find_executable("bun"),
  # In dev mode, the server_js will be watched and recompiled when changed
  # In prod mode, this needs to be precompiled with `mix phx.react.bun.bundle`
  server_js: Path.expand("bun/server.js", :code.priv_dir(:phoenix_react_ng)),
  port: 5225,
  env: :dev

Configuration Options

• :cd - Working directory for the Bun process (default: current directory)
• :cmd - Path to Bun executable (default: system bun command)
• :server_js - Path to the bundled server JavaScript file
• :port - Port for the Bun HTTP server (default: 5225)
• :env - Environment mode (:dev or :prod, default: :dev)

Development Mode

In development mode (env: :dev), the runtime will:

• Start a file watcher for component changes
• Automatically rebuild the server bundle when components change
• Enable hot reloading for React components

Production Mode

In production mode (env: :prod), you must pre-bundle the components:

mix phx.react.bun.bundle --component-base=assets/component --output=priv/react/server.js