Config & Build

defineConfig() is a typed pass-through helper for your rasengan.server.ts file, read by both the CLI and bootstrap().

import { defineConfig } from '@rasenganjs/server';
 
export default defineConfig({
  entry: 'src/main.ts',
  port: 4000,
  host: '0.0.0.0',
  preset: 'node',
  watchDir: 'src/',
  build: {
    outDir: 'dist',
    minify: true,
    formats: ['single-file'],
  },
});

RasenganServerConfig

BuildConfig

Resolution Order

Configuration merges from three sources, later ones winning:

1. Built-in defaults (the table above).
2. rasengan.server.js or rasengan.server.ts at the project root.
3. CLI flag overrides (--port, --host, --entry, --preset, --watch-dir) — see CLI.

Build Output Formats

rasengan-server build bundles your server with esbuild:

• single-file — everything bundled into one server.bundle.mjs. Simplest to deploy — copy one file.
• directory — one .mjs per source file, preserving your project's structure. Useful when you want to inspect or patch individual output files.

Both formats can be produced in the same build by listing both in formats.

Programmatic Overrides

bootstrap() accepts an optional second argument — a partial config that merges on top of everything else, useful for tests or embedding:

bootstrap(
  (app) => {
    app.registerModule(appModule);
  },
  { port: 0 }
); // port 0 lets the OS assign a free port, handy in tests