Ship localized content without blocking app startup.

Supported SDKs

Every client resolves translations synchronously from cache and the bundled fallback, then refreshes OTA in the background. Pick a platform to see a copy-ready integration example.

npm install @golocalise/javascript-sdk

import { GoLocaliseClient } from '@golocalise/javascript-sdk';

const client = new GoLocaliseClient({
  baseUrl: 'https://api.golocalise.me',
  token: 'gl_sdk_REPLACE_ME',
  projectId: 'PROJECT_ID',
  environment: 'production',
  locale: 'ar-LB',
});

await client.initialize();
const title = client.t('order.title', {
  namespace: 'default',
  fallback: 'Order title',
});

await client.refresh();
await client.setLocale('ar');

https://github.com/abdallahnh/golocalise-swift.git

import GoLocalise

let client = GoLocaliseClient(configuration: try GoLocaliseConfiguration(
    baseURL: URL(string: "https://api.golocalise.me")!,
    token: "gl_sdk_REPLACE_ME",
    projectId: "PROJECT_ID",
    environment: "production",
    locale: "ar-LB",
    cache: try FileCacheAdapter(directory: cacheDirectory),
    bundled: bundledTranslations
))

Task { await client.initialize() }
let title = client.translation(
    for: "order.title",
    namespace: "default",
    fallback: "Order title"
)

Task { await client.refresh() }
Task { await client.setLocale("ar") }

implementation("me.golocalise:golocalise-android:1.0.0")

val client = GoLocaliseClient(
  GoLocaliseConfiguration(
    baseUrl = URL("https://api.golocalise.me"),
    token = "gl_sdk_REPLACE_ME",
    projectId = "PROJECT_ID",
    environment = "production",
    locale = "ar-LB",
    cache = FileCacheAdapter(File(context.cacheDir, "golocalise")),
    bundled = bundledTranslations,
  )
)

lifecycleScope.launch { client.initialize() }
val title = client.translation(
  "order.title",
  namespace = "default",
  fallback = "Order title",
)

lifecycleScope.launch { client.refresh() }
lifecycleScope.launch { client.setLocale("ar") }

Choose a project

Open a project and select Developer to see its live release, languages, credential status, OTA endpoint, and copy-ready SDK configuration.

• Live release
• Languages
• Credential status
• OTA endpoint
• Copy-ready SDK configuration

Run the demo clients

All demos use the same public, read-only gl_sdk_ credential. In your project, publish a release and open Developer to copy the project ID, environment, token, and OTA base URL. Never put an organization API secret in a demo app.

# Web (.env)
NEXT_PUBLIC_DEMO_OTA_BASE_URL=http://localhost:3001
NEXT_PUBLIC_DEMO_SDK_TOKEN=gl_sdk_...
NEXT_PUBLIC_DEMO_PROJECT_ID=...
NEXT_PUBLIC_DEMO_ENVIRONMENT=production
NEXT_PUBLIC_DEMO_LOCALE=ar-LB

pnpm dev
# Open http://localhost:3000/demo

The repository's docs/demo-clients.md guide includes the complete Xcode, Gradle, and manual golden-path instructions.

Locales and regional Arabic

GoLocalise accepts BCP 47 locale tags such as ar-LB for Arabic (Lebanon), ar-IQ for Arabic (Iraq), en-US, and fr-CA. Inputs such as ar_lb are accepted for convenience and stored as ar-LB, so every locale has one stable OTA/cache identity.

For layout direction, mixed-script text, mirroring, and test strategy, read the Arabic and RTL localization guide.

• ar-LB
• ar-IQ
• en-US
• fr-CA

Add each regional locale under the project's Languages settings, translate it, and publish a release for the chosen environment. The SDK's supportedLocales() returns only locales present in that environment's current release; use one of those values with setLocale(...).

Placeholders and plurals

Translators use visual tokens and plural forms; GoLocalise handles the platform syntax. A string placeholder is modeled once and rendered as %@ for iOS, %1$s for Android, or a canonical token for Web. Escaped percent signs, positional arguments, and malformed values are validated safely.

Plurals use the locale's real categories—for example one/other in English and zero, one, two, few, many, and other in Arabic. iOS uses .stringsdict, Android uses plurals.xml, and OTA preserves canonical plural metadata for cache and bundled-fallback parity.

count selects the plural category; it is not one of the positional arguments. Set the editor's Count Variable (usually count) and place {count} where the number belongs. Pass a numeric count to the SDK. Use arguments only for extra placeholders such as {0}. For Arabic, the active locale must be Arabic and a new OTA release must be published after changing forms.

// Web — canonical tokens: "Welcome, {0}"
client.t("welcome", { arguments: ["Maya"] })

// iOS — canonical {0} or Apple %@ / %1$@
client.translation(for: "welcome", arguments: ["Maya"])

// Android — canonical {0} or %s / %1$s
client.translation("welcome", arguments = listOf("Maya"))

// Web plural: count selects the form; arguments fill {0}
client.t("cart.items", { count: 1, arguments: ["Maya"] })

// iOS plural (Arabic 1 selects the one form)
client.translation(for: "cart.items", count: 1, arguments: ["Maya"])

// Android plural
client.translation("cart.items", count = 1.0, arguments = listOf("Maya"))

Placeholder formatting is available in the current JavaScript, iOS, and Android SDK sources. The translation workspace also provides a locale-aware plural editor with an always-required other form.

API & MCP

Every dashboard capability has an API behind it: public exports and reviewed imports for servers and CI, read-only OTA artifacts for runtime clients, and the MCP server that brings projects, exports, and the import review workflow into Cursor, Claude, and other AI hosts.

Planning a production rollout? Review the OTA localization engineering guide for immutable releases, cache safety, and rollback.