Configuration ​

All available settings in GemShell.

Project Settings ​

SettingTypeDescription
Game TitlestringDisplay name shown in title bar
App NamestringUnique identifier (no spaces, lowercase)
VersionstringSemantic version (e.g., "1.0.0")

Window Settings ​

SettingTypeDefaultDescription
Widthnumber1280Window width in pixels
Heightnumber720Window height in pixels
ResizablebooleantrueAllow window resizing
FullscreenbooleanfalseStart in fullscreen mode
FramebooleantrueShow window frame/titlebar
Always on TopbooleanfalseKeep window above others

Build Targets ​

macOS ​

ArchitectureDescription
ARM64Apple Silicon (M1/M2/M3)
x64Intel Macs

Windows ​

ArchitectureDescription
x6464-bit (most common)
ARM64ARM-based Windows devices
ia3232-bit (legacy support)

Linux ​

ArchitectureDescription
x6464-bit (most common)
ARM64ARM-based devices

Optimization (Pro) ​

SettingDescription
Minify JavaScriptCompress JS files
Minify CSSCompress CSS files
Minify HTMLCompress HTML files
Bundle CDN ResourcesDownload and bundle external resources

Steamworks (Pro) ​

SettingDescription
Enable SteamworksAdd Steam integration
App IDYour Steam Application ID

Configuration File ​

Settings are saved to gemshell.json in your game folder. Every key is described in the Config File Reference.

Command Line ​

Everything on this page can also be done from a terminal or a CI pipeline with the gemshell command line tool. See Command Line.