Server SDK
API Reference
Full API reference for @better-i18n/server
Complete API reference for the Server SDK.
createServerI18n(config)
Factory function that creates a server-side i18n instance. Call this once at module scope — never inside a request handler.
import { createServerI18n } from "@better-i18n/server";
export const i18n = createServerI18n({
project: "my-org/api",
defaultLocale: "en",
});Config Options
| Option | Type | Default | Description |
|---|---|---|---|
project | string | Required | Project identifier in org/project format |
defaultLocale | string | Required | Fallback locale when detection fails |
cdnBaseUrl | string | "https://cdn.better-i18n.com" | CDN base URL override |
fetchTimeout | number | 10000 | CDN fetch timeout in milliseconds |
retryCount | number | 1 | Number of retries on CDN failure |
debug | boolean | false | Enable debug logging |
logLevel | "debug" | "info" | "warn" | "error" | "silent" | "warn" | Log verbosity |
Return Value
Returns a ServerI18n instance — see the ServerI18n interface below.
ServerI18n Interface
The instance returned by createServerI18n.