Comvi i18n
Comvi i18n is a small, framework-agnostic library for translating apps. The core (@comvi/core) is reactive and event-driven; framework packages (@comvi/vue, @comvi/react, @comvi/next, @comvi/nuxt, @comvi/solid, @comvi/svelte) wrap it with idiomatic bindings. Translations come from the Comvi platform — runtime fetch from the CDN, or build-time bundling via the CLI.
Start here
Section titled “Start here”Quick StartInstall, configure, and render a translated string in your framework of choice.
Features OverviewA catalog of what Comvi i18n can do — pluralization, tags, type safety, namespaces, plugins.
Compatibility & VersionsSupported framework, runtime, and Node versions for every @comvi/* package.
TroubleshootingFixes for the errors you actually hit — provider not found, hydration mismatch, CDN 403, and more.
Frameworks
Section titled “Frameworks”Vue 3Composables, components, and reactivity.
ReactHooks, providers, and rich-text rendering.
Next.jsApp Router, Server Components, and middleware.
NuxtModule, auto-imports, routing, and SSR.
SolidJSSignals, reactivity, and component patterns.
SvelteStores, context, and reactive bindings.
Vanilla JSDirect use of @comvi/core without a framework.
Features
Section titled “Features”Translation Functiont() / tRaw() — signatures, parameters, and return types.
Tag Interpolation... syntax for embedded components and links.
Pluralization & ICUPlural forms, gender select, ordinals, and nested expressions.
NamespacesLogical grouping of keys and on-demand loading.
Language SwitchingSwitch locales at runtime with full reactivity.
FormattingNumbers, dates, currency, and relative time via Intl.*.
Type SafetyCompile-time checks and autocomplete for translation keys.
Loading TranslationsStatic, import map, custom loader, or CDN strategies.
Error HandlingonError, onMissingKey, onLoadError, and event hooks.
TroubleshootingSymptom → cause → fix for the common errors during setup.
Server-Side RenderingPre-load on the server, hydrate cleanly on the client.
Plugins
Section titled “Plugins”Plugins OverviewPlugin lifecycle and how the official plugins fit together.
Fetch LoaderLoad translations from the Comvi CDN or API.
Locale DetectorDetect and persist the user's preferred locale.
In-Context EditorInline translation editing in a browser preview.
Vite PluginGenerate strict TS types from local translation JSON at build/dev time.
Custom PluginsWrite your own plugin against the i18n lifecycle hooks.
API Reference
Section titled “API Reference”@comvi/coreThe framework-agnostic foundation.
@comvi/vueVue 3 composables and components.
@comvi/reactReact hooks and provider.
@comvi/nextNext.js setup, server helpers, and middleware.
@comvi/nuxtNuxt module config and auto-imports.
@comvi/solidSolidJS primitives and component bindings.
@comvi/svelteSvelte stores and component bindings.