Multi-locale applications

Serve translated UI and validation messages across locales.

App config

// config/app.ts
export default {
  locale: env('APP_LOCALE', 'en'),
  fallback_locale: env('APP_FALLBACK_LOCALE', 'en'),
  locales_path: 'lang',
  available_locales: ['en', 'de', 'fr'],
};

Publish locale files

pondoknusa lang:publish

Creates lang/en.json. Copy to lang/de.json, lang/fr.json, etc.

Views

<Lang key="messages.welcome" />

Lang facade resolves keys from JSON locale files. See Support utilities for Str helpers.

Missing keys

pondoknusa lang:missing

Reports keys used in views but absent from locale files — useful in CI.

HTTP locale switching

Set locale per request in middleware:

import { Lang } from '@pondoknusa/core';

Lang.setLocale(request.headers.get('Accept-Language')?.split(',')[0] ?? 'en');

Or derive from authenticated user preferences.

Factories

APP_FAKER_LOCALE in config/app.ts controls factory-generated sample text.