Skip to main content

​
.transloom.json

Created automatically by transloom init in your project root. 
{
  "apiKey": "tl_xxxxxxxxxxxx",
  "languages": ["en", "de", "fr"],
  "framework": "nextjs",
  "outputDir": "public/locales",
  "namespace": false,
  "ignore": ["node_modules", "dist", ".next", "build", "coverage", ".git"]
}

​
Fields

FieldTypeDescription
apiKeystringYour Transloom API key
languagesarrayLanguages to translate into — en is always the base
frameworkstring"nextjs" or "react"
outputDirstringWhere locale JSON files are written
namespacebooleanGroup keys by feature (auth.login) instead of flat (login)
ignorearrayFolders to skip during file discovery

​
Namespace Support

When namespace: true, keys are grouped by the feature/folder they come from. Without namespace (default): 
{
  "login": "Login",
  "signup": "Sign Up",
  "dashboard_title": "Dashboard"
}
With namespace: 
{
  "auth": {
    "login": "Login",
    "signup": "Sign Up"
  },
  "dashboard": {
    "title": "Dashboard"
  }
}
Namespaces are derived automatically from the file path: 
src/app/auth/page.tsx      → auth
src/app/dashboard/page.tsx → dashboard
src/components/Navbar.tsx  → navbar

​
Demo Key

Want to try Transloom without signing up? 
tl_demo_transloom_key
Use this as your apiKey to run up to 3 free scans.

​
Security

  • ✅ Your source code never leaves your machine
  • ✅ Only extracted text strings are sent to the server
  • ✅ API key authenticated on every request
  • ✅ All communication over HTTPS