npx @inlang/cli [command]

my-app/
├── project.inlang/
│   └── settings.json
├── messages/
│   ├── en.json          # Source language
│   └── de.json          # Translations
└── src/

{
  "$schema": "https://inlang.com/schema/project-settings",
  "baseLocale": "en",
  "locales": ["en", "de", "fr"],
  "modules": [
    "https://cdn.jsdelivr.net/npm/@inlang/plugin-json@latest/dist/index.js"
  ],
  "plugin.inlang.json": {
    "pathPattern": "./messages/{locale}.json"
  }
}

{
  "greeting": "Hello {name}!",
  "welcome": "Welcome to our app"
}

npx @inlang/cli machine translate [options]

npx @inlang/cli validate --project ./path/to/project.inlang

npx @inlang/cli lint [options]

npx @inlang/cli plugin build --entry ./src/index.ts --outdir ./dist

npx @inlang/cli machine translate -f --project ./project.inlang
npx @inlang/cli validate --project ./project.inlang

{ "navbar": { "moreOptions": "More options" } }

// Internal variable is lowercased + dedup suffix
const navbar_moreoptions1 = ...
// But the PUBLIC export preserves the original dot-separated key
export { navbar_moreoptions1 as "navbar.moreOptions" }

import * as m from "@/paraglide/messages";

// ✅ CORRECT — original key with dots, bracket notation
m["navbar.moreOptions"]()
m["common.back"]()
m["auth.page.emailLabel"]()

// ❌ WRONG — underscore style does NOT exist as an export
m.navbar_moreOptions()    // Property does not exist
m.navbar_moreoptions1()   // Internal name, not exported

{
  "$schema": "https://inlang.com/schema/inlang-message-format",
  "navbar_share": "Share",
  "common_back": "Back"
}

npx @inlang/paraglide-js@latest init

// vite.config.ts
import { paraglideVitePlugin } from '@inlang/paraglide-js'

export default defineConfig({
  plugins: [
    paraglideVitePlugin({
      project: './project.inlang',
      outdir: './src/paraglide',
    }),
    // ... other plugins (tanstackRouter, react, etc.)
  ],
})

paraglideVitePlugin({
  project: './project.inlang',
  outdir: './src/paraglide',
  outputStructure: 'message-modules',
  cookieName: 'PARAGLIDE_LOCALE',
  strategy: ['url', 'cookie', 'preferredLanguage', 'baseLocale'],
  urlPatterns: [
    {
      pattern: '/',
      localized: [
        ['en', '/'],
        ['de', '/de'],
      ],
    },
    {
      pattern: '/about',
      localized: [
        ['en', '/about'],
        ['de', '/de/ueber'],
      ],
    },
    {
      pattern: '/:path(.*)?',
      localized: [
        ['en', '/:path(.*)?'],
        ['de', '/de/:path(.*)?'],
      ],
    },
  ],
})

{
  "$schema": "https://inlang.com/schema/project-settings",
  "baseLocale": "en",
  "locales": ["en", "de"],
  "modules": [
    "https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@4/dist/index.js",
    "https://cdn.jsdelivr.net/npm/@inlang/plugin-m-function-matcher@2/dist/index.js"
  ],
  "plugin.inlang.messageFormat": {
    "pathPattern": "./messages/{locale}.json"
  }
}

{
  "$schema": "https://inlang.com/schema/inlang-message-format",
  "example_message": "Hello world {username}",
  "home_page": "Home page",
  "about_page": "About page"
}

// src/main.tsx
import { createRouter } from '@tanstack/react-router'
import { deLocalizeUrl, localizeUrl } from './paraglide/runtime.js'

const router = createRouter({
  routeTree,
  rewrite: {
    input: ({ url }) => deLocalizeUrl(url),
    output: ({ url }) => localizeUrl(url),
  },
})

// src/routes/__root.tsx
import { redirect, createRootRoute } from '@tanstack/react-router'
import { getLocale, setLocale, locales, shouldRedirect } from '@/paraglide/runtime'
import { m } from '@/paraglide/messages'

export const Route = createRootRoute({
  beforeLoad: async () => {
    document.documentElement.setAttribute('lang', getLocale())
    const decision = await shouldRedirect({ url: window.location.href })
    if (decision.redirectUrl) {
      throw redirect({ href: decision.redirectUrl.href })
    }
  },
  component: () => (
    <>
      <Link to="/">{m.home_page()}</Link>
      <Link to="/about">{m.about_page()}</Link>
      {locales.map((locale) => (
        <button key={locale} onClick={() => setLocale(locale)}>
          {locale}
        </button>
      ))}
      <Outlet />
    </>
  ),
})

// server.ts
import { paraglideMiddleware } from './paraglide/server.js'
import handler from '@tanstack/react-start/server-entry'

export default {
  fetch(req: Request): Promise<Response> {
    return paraglideMiddleware(req, ({ request }) => handler.fetch(request))
  },
}

import { getLocale } from '../paraglide/runtime.js'

function RootDocument({ children }: { children: React.ReactNode }) {
  return (
    <html lang={getLocale()}>
      <head><HeadContent /></head>
      <body>
        {children}
        <Scripts />
      </body>
    </html>
  )
}

import { Locale } from '@/paraglide/runtime'
import { FileRoutesByTo } from '../routeTree.gen'

type RoutePath = keyof FileRoutesByTo

function toUrlPattern(path: string) {
  return path
    .replace(/\/\$/, '/:path(.*)?')           // catch-all
    .replace(/\{-\$([a-zA-Z0-9_]+)\}/g, ':$1?') // optional params
    .replace(/\$([a-zA-Z0-9_]+)/g, ':$1')       // named params
    .replace(/\/+$/, '')                          // trailing slash
}

function createTranslatedPathnames(
  input: Record<RoutePath, Record<Locale, string>>,
) {
  return Object.entries(input).map(([pattern, locales]) => ({
    pattern: toUrlPattern(pattern),
    localized: Object.entries(locales).map(
      ([locale, path]) => [locale as Locale, `/${locale}${toUrlPattern(path)}`],
    ),
  }))
}

export const translatedPathnames = createTranslatedPathnames({
  '/': { en: '/', de: '/' },
  '/about': { en: '/about', de: '/ueber' },
})

import { localizeHref } from './paraglide/runtime'

export const prerenderRoutes = ['/', '/about'].map((path) => ({
  path: localizeHref(path),
  prerender: { enabled: true },
}))

my-app/
├── project.inlang/
│   ├── settings.json
│   ├── project_id         # Auto-generated
│   └── .gitignore          # Contains: cache
├── messages/
│   ├── en.json
│   └── de.json
├── src/
│   ├── paraglide/          # Generated (gitignored)
│   │   ├── runtime.js
│   │   ├── messages.js
│   │   └── server.js       # SSR only
│   ├── routes/
│   │   ├── __root.tsx
│   │   ├── index.tsx
│   │   └── about.tsx
│   └── main.tsx
├── server.ts               # SSR only
└── vite.config.ts

{
  "recommendations": ["inlang.vs-code-extension"]
}

npm install -D @inlang/cli    # project-scoped (recommended)
yarn add --dev @inlang/cli     # yarn alternative

(api: (ctx: PlatePluginContext<AnyPluginConfig>) => any) => PlatePlugin<C>;

(api: (ctx: PlatePluginContext<AnyPluginConfig>) => any) => PlatePlugin<C>;

./tooling/scripts/list-translate-files.sh [days]

./tooling/scripts/list-translate-files.sh 153