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 screen | Create an Account |
| Empty state under Activity when the transactions list is empty | No transactions yet - load funds to see them here. |
| Last-updated footnote on legal document pages | Last 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
- Get the file. Ask the developers for the words file: the English one to reword a text, or to translate into a new language.
- 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.
- Send it back. The developers put the file into the app and build a new version.
- 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 it | The words |
|---|---|
| The push when tokens land | You earned tokens, and +1 token just landed in your wallet |
| The push after a purchase that doesn't complete a token yet | Purchase counted, naming the token the purchase counts toward |
| The pushes about an order | On its way, Order cancelled and Shipment cancelled, naming the reward |
| The sign-up code email and text message | Your TUNED verification code is … |
| The page a shared link opens in a browser | Open this link on your phone with the TUNED app installed. |
| A link card whose text isn't set in the console | TUNED, 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.
Related
- Strings and languages — the three kinds of words.
- Behind the scenes — how content and sharing words reach a phone.