Configuration

All available settings in GemShell.

Project Settings

Setting	Type	Description
Game Title	string	Display name shown in title bar
App Name	string	Unique identifier (no spaces, lowercase)
Version	string	Semantic version (e.g., "1.0.0")

Window Settings

Setting	Type	Default	Description
Width	number	1280	Window width in pixels
Height	number	720	Window height in pixels
Resizable	boolean	true	Allow window resizing
Fullscreen	boolean	false	Start in fullscreen mode
Frame	boolean	true	Show window frame/titlebar
Always on Top	boolean	false	Keep window above others

Build Targets

macOS

Architecture	Description
ARM64	Apple Silicon (M1/M2/M3)
x64	Intel Macs

Windows

Architecture	Description
x64	64-bit (most common)
ARM64	ARM-based Windows devices
ia32	32-bit (legacy support)

Linux

Architecture	Description
x64	64-bit (most common)
ARM64	ARM-based devices

Optimization (Pro)

Setting	Description
Minify JavaScript	Compress JS files
Minify CSS	Compress CSS files
Minify HTML	Compress HTML files
Bundle CDN Resources	Download and bundle external resources

Steamworks (Pro)

Setting	Description
Enable Steamworks	Add Steam integration
App ID	Your Steam Application ID

Configuration File

Settings are saved to gemshell.config.json in your game folder:

{
  "title": "My Game",
  "appName": "my-game",
  "version": "1.0.0",
  "window": {
    "width": 1280,
    "height": 720,
    "resizable": true,
    "fullscreen": false
  },
  "targets": {
    "macos-arm64": true,
    "macos-x64": true,
    "windows-x64": true,
    "linux-x64": true
  },
  "steamworks": {
    "enabled": false,
    "appId": "480"
  },
  "optimization": {
    "minifyJs": true,
    "minifyCss": true,
    "minifyHtml": true
  },
  "plugins": {}
}

Environment Variables

GemShell respects these environment variables:

Variable	Description
GEMSHELL_BUILD_DIR	Override default build output directory
STEAM_APP_ID	Override Steam App ID for testing

Command Line (Future)

# Build with default settings
gemshell build /path/to/game

# Build specific platforms
gemshell build /path/to/game --platform=windows-x64,macos-arm64

# Build with custom output
gemshell build /path/to/game --output=/path/to/output