Changelog · Verbaly

0.23.02026-07-14

Latest release

One <Trans> everywhere, live extraction and a coverage view

The React, Vue and Svelte components now share the same props and the same rendering rules, the CLI learns two everyday commands, and the last planned breaking changes land before 1.0.

Highlights

<Trans> is now the same component in React, Vue and Svelte: same props, same rendering rules. Your custom component wins, then named links, then the safe tag whitelist; anything unknown degrades to plain text.
Breaking: React and Vue <Trans> now render whitelisted tags like em and code as real elements, matching Svelte and the DOM interpreter. Pass an empty richTags list to keep the old flatten-to-text behavior.
Breaking: @verbaly/svelte now requires Svelte 5. In exchange <Trans> gains the components prop: map a tag in a message to your own component. On Svelte 4, stay on 0.22.0.
verbaly status shows how much is left to translate, one line per language, without failing anything. verbaly check stays the build gate.
verbaly extract --watch keeps catalogs and types in sync as you code, made for webpack, Rspack and Rollup setups where the Vite plugin is not available.
Easier to give feedback: the README points bug reports and friction reports to the right place, and the issue forms cover all ten packages.

Full release notesEvery bullet, per package, in the repo changelog.

0.22.02026-07-14

Release

Your catalogs become native mobile resources

The export command learns two mobile formats: Android resource folders and iOS string files. A web app and its mobile companion can now share one set of translations.

Highlights

Export your translations for mobile apps: verbaly export --format android-xml writes folders you can drop into res/, and --format ios-strings writes .lproj folders for Xcode.
Sensible defaults for each platform: your source language becomes the platform default, and untranslated keys are left out so the app falls back to it instead of showing empty text.
Safer catalog files: a catalog with broken JSON now stops the command and names the file, instead of being silently read as empty. A Windows BOM at the start of the file is simply tolerated.

Full release notesEvery bullet, per package, in the repo changelog.

0.21.02026-07-14

Release

A quality pass, and typed Nuxt config

A cleanup sweep across all ten packages, plus fully typed options in your Nuxt config. The internals got tidier and a little smaller, with no change to how you write Verbaly.

Highlights

The verbaly key in nuxt.config.ts is now fully typed: you get autocomplete and typo checking, and the module still adds no extra dependency.
A calmer editor in dev. verbaly.d.ts is only rewritten when its contents actually change, so your TypeScript server stops reloading types on every save.
A slightly smaller runtime: the tree-shaken core is now 3.28 KB gzipped, down from 3.30.
Cleaner generated types: a value used as both a date and plain text no longer shows up twice in verbaly.d.ts.
Clearer command-line messages. Every error and hint reads in plain words, and check now prints the source text right next to the missing key.

Full release notesEvery bullet, per package, in the repo changelog.

0.20.02026-07-13

Release

Write your text in .svelte and .vue files too

Natural text now works inside Svelte and Vue components: write it in the file, script or markup, and the compiler extracts it with a stable key and typed params.

Highlights

Write t`Hello ${name}` directly in a .vue template or {$t`Hello ${name}`} in .svelte markup. The compiler picks it up like it always did in .ts files: stable key, typed params, per-locale catalogs.
Svelte's store form is understood: $t`…`, $t('key') and $t.id('key')`…` all work anywhere in a .svelte file.
Live in dev, gated in build: save a component with new text and the catalogs plus verbaly.d.ts update on the spot. Missing translations still stop the build.
Readable keys and runtime keys work in markup too: t.id('home.title')`…` extracts under your key, and t('key') calls count as used keys for check and prune.
verbaly extract scans more by default: .svelte and .vue files, plus the app/ folder next to src/ (where Nuxt 4 and the Next.js App Router live). Your own include config still wins.

Full release notesEvery bullet, per package, in the repo changelog.

0.19.02026-07-13

Release

Next.js joins the family: the cycle is complete

The last big meta-framework integration. Next.js App Router pages render already translated, hydrate without a flash, and work on both Turbopack and webpack.

Highlights

New package @verbaly/next. Two steps: wrap your config with withVerbaly() in next.config.ts and drop <VerbalyProvider> into the root layout. Server Components translate with await getT(); Client Components keep using useT and <Trans> as in any React app.
Works on Turbopack (the Next 16 default) and on webpack. next dev extracts your messages as you type, and next build stops if a translation is missing.
Every visitor gets their own language, resolved once per request from their cookie or browser preferences. Pages arrive already translated, nothing flashes, and concurrent visitors never see each other’s language.
useSwitchLocale() changes the language instantly, remembers the choice for the next visit, and updates Server Components too.
Rich messages can now display literal markup, so a message can show "<html lang>" as visible text instead of a broken escape.

Full release notesEvery bullet, per package, in the repo changelog.

0.18.02026-07-13

Release

Nuxt joins the family

The second meta-framework integration: a zero-config Nuxt module renders every page in the visitor’s language and hydrates without a flash.

Highlights

New package @verbaly/nuxt. One line in your config (modules: ['@verbaly/nuxt']) wires everything: live extraction, per-visitor language, and hydration with the same locale and catalog the server used. No flash, no mismatch.
No framework lock: the module depends on neither nuxt nor @nuxt/kit, and it is verified against a real Nuxt 4 app.
switchLocale() is now a core export shared by SvelteKit, Nuxt and hand-rolled setups. It loads the catalog first and switches after, so nothing flashes. Existing imports keep working.
Client-only apps are covered too: with ssr: false the module still picks the right language in the browser.
Support Verbaly: GitHub Sponsors is live at github.com/sponsors/AronSoto.

Full release notesEvery bullet, per package, in the repo changelog.

0.17.02026-07-11

Release

Robust inside, for real

The hardening release: a full audit of all eight packages fixed every sharp edge it found, and SSR gets its missing piece.

Highlights

Attribute translation is now XSS-safe end to end: data-verbaly-attr sanitizes URL attributes and blocks style and srcdoc entirely, so a compromised catalog can’t inject scripts.
t() never crashes on bad format arguments: an invalid currency code, date or time style warns once and renders the plain value.
createRequestInstance(locale) in virtual:verbaly: the SSR per-request pattern in one call, with the catalog already loaded and no flash.
The CLI now rejects misplaced flags. verbaly translate --locale es used to silently translate all locales; now it errors and suggests --locales. Plus --dry-run for extract --prune.
normalizeLink() and resolveRequestLocale() now live once in core, shared by every adapter and SSR integration.
Breaking: instance.inspect(key) now returns { from, source } instead of { locale, source }: one name for one concept across the observability API.

Full release notesEvery bullet, per package, in the repo changelog.

0.16.02026-07-11

Release

Server-side rendering, for real

The first meta-framework integration: SvelteKit pages render in the visitor’s language on the server and hydrate without a flash.

Highlights

New package @verbaly/sveltekit. SSR in three wires: verbalyHandle() in your server hooks, one +layout load, and %verbaly.lang% in app.html. Pages arrive translated.
The language is decided per request: cookie first, then the Accept-Language header (es-PE matches es), then your fallback. Concurrent requests never leak each other’s language.
switchLocale(): a client-side switch that loads the catalog first, then saves the choice in the cookie the server reads.
negotiateLocale() in core: the Accept-Language matcher is a public export any Node server can use.
createInstance() in virtual:verbaly: fresh request-scoped instances over your compiled catalogs, plus locales and sourceLocale exports.

Full release notesEvery bullet, per package, in the repo changelog.

0.15.02026-07-10

Release

Your translators can work now

The write→ship cycle opens up to humans: export translator-ready files, import them back validated.

Highlights

verbaly export writes one translator-ready file per locale: XLIFF 2.0 for translation platforms, CSV for spreadsheets. --missing exports only what’s left to translate.
verbaly import validates every entry: a translation that drops a placeholder, a variant or a tag is rejected and reported.
Existing translations are kept unless you pass --overwrite, and --dry-run previews the whole import.
No translation platform needed: catalogs are plain JSON, and Crowdin, Lokalise and Phrase read it natively.

Full release notesEvery bullet, per package, in the repo changelog.

0.14.52026-07-10

Release

Revision of 0.14.0: the review release

A hard audit of what 0.14.0 shipped found three real defects. All fixed here.

Highlights

The verbaly/devtools overlay no longer freezes the page: its observer now ignores its own writes.
"" now means untranslated everywhere: the runtime falls back instead of rendering a blank hole.
Locale mirrors get self-canonical rel="canonical" and og:url, so the hreflang set finally counts.

Full release notesEvery bullet, per package, in the repo changelog.

0.14.02026-07-10

Release

Ships translated, and you can see why

Multi-locale SEO for the static renderer, runtime observability, hardened server-side use.

Highlights

verbaly render emits reciprocal hreflang alternates and an i18n sitemap: set render.baseUrl and go.
Opt-in verbaly/devtools: hover any element to see its key, status and source locale.
New onResolve hook + inspect(key), with zero cost when unused.
Server-side Node use hardened and locked with tests.

Full release notesEvery bullet, per package, in the repo changelog.

0.13.12026-07-10

Release

README refresh: readable on npm dark mode

Docs-only patch; first release published from CI with npm provenance.

Highlights

The seven package READMEs are readable on npm’s dark theme and friendlier to skim.
MIT re-affirmed; releases now ship with npm provenance from the automatic workflow.

Full release notesEvery bullet, per package, in the repo changelog.

0.13.02026-07-09

Release

verbaly doctor + adoption & trust

One command answers “why isn’t this translating?”, and a real path off i18next.

Highlights

verbaly doctor inspects config, catalogs, plugin wiring, stale types and orphan keys, and gives each finding its exact fix.
New Migrate from i18next guide: keep your keys and JSON, swap the runtime page by page.
Publishing moves to GitHub Actions with npm provenance: every package is publicly linked to its commit.

Full release notesEvery bullet, per package, in the repo changelog.

0.12.02026-07-09

Release

verbaly init + the TypeScript 7 toolchain

From zero to translating in one command; the build moves to tsdown and native TS 7.

Highlights

verbaly init scaffolds config + catalogs and detects your bundler. It never overwrites.
Toolchain: tsup → tsdown; typecheck on native TypeScript 7 (~10× faster). No consumer-visible change.

Full release notesEvery bullet, per package, in the repo changelog.

0.11.02026-07-08

Release

Rich links + the full modern Intl surface

Named links with hrefs that never come from catalogs, and the last missing Intl formatters.

Highlights

Named links in rich messages render real <a> elements. The href comes from your code, never the catalog, and unsafe schemes are blocked.
Relative time ({when:relative}), lists ({xs:list}) and CLDR units ({n:unit/kilometer}): all native Intl, zero dependencies.
License: Apache-2.0 → MIT across all seven packages.

Full release notesEvery bullet, per package, in the repo changelog.

0.10.02026-07-07

Release

Static sites ship translated + Verbaly beyond Vite

The FOUC dies on SSG, and webpack/Rollup/esbuild/Rspack join via unplugin.

Highlights

verbaly render pre-fills your built HTML per locale with the real runtime, so static pages ship already translated.
New @verbaly/unplugin: the same virtual modules + build gate on webpack 5, Rollup, esbuild and Rspack.
verbaly pseudo: a QA locale (⟦Ĥéĺĺó ~⟧) that exposes hardcoded strings and clipped layouts.
<Trans> lands in Svelte.

Full release notesEvery bullet, per package, in the repo changelog.

0.9.02026-07-06

Release

Machine translation closes the loop

write → extract → translate → check green: the whole cycle in one tool.

Highlights

verbaly translate fills the "" holes check reports: batched, with --dry-run and per-locale filters.
Structural validation: placeholders, variants and tags must survive verbatim or the translation is rejected.
Pluggable providers: Claude as the reference, and any (messages) => translations function works. Zero runtime impact.

Full release notesEvery bullet, per package, in the repo changelog.

0.8.02026-07-06

Release

Readable keys + lazy catalogs

Human-readable ids when you want them, per-locale lazy loading when you need it.

Highlights

t.id('inbox.title')`Hello ${name}`: readable, namespaced keys; hashed stays the zero-config default.
loaders in createVerbaly: bundle only the source locale and load the rest on demand, flash-free with await loadLocale.

Full release notesEvery bullet, per package, in the repo changelog.

0.7.02026-07-04

Release

Svelte joins the ecosystem

Idiomatic stores over the same reactive core, for Svelte 4 & 5.

Highlights

@verbaly/svelte: $t('key') re-renders on locale switch, and bind:value={$locale} just works.
Context via provideVerbaly/useVerbaly or store factories without a component tree.

Full release notesEvery bullet, per package, in the repo changelog.

0.6.02026-07-04

Release

The compiler understands your whole codebase

Write JSX in place and the compiler extracts it.

Highlights

<Trans> write-in-place extraction: source text with real elements becomes key + components automatically.
verbaly.config.ts / .mts support (esbuild as optional peer).

Full release notesEvery bullet, per package, in the repo changelog.

0.5.02026-07-04

Release

Hardening + performance, with receipts

Benchmarks vs i18next run on every release from here on.

Highlights

Hot path memoized end to end: lookup 31×, interpolation 10×, plurals 5× vs i18next.
Defensibility audit: cached fallback chains, per-element DOM args, capped AST cache.

Full release notesEvery bullet, per package, in the repo changelog.

0.4.02026-07-04

Release

The DOM interpreter catches up

Rich text in plain HTML, safely, plus locale bootstrap helpers.

Highlights

data-verbaly-rich: tagged messages render real elements from a phrasing whitelist, never innerHTML.
resolveLocale / persistLocale: storage → navigator → fallback, SSR-safe.

Full release notesEvery bullet, per package, in the repo changelog.

0.3.02026-07-03

Release

ICU escape-hatch + robustness

Bring your ICU strings: auto-detected, zero dependencies.

Highlights

ICU MessageFormat (plural, select, selectordinal) parses into the same engine, opt-in per message.
Hardened <Trans> tokenizer + build-time key-collision warnings.

Full release notesEvery bullet, per package, in the repo changelog.

0.2.02026-07-03

Release

Ecosystem public + rich text

First npm publish of the ecosystem packages.

Highlights

@verbaly/compiler, @verbaly/vite, @verbaly/react and @verbaly/vue land on npm, version-aligned.
<Trans> in React and Vue: interpolate elements inside translated sentences with named tags.

Full release notesEvery bullet, per package, in the repo changelog.

0.1.02026-07-02

Release

The first release

The core idea, working: write text, ship translations.

Highlights

Runtime: message format over native Intl, reactive locale store, DOM interpreter, type-level keys and params.
Compiler: AST extraction of t`…` into stable hashed keys, extract/check, typed verbaly.d.ts.
Vite plugin: live extraction, HMR, per-locale code-splitting, builds fail on missing translations.

Full release notesEvery bullet, per package, in the repo changelog.