codegen

gumcli codegen <project.gumx> [--element <name>...]

Generates C# code for elements in a Gum project. Runs error checks before generating each element — elements with errors are skipped; elements with only warnings are still generated.

Options

• <project.gumx> — Path to the .gumx project file
• --element <name> — Generate code only for the named element. Can be specified multiple times. Supports folder-qualified names.

Examples

gumcli codegen MyProject/MyProject.gumx
gumcli codegen MyProject/MyProject.gumx --element Button
gumcli codegen MyProject/MyProject.gumx --element Button --element Slider
gumcli codegen MyProject/MyProject.gumx --element Controls/Button

Output on success:

Generated code for 12 element(s).

Output with blocked elements:

error: ButtonComponent: Base type 'ButtonBase' not found.
Generated code for 11 element(s).
1 element(s) skipped due to errors.

Notes

• Requires ProjectCodeSettings.codsj with CodeProjectRoot configured. If the file is missing, codegen attempts auto-detection first and writes it before continuing. Exit code 2 only if auto-detection also fails — in that case, run codegen-init first.
• Only Screens and Components are generated. StandardElements are excluded.
• Elements marked NeverGenerate in their per-element settings are silently skipped.
• When --element is specified, codegen also auto-generates code for any referenced elements whose code files do not yet exist.
• Errors go to stderr; the summary line goes to stdout.

Exit Codes

Code	Meaning
0	All eligible elements generated successfully
1	One or more elements were skipped due to errors
2	Project could not be loaded or code generation settings could not be resolved