NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2668 most downloaded on Packagist
Exposes Symfony Translations directly to JavaScript.
Latest stable
v3.7.0
Last release 18 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 4 weeks
Some releases are documented
notes for 23 of 53 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
53 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
bug #4141 Don't load the routes and translations when the container is built (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v3.6.0...v3.7.0)
.gitignore, and ignore the .vitest/ report directory (@Kocal)defaultLocale option to createTranslator(), and export the application default locale as defaultLocale in the dumped translationsminor #4086 Update the tooling dependencies (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v3.5.0...v3.6.0)
ux:translator:warm-cache writing empty translations (@Kocal)symfony/asset-mapper 8.2 and later (@Kocal)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
feature #3867 Detect the standalone AssetMapper bundle (@smnandre)
Changelog (https://github.com/symfony/ux-translator/compare/v3.4.0...v3.5.0)
AssetMapperBundleminor #3735 Add sync-packages.php to normalize packages .gitattributes (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v3.3.0...v3.4.0)
Changelog (https://github.com/symfony/ux-translator/compare/v3.2.0...v3.3.0) * no significant changes
Changelog (https://github.com/symfony/ux-translator/compare/v3.2.0...v3.3.0)
Changelog (https://github.com/symfony/ux-translator/compare/v3.1.0...v3.2.0) * no significant changes
Changelog (https://github.com/symfony/ux-translator/compare/v3.1.0...v3.2.0)
feature #3601 Add uxwarm-cache command (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v3.0.0...v3.1.0)
ux:translator:warm-cache command (@Kocal)ux:translator:warm-cache console command to manually dump JS/TS translation filesfeature #3453 Update minimum required Symfony version to 7.4 (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v2.34.0...v3.0.0)
Changelog (https://github.com/symfony/ux-translator/compare/v2.35.0...v2.36.0) * no significant changes
Changelog (https://github.com/symfony/ux-translator/compare/v2.35.0...v2.36.0)
Changelog (https://github.com/symfony/ux-translator/compare/v2.34.0...v2.35.0) * no significant changes
Changelog (https://github.com/symfony/ux-translator/compare/v2.34.0...v2.35.0)
bug #3401 Update package.json to 2.33.0 (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v2.33.0...v2.34.0)
2.33.0 (@Kocal)feature #3362 Migrate from tsup (deprecated) to tsdown (@Kocal)
Changelog (https://github.com/symfony/ux-translator/compare/v2.32.0...v2.33.0)
Extension from DependencyInjection instead of HttpKernel (@Kocal)repository issue (@Kocal)Note: This is a breaking change, but the UX Translator component is still experimental.
[BC BREAK] Refactor API to use string-based translation keys instead of generated constants.
Translation keys are now simple strings instead of TypeScript constants. The main advantages are:
Before:
import { trans } from '@symfony/ux-translator';
import { SYMFONY_GREAT } from '@app/translations';
trans(SYMFONY_GREAT);
After:
import { createTranslator } from '@symfony/ux-translator';
import { messages } from '../var/translations/index.js';
const { trans } = createTranslator({ messages });
trans('symfony.great');
The global functions (setLocale, getLocale, setLocaleFallbacks, getLocaleFallbacks, throwWhenNotFound)
have been replaced by a new createTranslator() factory function that returns an object with these methods.
Tree-shaking: While tree-shaking of individual translation keys is no longer possible, modern build tools,
caching strategies, and compression techniques (Brotli, gzip) make this negligible in 2025.
You can use the keys_patterns configuration option to filter dumped translations by pattern
for further reducing bundle size.
For AssetMapper users: You can remove the following entries from your importmap.php:
'@app/translations' => [
'path' => './var/translations/index.js',
],
'@app/translations/configuration' => [
'path' => './var/translations/configuration.js',
],
Note: This is a breaking change, but the UX Translator component is still experimental.
[BC BREAK] Refactor TranslationsDumper to accept configuration options via dump() method parameters,
instead of constructor arguments or method calls:
$dumpDir and $dumpTypeScript constructor argumentsTranslationsDumper::addIncludedDomain() and TranslationsDumper::addExcludedDomain() methodsNote: This is a breaking change, but the UX Translator component is still experimental.
Add configuration ux_translator.dump_typescript to enable/disable TypeScript types dumping,
default to true. Generating TypeScript types is useful when developing,
but not in production when using the AssetMapper (which does not use these types).
Add keys_patterns configuration option to filter dumped translations by key patterns (e.g., app.*, !*.internal)
Nothing published for this version
Ensure compatibility with PHP 8.5
Nothing published for this version
Nothing published for this version
- Add Symfony 8 support
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support both the Symfony format (fr_FR) and W3C specification (fr-FR) for locale subcodes.
fr_FR) and W3C specification (fr-FR) for locale subcodes.Nothing published for this version
Add throwWhenNotFound function to configure the behavior when a translation is not found.
throwWhenNotFound function to configure the behavior when a translation is not found.Nothing published for this version
Add configuration to filter dumped translations by domain.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Increase version range of intl-messageformat to ^10.5.11, in order to see a faster implementation of ICU messages parsing. #1443
intl-messageformat to ^10.5.11, in order to see
a faster implementation of ICU messages parsing. #1443Nothing published for this version
Nothing published for this version
Nothing published for this version
Revert "Change JavaScript package to type: module"
type: module"Change JavaScript package to type: module
type: moduleNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support for symfony/asset-mapper
Nothing published for this version
- Component added
One column per quarter.