Use when exporting, packaging, signing, or publishing a game — export presets per engine, macOS notarization, cross-origin isolation for threaded web builds, Android AAB/keystore, iOS provisioning, store submission (Steam, Play, App Store, itch.io), headless build CI. NOT gameplay code inside the artifact (that is `godot`, `unity`, `unreal`), NOT hosting a web app or container (that is `deployment`).
Ship the game — export, build & release (per engine · per platform)
Take a finished project from editor → signed, correctly-configured artifact → live on the
right target (desktop / web / mobile / store), with the platform gotchas that silently break a
build handled up front. This skill owns the packaging and release boundary; the engine skills
own the code that runs inside the artifact.
Android: tick Build App Bundle (Google Play) for AAB; set the keystore in Publishing Settings.
WebGL: threads ⇒ COOP/COEP; keep decompression fallback for hosts that can't set gzip/br headers.
Unreal — build configurations, not "modes": Debug, DebugGame, Development (test packaged
builds — keeps logs/console), Test, Shipping (release — strips logging, most optimized). Package
via Platforms ▸ <target> ▸ Package Project, the Project Launcher, or UAT for CI:
Android adds -distribution for an AAB; iOS requires a Mac + provisioning. Run the platform
Turnkey/SDK setup once (Android Studio + NDK, or Xcode) or the cook fails.
→ full per-engine preset/flag tables: references/mobile-and-desktop.md
and references/stores-and-ci.md.
Per-platform
Desktop (Windows / macOS / Linux) — the simplest path
OS
Sign?
Gotcha
Windows
Optional (Authenticode; EV avoids SmartScreen warm-up)
Unsigned still runs but SmartScreen warns; ship .exe + engine data next to it, or an installer.
Linux
No
Ship binary + data, or wrap as AppImage/Flatpak for a portable single file.
macOS
Required
Must codesign (Developer ID Application) + notarize + staple, or Gatekeeper refuses to open it.
macOS notarization (the step everyone forgets):
codesign --deep --force --timestamp --options runtime \
--sign "Developer ID Application: Studio (TEAMID)" Game.app
ditto -c -k --keepParent Game.app Game.zip
xcrun notarytool submit Game.zip --keychain-profile "AC" --wait # store creds once via store-credentials
xcrun stapler staple Game.app # staple so it verifies offline
--options runtime (Hardened Runtime) is mandatory for notarization. Codesign every bundled
.dylib/helper before the outer .app, inside-out.
Web — the header trap (read this before blaming your build)
Threaded WebAssembly builds (Godot with Thread Support, Unity WebGL with threads) use
SharedArrayBuffer, which browsers gate behind cross-origin isolation. The server must send:
Missing them ⇒ SharedArrayBuffer is not defined, a hang, or a blank canvas — even though the
files are fine. Where to set them:
Netlify_headers, Vercelvercel.json headers, nginxadd_header — set both on the game path.
itch.io — tick "This file will be played in the browser" ▸ SharedArrayBuffer support; itch sets the headers for you.
GitHub Pages — cannot set headers. Use a non-threaded export, or the coi-serviceworker shim (a service worker that re-serves with the headers).
COEP: require-corp also means every cross-origin subresource (fonts, analytics, embeds) must
send CORP/CORS or it's blocked. Godot C#/.NET has no web export at all — use GDScript.
→ per-host configs, the service-worker shim, COEP subresource fallout, a self-test snippet and the
Godot vs Unity web specifics: references/web-export-headers.md.
Mobile
Android — needs JDK 17 and the engine's Gradle build template. Ship AAB to Play
(Google re-signs and generates per-device APKs), APK for sideload/itch/direct. Generate a
release keystore once and reuse it forever (lose it = you can't update the app without Play App
Signing key reset):
Keep the keystore + passwords out of git (CI secret). versionCode must increase every upload.
iOS — Mac + Xcode + Apple Developer account. Bundle ID must match an App ID; pick a
provisioning profile (development / ad-hoc / App Store) and a signing certificate. Archive,
then upload to App Store Connect / TestFlight via Xcode Organizer or Transporter. CFBundleVersion
must increase per upload.
→ full keystore + Play App Signing, provisioning/TestFlight, Windows Authenticode and Linux
AppImage/Flatpak walkthroughs: references/mobile-and-desktop.md.
Store prep
Assets: platform icons (Android adaptive, iOS icon set, Windows .ico, macOS .icns), splash/launch, store screenshots per device class, a trailer where required.
Metadata: title, short + full description, keywords, category, support/privacy URLs, localized strings.
Age ratings: fill the IARC questionnaire (Play, Microsoft, Nintendo) or ESRB/PEGI/USK; Apple has its own age-rating questionnaire. Wrong answers = removal.
Google Play: AAB + Play App Signing, a recent target API level, content rating, and the Data safety form.
Steam: Steamworks partner + appid; define depots; upload with SteamPipe (steamcmd +run_app_build app_build_APPID.vdf); store page assets; set the branch live.
itch.io: butler push build/ user/game:channel --userversion 1.2.3 — channel name (e.g. windows, html5) picks the platform.
Mac App Store: Apple Distribution cert + App Sandbox entitlements (not Developer ID); notarization is handled by App Store submission.
→ Steamworks/SteamPipe VDF, butler channels, Play/App Store submission checklists:
references/stores-and-ci.md.
CI/CD for builds
Headless export in GitHub Actions; version from the run/commit so every artifact is traceable.
Godot: run in a container that bundles matching export templates (e.g. a barichello/godot-ci-style image), godot --headless --export-release.
Unity: game-ci/unity-builder + a license activation step (secrets); matrix over targets.
Unreal: needs a self-hosted runner with the engine installed (multi-GB); UAT BuildCookRun.
Signing in CI: import the keystore/cert from an encrypted secret at runtime, never commit it. macOS notarization runs on a macos-latest runner with notarytool + an App Store Connect API key.
Versioning: semver tag for releases; a monotonic build number from github.run_number or the git commit count feeds versionCode/CFBundleVersion/Steam build description.
→ ready per-engine workflows with signing: references/stores-and-ci.md.
Ship-time optimization
Texture compression per platform: ASTC (mobile), BCn/DXT (desktop), ETC2 (GLES fallback). Set per-platform import overrides — never ship uncompressed PNGs to mobile.
Strip the fat: Unity Managed Stripping Level: High + IL2CPP; Unreal Shipping drops logs/console; Godot — export only used resources and disable unused modules in a custom template.
Startup: small boot scene, stream/preload heavy assets, compress the .pck/data, use Ogg Vorbis over WAV. Web: enable gzip/brotli on .wasm/.pck.
Budgets: set a per-platform size budget (web especially — every MB is download latency) and check the final artifact against it before submitting.
Anti-patterns
Anti-pattern
Do instead
Web build works locally, host it later
Set COOP/COEP now; file:// and simple servers hide the SharedArrayBuffer failure.
Planning a Godot C# web export
It doesn't exist in 4.x. GDScript for web, or no web.
Treating notarization as optional
On macOS, no notarize + staple = Gatekeeper blocks the app for every user.
Shipping an APK to the Play Store
Play requires AAB for new apps and updates.
Committing the keystore so CI can sign
Keystore/cert live in encrypted CI secrets, never in git.
Store assets: icons, splash, screenshots, metadata, age rating done.
Version/build number set from CI and traceable.
Textures compressed per platform; build size within budget.
1---2name: gamedev-shipping3description: "Use when exporting, packaging, signing, or publishing a game — export presets per engine, macOS notarization, cross-origin isolation for threaded web builds, Android AAB/keystore, iOS provisioning, store submission (Steam, Play, App Store, itch.io), headless build CI. NOT gameplay code inside the artifact (that is `godot`, `unity`, `unreal`), NOT hosting a web app or container (that is `deployment`)."4tags: [export, build, release, packaging, store, steam, itch, notarization, webassembly, aab]5recommends: [godot, unity, unreal, deployment]6profiles: [full]7origin: risco8metadata:9 source: https://skillmd.com/skills/ericrisco/gamedev-shipping10---1112# Ship the game — export, build & release (per engine · per platform)1314Take a finished project from editor → signed, correctly-configured artifact → live on the15right target (desktop / web / mobile / store), with the platform gotchas that silently break a16build handled up front. This skill owns the *packaging and release boundary*; the engine skills17own the code that runs inside the artifact.1819```text20project ──[engine export/build]──▶ artifact ──[per-platform sign/config]──▶ target21Godot templates·Unity Build Profiles·Unreal Shipping desktop·web·mobile Steam·Play·App Store·itch22```2324## Version anchors (what "current" means here — July 2026)2526| Tool | Target | Ship note |27| --- | --- | --- |28| Godot | 4.5 stable (4.6 dev) | Export templates must match the editor build **exactly** (4.5.1 editor ⇒ 4.5.1 templates). **C#/.NET edition has NO web export** — GDScript/standard only. |29| Unity | Unity 6 (6000.x) | "Build Settings" is now **Build Profiles**. IL2CPP backend for iOS/Android/WebGL. |30| Unreal | 5.6 | Ship in the **Shipping** config; test packaged builds in **Development**. |31| Android | JDK **17**, target a recent API level | AAB required for Google Play (new apps + updates). APK only for sideload/itch/direct. |32| iOS/macOS | Xcode 16+, `notarytool` | `altool` notarization is dead — use `xcrun notarytool`. |3334## When NOT to use — and who owns it instead3536| Ask | Owner | Why the line is there |37| --- | --- | --- |38| Gameplay, shaders, netcode, physics — any runtime logic | `../godot/SKILL.md`, `../unity/SKILL.md`, `../unreal/SKILL.md`, `../gamedev-shaders/SKILL.md`, `../gamedev-multiplayer/SKILL.md`, `../gamedev-physics/SKILL.md` | This skill packages code, it does not write it. The boundary is the export button. |39| Hosting a normal web app, API or container (Dockerfile, Coolify, Vercel, VPS) | `../deployment/SKILL.md` | A WebAssembly game is *static files*; only its **headers** are special (below). Borrow its Actions + header-setting patterns. |40| Game feel, economy, narrative | `../game-design/SKILL.md`, `../game-storytelling/SKILL.md` | Design intent, not packaging. |41| Signing-key and CI secret handling in general | `../security-audit/SKILL.md` | The practice this skill assumes for keystores/certs. |4243## Decision rules (settle these before touching a build)4445| Question | Rule |46| --- | --- |47| Web build uses threads / SharedArrayBuffer? | You **must** serve `COOP: same-origin` + `COEP: require-corp` (cross-origin isolation). No headers ⇒ no threads ⇒ boot failure. |48| Godot + C# + web? | **Impossible today.** Switch to GDScript for web, or ship that title desktop/mobile only. |49| Play Store? | **AAB**, signed with an upload key, Play App Signing on. Not APK. |50| macOS distribution outside the App Store? | codesign (Developer ID) → **notarize** → **staple**. Skipping = Gatekeeper blocks it. |51| Mac **App Store**? | Different cert (Apple Distribution) + sandbox entitlements; notarization is automatic, not manual. |52| Steam? | SteamPipe upload via `steamcmd` + an `app_build` VDF; set the default branch live in the partner site. |53| Quick public build / demo / jam? | **itch.io** + `butler push`. Tick "SharedArrayBuffer support" for threaded web builds. |54| Release config? | Godot **release** preset (debug off), Unity release/**IL2CPP**, Unreal **Shipping**. Never ship a debug/Development build. |5556## Export / build per engine5758**Godot** — `Editor ▸ Manage Export Templates` (match version), then `Project ▸ Export`, add one59preset per platform. Headless for CI:6061```bash62godot --headless --export-release "Windows Desktop" build/game.exe63godot --headless --export-release "Web" build/index.html64# Android AAB needs the Gradle build template + JDK 17 + a release keystore (see references)65```6667Web preset toggles: **Thread Support** (⇒ needs COOP/COEP) and **Extensions Support**. Android68needs `Project ▸ Install Android Build Template` (enables *Use Gradle Build*).6970**Unity** — `File ▸ Build Profiles` (formerly Build Settings). Create a profile per platform;71override **Player Settings** per profile (company/product name, bundle id, icons, scripting72backend). iOS/Android/WebGL force **IL2CPP**. CI headless:7374```bash75Unity -quit -batchmode -nographics -projectPath . \76 -buildTarget Android -executeMethod BuildScript.PerformBuild -logFile -77```7879Android: tick **Build App Bundle (Google Play)** for AAB; set the keystore in *Publishing Settings*.80WebGL: threads ⇒ COOP/COEP; keep **decompression fallback** for hosts that can't set gzip/br headers.8182**Unreal** — build **configurations**, not "modes": Debug, DebugGame, **Development** (test packaged83builds — keeps logs/console), Test, **Shipping** (release — strips logging, most optimized). Package84via `Platforms ▸ <target> ▸ Package Project`, the Project Launcher, or UAT for CI:8586```bash87RunUAT BuildCookRun -project="Game.uproject" -platform=Win64 \88 -clientconfig=Shipping -cook -stage -pak -package -archivedirectory=build89```9091Android adds `-distribution` for an AAB; iOS requires a Mac + provisioning. Run the platform92**Turnkey**/SDK setup once (Android Studio + NDK, or Xcode) or the cook fails.9394→ full per-engine preset/flag tables: [references/mobile-and-desktop.md](references/mobile-and-desktop.md)95and [references/stores-and-ci.md](references/stores-and-ci.md).9697## Per-platform9899### Desktop (Windows / macOS / Linux) — the simplest path100101| OS | Sign? | Gotcha |102| --- | --- | --- |103| Windows | Optional (Authenticode; EV avoids SmartScreen warm-up) | Unsigned still runs but SmartScreen warns; ship `.exe` + engine data next to it, or an installer. |104| Linux | No | Ship binary + data, or wrap as **AppImage**/**Flatpak** for a portable single file. |105| macOS | **Required** | Must codesign (Developer ID Application) **+ notarize + staple**, or Gatekeeper refuses to open it. |106107macOS notarization (the step everyone forgets):108109```bash110codesign --deep --force --timestamp --options runtime \111 --sign "Developer ID Application: Studio (TEAMID)" Game.app112ditto -c -k --keepParent Game.app Game.zip113xcrun notarytool submit Game.zip --keychain-profile "AC" --wait # store creds once via store-credentials114xcrun stapler staple Game.app # staple so it verifies offline115```116117`--options runtime` (Hardened Runtime) is **mandatory** for notarization. Codesign every bundled118`.dylib`/helper *before* the outer `.app`, inside-out.119120### Web — the header trap (read this before blaming your build)121122Threaded WebAssembly builds (Godot with Thread Support, Unity WebGL with threads) use123**`SharedArrayBuffer`**, which browsers gate behind **cross-origin isolation**. The server must send:124125```126Cross-Origin-Opener-Policy: same-origin127Cross-Origin-Embedder-Policy: require-corp128```129130Missing them ⇒ `SharedArrayBuffer is not defined`, a hang, or a blank canvas — even though the131files are fine. Where to set them:132133- **Netlify** `_headers`, **Vercel** `vercel.json` headers, **nginx** `add_header` — set both on the game path.134- **itch.io** — tick **"This file will be played in the browser" ▸ SharedArrayBuffer support**; itch sets the headers for you.135- **GitHub Pages** — **cannot** set headers. Use a non-threaded export, or the `coi-serviceworker` shim (a service worker that re-serves with the headers).136137`COEP: require-corp` also means every cross-origin subresource (fonts, analytics, embeds) must138send CORP/CORS or it's blocked. **Godot C#/.NET has no web export at all** — use GDScript.139140→ per-host configs, the service-worker shim, COEP subresource fallout, a self-test snippet and the141Godot vs Unity web specifics: [references/web-export-headers.md](references/web-export-headers.md).142143### Mobile144145**Android** — needs **JDK 17** and the engine's Gradle build template. Ship **AAB** to Play146(Google re-signs and generates per-device APKs), **APK** for sideload/itch/direct. Generate a147release keystore once and reuse it forever (lose it = you can't update the app without Play App148Signing key reset):149150```bash151keytool -genkey -v -keystore release.keystore -alias game \152 -keyalg RSA -keysize 2048 -validity 10000153```154155Keep the keystore + passwords out of git (CI secret). `versionCode` must increase every upload.156157**iOS** — Mac + Xcode + Apple Developer account. Bundle ID must match an **App ID**; pick a158**provisioning profile** (development / ad-hoc / App Store) and a signing certificate. Archive,159then upload to App Store Connect / TestFlight via Xcode Organizer or **Transporter**. `CFBundleVersion`160must increase per upload.161162→ full keystore + Play App Signing, provisioning/TestFlight, Windows Authenticode and Linux163AppImage/Flatpak walkthroughs: [references/mobile-and-desktop.md](references/mobile-and-desktop.md).164165## Store prep166167- **Assets**: platform icons (Android adaptive, iOS icon set, Windows `.ico`, macOS `.icns`), splash/launch, store screenshots per device class, a trailer where required.168- **Metadata**: title, short + full description, keywords, category, support/privacy URLs, localized strings.169- **Age ratings**: fill the **IARC** questionnaire (Play, Microsoft, Nintendo) or ESRB/PEGI/USK; Apple has its own age-rating questionnaire. Wrong answers = removal.170- **Google Play**: AAB + **Play App Signing**, a recent **target API level**, content rating, and the **Data safety** form.171- **Steam**: Steamworks partner + appid; define **depots**; upload with **SteamPipe** (`steamcmd +run_app_build app_build_APPID.vdf`); store page assets; set the branch live.172- **itch.io**: `butler push build/ user/game:channel --userversion 1.2.3` — channel name (e.g. `windows`, `html5`) picks the platform.173- **Mac App Store**: Apple Distribution cert + App Sandbox entitlements (not Developer ID); notarization is handled by App Store submission.174175→ Steamworks/SteamPipe VDF, butler channels, Play/App Store submission checklists:176[references/stores-and-ci.md](references/stores-and-ci.md).177178## CI/CD for builds179180Headless export in GitHub Actions; version from the run/commit so every artifact is traceable.181182- **Godot**: run in a container that bundles matching export templates (e.g. a `barichello/godot-ci`-style image), `godot --headless --export-release`.183- **Unity**: `game-ci/unity-builder` + a license activation step (secrets); matrix over targets.184- **Unreal**: needs a **self-hosted runner** with the engine installed (multi-GB); UAT `BuildCookRun`.185- **Signing in CI**: import the keystore/cert from an encrypted secret at runtime, never commit it. macOS notarization runs on a `macos-latest` runner with `notarytool` + an App Store Connect API key.186- **Versioning**: semver tag for releases; a monotonic build number from `github.run_number` or the git commit count feeds `versionCode`/`CFBundleVersion`/Steam build description.187188→ ready per-engine workflows with signing: [references/stores-and-ci.md](references/stores-and-ci.md).189190## Ship-time optimization191192- **Texture compression per platform**: ASTC (mobile), BCn/DXT (desktop), ETC2 (GLES fallback). Set per-platform import overrides — never ship uncompressed PNGs to mobile.193- **Strip the fat**: Unity **Managed Stripping Level: High** + IL2CPP; Unreal **Shipping** drops logs/console; Godot — export only used resources and disable unused modules in a custom template.194- **Startup**: small boot scene, stream/preload heavy assets, compress the `.pck`/data, use Ogg Vorbis over WAV. Web: enable gzip/brotli on `.wasm`/`.pck`.195- **Budgets**: set a per-platform size budget (web especially — every MB is download latency) and check the final artifact against it before submitting.196197## Anti-patterns198199| Anti-pattern | Do instead |200| --- | --- |201| Web build works locally, host it later | Set COOP/COEP now; `file://` and simple servers hide the `SharedArrayBuffer` failure. |202| Planning a Godot C# web export | It doesn't exist in 4.x. GDScript for web, or no web. |203| Treating notarization as optional | On macOS, no notarize + staple = Gatekeeper blocks the app for every user. |204| Shipping an APK to the Play Store | Play requires **AAB** for new apps and updates. |205| Committing the keystore so CI can sign | Keystore/cert live in encrypted CI secrets, never in git. |206| Shipping the Development/Debug config | Ship Godot release / Unity IL2CPP release / Unreal **Shipping** — debug leaks console + is slow. |207| Export templates "close enough" (4.5 vs 4.5.1) | Godot templates must match the editor build exactly or export breaks. |208| Uncompressed textures | Per-platform compression (ASTC/BCn/ETC2) — raw textures blow memory + size. |209| Reusing an old versionCode/CFBundleVersion | Both must strictly increase or the store rejects the upload. |210211## Checklist212213- [ ] Release/Shipping config, not Debug/Development.214- [ ] (Godot) export templates match the editor version exactly.215- [ ] (Web, threaded) COOP `same-origin` + COEP `require-corp` served; boots without `SharedArrayBuffer` errors.216- [ ] (Godot + web) confirmed GDScript, not C#/.NET.217- [ ] (macOS) codesigned (Hardened Runtime) + notarized + stapled.218- [ ] (Android) AAB for Play, JDK 17, release keystore in CI secrets, `versionCode` bumped.219- [ ] (iOS) provisioning profile + signing cert correct, `CFBundleVersion` bumped.220- [ ] Store assets: icons, splash, screenshots, metadata, age rating done.221- [ ] Version/build number set from CI and traceable.222- [ ] Textures compressed per platform; build size within budget.
Run npx get-skill add ericrisco/gamedev-shipping in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when exporting, packaging, signing, or publishing a game — export presets per engine, macOS notarization, cross-origin isolation for threaded web builds, Android AAB/keystore, iOS provisioning, store submission (Steam, Play, App Store, itch.io), headless build CI. NOT gameplay code inside the artifact (that is `godot`, `unity`, `unreal`), NOT hosting a web app or container (that is `deployment`). It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
ericrisco (@ericrisco) published this skill. Their other Agent Skills are listed on their SkillMD profile.