Repository navigation
Translation
formcut ships in 16 languages: English, Spanish, German, French, Italian, Japanese, Korean, Brazilian Portuguese, Russian, Turkish, Simplified Chinese, Traditional Chinese, Arabic, Persian, Hebrew and Croatian; Arabic, Persian and Hebrew turn the interface right to left. The language is chosen on the home screen, and switching rewrites what is on screen in place, without a reload.
-
frontend/src/i18n/en.json,es.jsonandde.jsonhold keyed strings, read witht(key). -
frontend/src/i18n/language-pack.tsholds the other nine languages as rows: the English phrase, then French, Italian, Japanese, Korean, Brazilian Portuguese, Russian, Turkish, Simplified Chinese and Traditional Chinese, separated by|. A key resolves in these languages through its English value. Every row must have exactly ten fields, or the app stops at start-up. -
frontend/src/i18n/text.tstranslates English phrases already written into the interface:text(phrase)for one string,localizeElement(root)for the text,title,placeholderandaria-labelof a whole subtree. German and Spanish phrases that have no key live in itsadditionalmaps. -
frontend/public/locales/ar.json,fa.json,he.jsonandhr.jsonhold the other four as files, loaded at start through/api/locales: every key ofen.json, plus aphrase:<English>entry for every phrase the pack translates by its wording. A file dropped into the data folder'slocales/works the same way, and wins over a shipped one for its language.
An English phrase is translated only if it has a translation and it passes
through t(), text() or localizeElement() at the moment it reaches the
screen. main.ts localizes the whole page once every pane and menu is built.
Anything written after that, such as names that arrive from the engine, rows
that load asynchronously, or labels that change with state, must call text()
where it is written.
- Never read a translated label back to learn state. Keep the value in a data
attribute or in an option's
value, and display it throughtext(). The blend mode control keeps its mode indata-modefor this reason. - A select shows labels, never ids: set
valueto the id and the text to a readable English label. Code reads the select only through.value. - Phrase matching is exact and global. Before adding a single-word phrase, check that every place the word appears in the interface means the same thing.
- When two rows share an English source, the later one wins. Do not add a row for a phrase that already has one.
Run the app in Japanese and look for Latin-script text. Anything left is either untranslated or deliberately left as it is: language names in their own language, user content such as track and timeline names, file types, and code such as the expression example. The scan used for each release visits every tab, menu, creator page and select option, including pages that stay hidden until chosen.
Pages
- Home
- Architecture
- Creator workflow
- Automation
- Extensions
- Packaging
- Translation
- Mobile notes
- Models
- Licences
In the repository
These pages are published from .docs/wiki/ in the repository. Edit them there;
a push to main updates this wiki. Editing a page here is overwritten by the
next publish.