Skip to content
Open the console

Built-in words ​

TUNED's own words, the same for every user: the app's buttons, labels and messages, and a few sentences on TUNED's servers. The app's words live in one file, so changing or translating them needs no programmer: a copywriter, a translator, a translation service or an AI tool can do it.

The app's words file ​

Every button, label, heading, hint, error message and empty screen in the app is kept in one file: nearly 900 texts, from Create an Account on the welcome screen to the message under an empty wallet. Each text has a short note saying where it shows, so whoever reads the file knows what they are looking at:

Where it shows (the note)The words
Welcome screen primary button — opens the create-account screenCreate an Account
Empty state under Activity when the transactions list is emptyNo transactions yet - load funds to see them here.
Last-updated footnote on legal document pagesLast Updated: {date}

There is one file per language. English is the base, and each other language is the same file with every text translated. The file is in ARB, a standard format that translation services and AI tools read as it is.

Change or translate the words ​

  1. Get the file. Ask the developers for the words file: the English one to reword a text, or to translate into a new language.
  2. Make the change. Reword a text in English, or translate the whole file. A copywriter, a translator, a translation service or an AI tool can do this. The notes tell them where each text shows.
  3. Send it back. The developers put the file into the app and build a new version.
  4. Users update. Apple and Google review the version, and users get the new words when they update the app. End to end this usually takes a few days.

When translating ​

  • Keep the words in braces as they are. In Last Updated: {date}, the app fills in {date}. Translate around it, never inside it.
  • Translate every form of a counted word. Some texts change with a number, like 1 token and 5 tokens. Some languages need more forms than English; Russian has three (1 токен, 2 токена, 5 токенов), and the translation adds them.
  • Keep TUNED's terms. Claim Reward, Payment Methods and Linked Accounts have fixed meanings in TUNED. Pick one translation for each and use it everywhere.
  • Mind the space. A button has little room. When the note says button, keep the translation about as short as the English.

Translating with AI

Give the AI tool the whole file. Ask it to translate only the texts, and to keep the names, the notes, the words in braces and the layout of the file exactly as they are. Then ask a native speaker to read the result in the app before it ships.

On TUNED's servers ​

A few fixed sentences are written into TUNED's servers rather than the app's file:

Where users see itThe words
The push when tokens landYou earned tokens, and +1 token just landed in your wallet
The push after a purchase that doesn't complete a token yetPurchase counted, naming the token the purchase counts toward
The pushes about an orderOn its way, Order cancelled and Shipment cancelled, naming the reward
The sign-up code email and text messageYour TUNED verification code is …
The page a shared link opens in a browserOpen this link on your phone with the TUNED app installed.
A link card whose text isn't set in the consoleTUNED, and Spend anywhere. Earn tokens. Claim rewards.

Send the developers the new wording or the translation for any of these. No app update is needed: a change is live once it reaches the servers.

Languages ​

Built-in words follow the user's language, like the rest of TUNED: the phone's language by default, or the one chosen in the app's settings. A text missing from a language's file shows in English, so nothing breaks while a translation is finished.

Adding a language takes a translation of the words file and an app version that carries it: a translation job plus a release, not a change to how the app works.

Use a content word instead ​

Anything that may change often or with the season is better as a content word than a built-in word: a reward's description, a push, a section's title. Those change in the console within seconds, and you translate them yourself on the Strings page.