aymericzip/intlayer-skills/intlayer-backend

Intlayer Backend Usage

Core Philosophy

Every backend integration works the same way:

1. A middleware / plugin (intlayer()) resolves the locale of each request (cookie, header, Accept-Language) and scopes it to that request.
2. Helpers (t, getIntlayer, getDictionary) read that request locale, so they are safe to call from services without threading a locale argument through every function.

Declare Content

File: src/index.content.ts

import { t, type Dictionary } from "intlayer";
const content = {
  key: "index",
  content: {
    exampleOfContent: t({
      en: "Example of returned content in English",
      fr: "Exemple de contenu renvoyé en français",
    }),
  },
} satisfies Dictionary;
export default content;

Usage

Register the middleware / plugin from the table above before the routes that read content (see the Express guide), then call the helpers in any handler:

import { t, getIntlayer, getDictionary } from "express-intlayer";
import dictionaryExample from "./index.content";
app.get("/", (_req, res) => {
  res.send(t({ en: "Hello", fr: "Bonjour" })); // Inline translation
});
app.get("/by-key", (_req, res) => {
  res.send(getIntlayer("index").exampleOfContent); // Dictionary by key
});
app.get("/by-import", (_req, res) => {
  res.send(getDictionary(dictionaryExample).exampleOfContent); // Imported dictionary
});

The same helpers are exported by fastify-intlayer, hono-intlayer and adonis-intlayer. On Elysia, read them from the route context: ({ intlayer }) => intlayer!.getIntlayer("index").

For jobs, queues or emails (no incoming request), resolve content for the recipient's stored locale: getIntlayer("index", user.locale).

References

• Website
• Doc

Environments

• Express
• Fastify
• Hono
• NestJS
• AdonisJS
• Elysia
• HTMX

Concepts

• Variants
• Collections

Packages

• Intlayer Exports
• Express Intlayer Exports
• Fastify Intlayer Exports
• Hono Intlayer Exports
• Adonis Intlayer Exports
• Elysia Intlayer Exports
• adonis-intlayer intlayer
• adonis-intlayer t
• elysia-intlayer intlayer
• express-intlayer intlayer
• express-intlayer t
• fastify-intlayer intlayer
• hono-intlayer intlayer
• hono-intlayer t