@nimpl/i18n

i18n library designed for React Server Components with maximum optimization (due to the transfer of logic to the assembly stage and/or server side).

Read the documentation in a convenient interface at nimpl.dev/docs/i18n

Installation

``bash
npm i @nimpl/i18n
`

Why This Library?

Most i18n libraries either load the entire dictionary on the client or disable static optimization when working with Server Components.

This library resolves translations on the server. Client components only receive the specific precompiled keys they need through the Transmitter wrapper - not the whole dictionary. Pages remain statically generated with translations baked into the HTML.

Quick Start

$3

Create a configuration file (e.g., src/i18n.ts):

`ts
import { initialize } from "@nimpl/i18n/initialize";
import fs from "fs/promises";

export const { getTranslation, ServerTranslation, Transmitter, revalidate } = initialize({
load: async (language) => {
const data = await fs.readFile(./translations/${language}.json, "utf-8");
return JSON.parse(data);
},
getLanguage: async () => {
// Use next/root-params, @nimpl/getters, @nimpl/context or implement your own language detection
const { params } = await import("@nimpl/getters/get-params").then(m => m.getParams());
return params.lang as string;
},
languages: ["en", "de", "fr"],
cache: true,
});
`

$3

`
app/
[lang]/
layout.tsx
page.tsx
`

`tsx
// app/[lang]/layout.tsx
export default function RootLayout({
children,
params,
}: {
children: React.ReactNode;
params: { lang: string };
}) {
return (

{children}

);
}
`

$3

`tsx
// app/[lang]/page.tsx
import { getTranslation } from "@/i18n";

export default async function Page() {
const { t } = await getTranslation();

return

{t("home.title")}

;
}
`

API

$3

Creates configured i18n functions. Call once and export the returned functions.

`ts
import { initialize } from "@nimpl/i18n/initialize";

export const { getTranslation, ServerTranslation, Transmitter, revalidate } = initialize(config);
`

#### Config Options

| Option | Type | Required | Description |
|--------|------|----------|-------------|
| load | (language: string) => Promise