Technical Configuration
The CBA ItemBuilder is configured using the file cba-itembuilder.ini located in the installation directory. Parameters are specified as JVM arguments with the -D prefix, one per line. Changes take effect after restarting the CBA ItemBuilder.
Presentation and Preview
-DdefaultItemHeight |
715 |
Default CBA Presentation Size height in pixels for new projects (see section 3.2.2). |
[Issue 7]
-DdefaultItemWidth | 722 | Default CBA Presentation Size width in pixels for new projects.
-Djetty.port | 7070 | Port used by the internal web server (Jetty) for previewing items. Must be unique if running multiple CBA ItemBuilder instances in parallel (see section 6.8.8).
-DbrowserChoice | (system default) | Sets the default preview browser. Values: chrome (use Chrome), internal (use built-in rendering), or blank for system default browser.
-DpreviewAutoSave | never | Controls auto-save behavior when preview is requested. Values: always (save without asking), confirm (ask before saving), never (do not save).
Editor Behavior
-DsimpleTextEditorWrap |
yes |
Enable automatic word wrap in the text editor for SimpleTextField and InputField components. Values: yes, no. |
-DisTreeViewShowsAll |
no |
Shows additional debugging elements in the Component Edit view. Values: yes, no. Only for debugging purposes. |
-DdarkTheme |
(not set) |
Enables dark theme for the CBA ItemBuilder user interface. |
-Dfile.encoding |
UTF-8 |
Character encoding. Should be set to UTF-8 for support of non-Western European languages. |
Translation Service (DeepL)
-DdeepLApiKey |
(empty) |
DeepL API authentication key for the translation service. |
-DdeepLApiUrl |
(DeepL default) |
Custom DeepL API URL. If blank, the standard DeepL API URLs are used. |
-DdeepLGlossaryName |
(empty) |
Name of the DeepL glossary to use for translations. |
-DdeepLGlossaryId |
(empty) |
ID of the DeepL glossary to use for translations. |
-DtranslationContext |
(empty) |
Additional context text provided to DeepL for improved translation quality. |
Online Help
-DonlineHelpUrl |
https://cba.itembuilder.de |
URL opened by the Help > Help Online menu entry. |
-Donline.help.update.site |
(empty) |
Path or URL for the online help update bundle. |
Advanced / Internal Parameters
The following parameters are typically not changed by item authors and are included for completeness:
-DalwaysGenerateAtSave |
yes |
Forces automatic generation of the runtime configuration before saving. Should remain yes. |
-DPreloadImages |
false |
Preloads images of all value displays at item startup for faster rendering. |
-DTraceHighlightedText |
(not set) |
When set to true, traces highlighted text positions in the log. |
-DTraceVerbose |
(not set) |
When set to true, shows trace events on console and in log files. |
-Djava.util.Arrays.useLegacyMergeSort |
true |
Required MergeSort algorithm for internal sorting. |
-Dsun.rmi.dgc.client.gcInterval |
3600000 |
Java garbage collection interval (milliseconds). |
-Dapp |
false |
For developers only. Loads the React runtime from a local directory instead of the bundled version. |