Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
// i18n bootstrap for `@spree/dashboard`.
//
// 1. The side-effect import below initializes i18next with the framework's
// base translation namespace (`admin.actions.*`, `admin.common.*`,
// `admin.fields.<simple>.*`, etc.) shipped in `@spree/dashboard-core`.
// 2. We then merge the app's resource bundle (`admin.nav.*`, resource pages,
// integrations) so callers can `t('admin.nav.orders')` alongside
// `t('admin.actions.save')` from the same namespace.
//
// Plugin authors follow the same pattern from their entry module:
//
// import { i18n } from '@spree/dashboard-core'
// import myEn from './locales/en.json'
// i18n.addResourceBundle('en', 'translation', myEn.admin, true, true)
//
// `deep: true` + `overwrite: true` merge nested objects without dropping
// keys the framework already provided; plugin keys win on collision.
import { i18n, localesFromBundlePaths, setUiLocales } from '@spree/dashboard-core'
import en from './locales/en.json'
i18n.addResourceBundle('en', 'translation', en, true, true)
// All non-English app bundles, imported EAGERLY so the active one can be
// registered synchronously at module-load — before any table/registry module
// evaluates its `i18n.t(...)` labels. (We reload the page on language change,
// so only the booted language's labels ever need to be resolved; eager keeps
// that resolution synchronous and flash-free. ~19 KB gz per locale.)
const appLocales = import.meta.glob<{ default: Record<string, unknown> }>(
['./locales/*.json', '!./locales/en.json'],
{ eager: true },
)
function codeFromPath(path: string): string {
return path.replace('./locales/', '').replace('.json', '')
}
// Register every app bundle up front so a switched/booted language resolves
// synchronously. (Core bundles are registered the same way in dashboard-core.)
// `lib/i18n.ts` already set the initial `lng` from localStorage, so the booted
// language's resources are present here before any table/registry module
// evaluates its `i18n.t(...)` labels.
for (const [path, mod] of Object.entries(appLocales)) {
i18n.addResourceBundle(codeFromPath(path), 'translation', mod.default, true, true)
}
setUiLocales(getAvailableUiLocales().map(({ code }) => code))
/**
* Admin UI languages the dashboard can display, as `{ code, name }` pairs for
* the language picker. Derived from the shipped locale bundles, not the API.
*/
export function getAvailableUiLocales(): Array<{ code: string; name: string }> {
return localesFromBundlePaths(Object.keys(appLocales))
}