📌 Note: This project was renamed from Unity-CI-Templates to Unity-CI-CD. Since I originally created it, the project has grown quite a bit beyond just a few CI-templates... The new name 'Unity-CI-CD' reflects better what it is now, and leaves room for where it’s headed next, and not just what it started as.
Seamless testing, multi-platform builds, releases & deploys for Unity.
See a live WebGL build deployed using this CI/CD pipeline:
Deployed via GitHub Pages using the
gh-pagesdeploy target.
1️⃣ Ensure your Unity project is in a GitHub repository
2️⃣ Copy the required GitHub Actions workflows from the CICD_Workflows folder
3️⃣ Add them to your repository at path: .github → workflows (create folders if missing)
4️⃣ Configure the required secrets in your repository
5️⃣ Read and optionally setup repository variables, they're important to understand the inputs for the workflow dispatch
6️⃣ Try dispatching the ci-cd-dispatcher.yml workflow or push a Git tag using SemVer to see the pipeline in action!
⚠️ Currently tested deploy targets:gh-pages(WebGL only),itch.io. Others are implemented but not yet fully verified. Contributions welcome!
For full setup instructions, deployment target guides, and advanced configuration tips, see the ➡️ Wiki
| Feature | Description |
|---|---|
| 🧪 Test Detection | Auto-detects and runs EditMode & PlayMode tests. |
| 🛠️ Cross-Platform Builds | Android, iOS, WebGL, macOS, Windows, and Linux supported. |
| 📦 Release Deployment | Automatically creates GitHub Releases on tag push. |
| 🧹 Modular Design | Fully split into reusable workflow_call templates. |
| ⚡ Parallel Matrix Builds | Parallel jobs across macOS and Ubuntu runners. |
| 🔐 Secure License Activation | Unity .ulf license securely injected during CI. |
| 🗃️ LFS & Cache | Optional Git LFS + caching of Unity Library and Packages/. |
| 🎛️ Manual Dispatch | Manually trigger preview builds with JSON platform control. |
| 🚀 Deploy | Upload builds to external platforms like itch.io, TestFlight, or custom servers |
| 📣 Notifications | Discord/Slack webhook support |
| 🔍 Static Analysis | C# linters or Unity analyzers |
While the pipeline is production-ready and modular, some deploy integrations are still marked as experimental:
-
🚧 Deploy targets like Steam, TestFlight, App Center
These are implemented but have not yet been fully validated in live release pipelines. -
🔗 External platforms may require manual setup
Some targets (like itch.io, Firebase, S3) require correctly configured secrets and accounts - be sure to test deploy flows in a safe sandbox environment before pushing to production. -
🧪 Unity version compatibility
Currently optimized for Unity 2022.3+, tested with Unity 6 too, but older versions may work as well.
Contributions and testing feedback are welcome!
If you successfully validate additional targets or add new ones, please consider opening a PR to improve support for the community.
Crafted with ❤️ by Avalin
Special thanks to RedGlow for contributions 💡
Powered by GitHub Actions + Unity + Tears.
(PRs welcome!)
