v0.1 alpha released

Translations as codefor product teams

Git-native i18n and l10n management.

Declare messages, build datafiles, and consume with SDKs.

my-messagevisor-project

description: Greeting shown on home page
translations:
  en: "Welcome {name}!"
  ja: "ようこそ、{name}！"
  nl: "Welkom {name}!"
# (optional) conditional overrides
overrides:
  - segments: pro-subscribers
    translations:
      en: "Welcome pro subscriber {name}!"
      ja: "プロサブスクライバー{name}さん、ようこそ！"
      nl: "Welkom pro abonnee {name}!"

my-app

index.js

import { createMessagevisor } from '@messagevisor/sdk'
import { createICUModule } from '@messagevisor/module-icu'
const m = createMessagevisor({
  datafile,
  modules: [createICUModule()],
})
m.translate('ui.greeting', { name: 'Ada' })
// → 'Welcome Ada!'
m.setContext({ plan: 'pro' })
m.translate('ui.greeting', { name: 'Ada' })
// → 'Welcome pro subscriber Ada!'

Quick install

terminal

npx @messagevisor/cli init

GitOps philosophy

Treat translations like infrastructure

Messagevisor is a translation workflow system, not just a runtime library.
Author, review, test, and deploy copy the same way you ship code.

Read about GitOps approach →Translations as code

Author translation definitions in Git and connect to GitHub

Author in Git

Locales, messages, segments, and targets live as definitions. Every change is versioned and reviewable.

Learn more

Build datafiles and publish to your cloud or CDN

Build and upload to CDN

Run the CLI in CI to validate, test, and generate compact JSON datafiles, then upload them to your CDN or custom server.

Learn more

Evaluate translations at runtime with context and overrides

Consume with SDKs

Load datafiles in your app. Segment overrides, ICU formatting, and context resolve at runtime without redeploying.

Learn more

How it works

One repo. Full translation workflow.

Messagevisor keeps all your definitions for messages, their translations, and locale specific formatting configurations in Git.

Git-based toolkit

Translations in your repository

Locales, messages, segments, attributes, and targets live as structured definition files in your Git repository.

Review changes in pull requests, run tests in CI, and ship compact JSON datafiles. No external TMS required.

Open SourceMIT License

Declarative authoring

Author in YAML, JSON, or plug in a custom parser. The project model stays the same regardless of file format.

YAMLJSONTOML...

translations:
  en: "Sign in"
  nl: "Inloggen"

CLI toolkit

Lint, test, and build from the command line. Validate definitions and compile runtime datafiles (pure JSON files).

$ messagevisor lint

✓ structure validated

$ messagevisor build

✓ web-en.json (14 kB)

Locales & inheritance

Regional variants inherit from base locales. RTL, number, and date formats built in.

enen-USnl-NL...

Linear promotions with sets

Dev, staging, and production trees in one repo. Promote translations incrementally.

devstagingproduction

Datafiles

Compact JSON per target and locale, ready for CDN delivery.

messagevisor-web-en.json

14 kB

Namespaces

Folder paths in Git map to dotted message keys automatically.

messages/app/nav/header.yml

→app.nav.header

Overrides & A/B tests

Vary copy by platform, region, or segment. Logic lives in definitions, not app code.

webiospremium

Testing

Validate specs in CI before you build or deploy.

✓ 42 assertions passed

Framework & SDK integrations

A tiny ~5kB SDK with first-class integrations for the frameworks you already use. Native SDKs for iOS and Android are coming soon.

Project catalog

A visual layer over yourtranslation definitions

The catalog is a browsable view of your Messagevisor project. Run it locally or export a static build in CI for teammates who prefer a UI over definitions.

Messagevisor catalog showing the account.orderStatus message with translations across de-DE, en, en-GB, en-US, and nl-NL locales — Explore the catalog docs →
`npx messagevisor catalog` to run locally

Translation workflow

Export, translate, import

Hand translation work to someone outside Git without giving up review, linting, or tests. Export a CSV from the CLI, fill in the target locales, then import the results back into your project.

Who does the translating?

Human path

Human translators

Send a CSV to freelancers, agencies, or in-house specialists. They can work in Excel, Google Sheets, or any spreadsheet tool. No Git access required.

Learn about translator handoff →

AI path

AI agents

Let an agent drive the round trip. Export the CSV, fill locales while preserving ICU syntax and placeholders, then import back through the CLI.

Learn about AI translations →

Deploy anywhere

Cloud-native by design

Bring your own CI/CD pipeline and CDN, and translations ship to the edge alongside your app, with no extra infrastructure.

CI/CD Pipelines

GitHub

GitLab

BitBucket

Jenkins

builds & uploads

Cloud & CDN

Cloudflare

Amazon Web Services

Google Cloud

Microsoft Azure

Real world scenarios

Use cases that fit your needs

From shipping copy independently to scaling across brands and environments. Patterns product teams reach for every day.

Ship independently

Decouple releases from deployments

Ship translation updates without redeploying your apps. Rebuild datafiles and publish to your CDN.

$ messagevisor build

✓ web-en.json (14 kB)

→ upload to CDN

Establishing ownership

Assign namespace ownership to teams. Stay aligned through structured pull request reviews.

messages/checkout/ @payments-team

Audience-targeted copy variants

Personalize for premium users, cohorts, or onboarding flows using segment overrides.

segments: premium-users

A/B test your copy

Run copy experiments by targeting translation variants at defined user segments.

variant Avariant B

Managing regional variants

Handle en-US vs en-GB, pt-BR vs pt-PT, and more with locale inheritance and overrides.

enen-USen-GB...

Locale formatting

Consistent formatting across locales

Define number, date, and currency formats once per locale. ICU support built in.

{amount, number, currency}{date, date, medium}

ICU MessageFormat

Deprecating message keys

Mark keys as deprecated with a migration path. Teams clean up at their own pace.

deprecated: true

Multi-brand & multi-product

Host multiple brands or products in one repo. Share common translations across Sets.

brand-ashared

Onboarding non-engineers

Translators submit Pull Requests via GitHub's web UI. No CLI or local setup required. Otherwise handoff translations as CSVs.

Edit→Pull Request→Merge

Environment promotion

Promoting through environments

Stage in development, validate in staging, promote to production with one CLI command.

$ messagevisor promote

stagingproduction

✓ promoted

RTL language support

Add Arabic, Hebrew, or other RTL locales without reworking your application layout.

ar · direction: rtl

Ready to ship?

Start managing translations like a team

Messagevisor is free, open source, and works with your existing Git workflow. No vendor accounts, no lock-in. Just bring your translations in as definitions.

Open source
MIT licensed
No vendor lock-in

Read the docs →Star on GitHub

Frequently asked questions

Everything you need to know about Messagevisor.