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 Start Install, configure, and render a translated string in your framework of choice.
Features Overview A catalog of what Comvi i18n can do — pluralization, tags, type safety, namespaces, plugins.
Compatibility & Versions Supported framework, runtime, and Node versions for every @comvi/* package.
Troubleshooting Fixes for the errors you actually hit — provider not found, hydration mismatch, CDN 403, and more.
Frameworks
Section titled “Frameworks” Vue 3 Composables, components, and reactivity.
React Hooks, providers, and rich-text rendering.
Next.js App Router, Server Components, and middleware.
Nuxt Module, auto-imports, routing, and SSR.
SolidJS Signals, reactivity, and component patterns.
Svelte Stores, context, and reactive bindings.
Vanilla JS Direct use of @comvi/core without a framework.
Features
Section titled “Features” Translation Function t() / tRaw() — signatures, parameters, and return types.
Tag Interpolation ... syntax for embedded components and links.
Pluralization & ICU Plural forms, gender select, ordinals, and nested expressions.
Namespaces Logical grouping of keys and on-demand loading.
Language Switching Switch locales at runtime with full reactivity.
Formatting Numbers, dates, currency, and relative time via Intl.*.
Type Safety Compile-time checks and autocomplete for translation keys.
Loading Translations Static, import map, custom loader, or CDN strategies.
Error Handling onError, onMissingKey, onLoadError, and event hooks.
Troubleshooting Symptom → cause → fix for the common errors during setup.
Server-Side Rendering Pre-load on the server, hydrate cleanly on the client.
Plugins
Section titled “Plugins” Plugins Overview Plugin lifecycle and how the official plugins fit together.
Fetch Loader Load translations from the Comvi CDN or API.
Locale Detector Detect and persist the user's preferred locale.
In-Context Editor Inline translation editing in a browser preview.
Vite Plugin Generate strict TS types from local translation JSON at build/dev time.
Custom Plugins Write your own plugin against the i18n lifecycle hooks.
API Reference
Section titled “API Reference” @comvi/core The framework-agnostic foundation.
@comvi/vue Vue 3 composables and components.
@comvi/react React hooks and provider.
@comvi/next Next.js setup, server helpers, and middleware.
@comvi/nuxt Nuxt module config and auto-imports.
@comvi/solid SolidJS primitives and component bindings.
@comvi/svelte Svelte stores and component bindings.