better-i18n voor Bedrijven: Schaal Je Lokalisatie-infrastructuur
Wanneer je product in meerdere talen wordt uitgebracht, wordt lokalisatie infrastructuur — geen eenmalig project. Je hebt programmatische toegang nodig, CI/CD-integratie, consistente terminologie-handhaving en inzicht in wat vertaald is, wat in behandeling is en wat ontbreekt.
better-i18n is een API-first vertaalmanagementplatform ontworpen voor engineeringteams. Het biedt de bouwstenen — REST API, Content SDK, CLI-tools, MCP-server, CDN-distributie en GitHub-integratie — om lokalisatie een naadloos onderdeel van je ontwikkelworkflow te maken.
Wat Enterprise Teams Daadwerkelijk Krijgen
API-First Architectuur
Elke functie in better-i18n is beschikbaar via REST API. Je interne tools, CI-pipelines en aangepaste workflows kunnen programmatisch met het platform communiceren:
Vertaalmanagement API (dash.better-i18n.com/api):
| Operatie | Wat Het Doet |
|---|---|
| listKeys | Vertaalsleutels opvragen met zoek-, namespace- en statusfilters |
| createKeys | Sleutels aanmaken met brontekst en initiële vertalingen |
| updateKeys | Vertalingen bijwerken voor bestaande sleutels in meerdere talen |
| deleteKeys | Sleutels die niet meer in gebruik zijn tijdelijk verwijderen |
| listProjects | Alle projecten in je organisatie weergeven |
| getProject | Projectdetails ophalen inclusief talen en namespaces |
Content SDK (@better-i18n/sdk):
Een query builder in Supabase-stijl voor het ophalen van gelokaliseerde content-items:
import { createClient } from "@better-i18n/sdk";
const client = createClient({
project: "your-org/your-project",
apiKey: process.env.BETTER_I18N_CONTENT_API_KEY,
});
// Gepubliceerde blogposts in het Frans ophalen
const { data, total, hasMore } = await client
.from("blog-posts")
.eq("status", "published")
.language("fr")
.order("publishedAt", { ascending: false })
.limit(20);
De SDK is zero-dependency, volledig getypeerd in TypeScript en werkt in elke JavaScript-runtime.
CDN-distributie
Vertalingen worden geserveerd vanaf het edge-netwerk van Cloudflare op:
https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json
Levering in minder dan 100ms wereldwijd. Werk vertalingen bij in het dashboard of via de API, en ze zijn live op het CDN zonder je applicatie opnieuw te deployen.
GitHub-integratie
better-i18n synchroniseert met je repositories:
- Webhook-getriggerde synchronisatie — Push-events activeren updates van vertaalbestanden
- Pull request-workflow — Vertaalupdates worden als PR's aangeleverd die je zelf beheert
- Minimale rechten — Lees-/schrijftoegang alleen tot geconfigureerde vertaalbestandspatronen (bijv.
locales/**/*.json) - Volledige merge-controle — Jij bepaalt wanneer vertalingen in je codebase terechtkomen
CLI voor de Ontwikkelworkflow
De @better-i18n/cli integreert in je ontwikkelproces:
# Hardcoded strings detecteren in je React/Next.js-code
npx @better-i18n/cli scan --ci
# Lokale vertaalsleutels vergelijken met je cloudproject
npx @better-i18n/cli sync --format json
Voeg scan toe aan je pre-commit hooks of CI-pipeline. Gebruik sync om vertaaldekking te controleren voor releases.
MCP-server voor AI-ondersteund Vertalen
Twee MCP-servers verbinden je AI-tools rechtstreeks met je vertaalworkspace:
| Pakket | Tools | Doel |
|---|---|---|
| @better-i18n/mcp | 11 tools | Vertaalbeheer (sleutels, vertalingen, publicatie) |
| @better-i18n/mcp-content | 17 tools | Contentbeheer (modellen, items, gelokaliseerde content) |
Werkt met Claude, Cursor, Windsurf en elke MCP-compatibele AI-tool. Je AI-assistent kan sleutels aanmaken, vertalingen bijwerken en content beheren zonder de IDE te verlaten.
Beveiliging en Toegangscontrole
Infrastructuur
- Cloudflare Workers — Edge computing met ingebouwde DDoS-bescherming
- PlanetScale MySQL — Serverless database met automatische back-ups
- Cloudflare R2 — Objectopslag voor vertaalbestanden
Versleuteling
- In rust: AES-256-versleuteling
- Tijdens transport: TLS 1.3 voor alle verbindingen
Authenticatie
- Dashboard: GitHub OAuth (geen wachtwoorden opgeslagen)
- API: Bearer token-authenticatie met sleutels gehasht via bcrypt
- Sleutelbereik: API-sleutels kunnen beperkt worden tot specifieke projecten
- Sleutelbeheer: Directe intrekking vanuit het dashboard
Toegangscontrole
- Rolgebaseerde toegangscontrole (RBAC) op organisatie- en projectniveau
- Auditlogs voor alle gevoelige operaties
- Principe van minimale rechten voor alle interne toegang
Compliance
| Standaard | Status |
|---|---|
| GDPR | Compliant — Verwerkingsovereenkomsten beschikbaar, recht op verwijdering ondersteund, data-export op aanvraag |
| SOC 2 Type II | In uitvoering — we werken aan certificering |
Transparantienota: We zijn nog niet SOC 2 Type II-gecertificeerd. Onze infrastructuurproviders (Cloudflare, PlanetScale) beschikken over SOC 2 Type II- en ISO 27001-certificeringen. We hanteren beveiligingspraktijken die in lijn zijn met deze standaarden en werken aan onze eigen certificering. Zie onze beveiligingsdocumentatie voor gedetailleerde informatie.
Framework-ondersteuning
| Framework | Pakket | Kenmerken |
|---|---|---|
| Next.js (App Router & Pages) | @better-i18n/next | Server components, middleware-routing |
| TanStack Start | @better-i18n/use-intl | SSR, bestandsgebaseerde routing met $locale-parameter |
| Vite + React | @better-i18n/use-intl | SPA met client-side taalwisseling |
| Expo (React Native) | @better-i18n/expo | Offline caching, dynamische lokalisaties, OTA-updates |
Alle framework-integraties gebruiken dezelfde vertaalsleutels en namespaces, zodat je web- en mobiele apps één enkele bron van waarheid delen.
Vertaalbeheer voor Meerdere Teams
Namespace-organisatie
Organiseer vertalingen per team, functie of contenttype:
your-org/your-project
├── auth/ → Authenticatieteam
├── dashboard/ → Productteam
├── marketing/ → Marketingteam
├── help/ → Supportteam
└── onboarding/ → Groeiteam
Elke namespace kan onafhankelijke vertaalvoortgang en reviewworkflows hebben.
Glossariumbeheer
Definieer merktermen, productnamen en technisch vocabulaire eenmalig. Het glossarium waarborgt consistentie in alle vertalingen:
- Goedgekeurde termen — Stel de juiste vertaling in voor je productterminologie in elke taal
- Nooit-vertalen-regels — Markeer merknamen, technische termen en afkortingen die in de brontaal moeten blijven
- Consistentiewaarschuwingen — Vertalers ontvangen meldingen wanneer ze niet-goedgekeurde alternatieven gebruiken
AI-vertaling met Context
AI-vertaling respecteert je glossarium en namespace-context. Gebruik het voor:
- Eerste concept-generatie — AI produceert vertalingen die je terminologie volgen, waarna menselijke reviewers verfijnen
- Bulkvertaling — Vertaal een hele namespace naar een nieuwe taal in minuten
- Modelselectie — Kies tussen GPT-4o, Claude, Gemini of DeepL op basis van je kwaliteitsvoorkeuren
Schaalpatronen voor Grote Organisaties
Multi-projectstructuur
Enterprise-organisaties hebben vaak meerdere producten. Elk krijgt een eigen better-i18n-project met onafhankelijke namespaces, glossaria en teamtoegang:
your-org/web-app
your-org/mobile-app
your-org/marketing-site
your-org/help-center
De Content SDK en REST API werken over alle projecten met dezelfde authenticatie.
CI/CD-integratie
# .github/workflows/i18n-check.yml
name: Translation Coverage Check
on: [push, pull_request]
jobs:
i18n:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
- run: npx @better-i18n/cli scan --ci
- run: npx @better-i18n/cli sync --format json
Blokkeer PR's die onvertaalde strings introduceren. Controleer vertaaldekking bij elke push.
Contentbeheer op Schaal
De Content SDK ondersteunt headless CMS-patronen voor gelokaliseerde content:
// Alle gepubliceerde helpartikelen in het Duits ophalen
const { data: articles, total } = await client
.from("help-articles")
.eq("status", "published")
.language("de")
.order("updatedAt", { ascending: false })
.limit(50);
// Een enkel artikel ophalen met uitgebreide auteur-relatie
const { data: article } = await client
.from("help-articles")
.language("de")
.expand("author", "category")
.single("getting-started");
De query builder is immutable, volledig getypeerd en retourneert gepagineerde resultaten met total- en hasMore-metadata.
Wat We (Nog) Niet Bieden
We geloven in transparantie over onze huidige mogelijkheden:
- SSO/SAML — Nog niet beschikbaar. Authenticatie verloopt momenteel via GitHub OAuth. SSO staat op onze roadmap.
- On-premises deployment — We zijn een cloud-gehost SaaS-platform. Self-hosted opties zijn momenteel niet beschikbaar.
- Aangepaste dataresidentie — Data wordt verwerkt via het wereldwijde netwerk van Cloudflare en opgeslagen in PlanetScale. Regiospecifieke hosting is nog niet beschikbaar.
- Dedicated SLA — We bieden momenteel geen contractuele uptime-SLA's met financiële sancties.
Als een van deze punten een blokkade vormt voor je organisatie, neem contact met ons op om je vereisten en onze roadmap-planning te bespreken.
Aan de Slag
- Maak je organisatie aan op dash.better-i18n.com
- Stel je eerste project in en configureer de talen
- Installeer de CLI —
npm install -D @better-i18n/cli - Verbind GitHub — Schakel synchronisatie in voor je vertaalbestanden
- Voeg de MCP-server toe — Geef je AI-tools toegang tot je vertalingen
- Integreer de SDK — Gebruik
@better-i18n/next,@better-i18n/use-intlof@better-i18n/expoin je applicatie
Start gratis — geen creditcard vereist. De API, CLI, MCP-server en alle framework-integraties zijn beschikbaar op elk plan. Bekijk onze documentatie voor gedetailleerde installatiehandleidingen.