Skip to main content

Welcome to i18n-keyless

Install i18n-keyless in less than 5 minutes.

Get an API key by visiting https://i18n-keyless.com/#get-api-key

Using an AI assistant?

Three ways to hand your assistant the whole of i18n-keyless:

  • /llms.txt — the whole documentation as one Markdown file. Paste it into Claude / ChatGPT / Cursor / etc.
  • SKILL.md — an Agent Skill for Claude Code. Copy skills/i18n-keyless/ into your project's .claude/skills/. It also ships inside i18n-keyless-react and i18n-keyless-node, so an agent finds it in node_modules once you install.
  • Context7 — add use context7 to your prompt if you run the Context7 MCP server.

Getting Started​

Choose your platform below to see the setup instructions:

Storage is required to cache translations.

npm install i18n-keyless-react
import * as I18nKeyless from "i18n-keyless-react";

I18nKeyless.init({
  API_KEY: "YOUR_API_KEY",
  storage: window.localStorage,
  languages: {
    primary: "fr",
    supported: ["en", "fr"],
  },
});

You can check here for the methods that your storage item needs to have

Usage​

Once you've initialized i18n-keyless for your platform, you can start translating text immediately:

import { I18nKeylessText, useTranslation, getTranslation } from "i18n-keyless-react";
import { TabBar, Tab } from "whatever-tab-bar-system";

// Three ways to get text: `I18nKeylessText` component / `useTranslation` hook / `getTranslation` function

// `I18nKeylessText` component
function Header() {
  return (
    <h1><I18nKeylessText>Bonjour le monde</I18nKeylessText></h1>
  );
}

// `useTranslation` hook — inside a component, for a prop that needs a plain string
function MyTabs() {
  const first = useTranslation("Premier onglet");
  const second = useTranslation("Deuxième onglet");
  return (
    <TabBar>
      <Tab label={first} />
      <Tab label={second} />
    </TabBar>
  );
}

// `getTranslation` function — outside a component: a route loader, a utility
export const loader = () => ({ title: getTranslation("Premier onglet") });