{"id":28092393,"url":"https://github.com/avalin/unity-ci-templates","last_synced_at":"2025-05-13T13:10:08.513Z","repository":{"id":285254041,"uuid":"957472567","full_name":"Avalin/Unity-CI-Templates","owner":"Avalin","description":"Unity CI/CD pipeline with multi-platform builds, releases, and deploys","archived":false,"fork":false,"pushed_at":"2025-05-08T15:20:36.000Z","size":17796,"stargazers_count":37,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-08T15:25:46.048Z","etag":null,"topics":["build-pipelines","ci-cd","cicd","deployment","deployments","game-dev","game-development","github-actions","unity","unity2d","unity3d"],"latest_commit_sha":null,"homepage":"https://avalin.dk/Unity-CI-Templates/","language":"ShaderLab","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Avalin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-30T13:13:18.000Z","updated_at":"2025-05-08T14:15:00.000Z","dependencies_parsed_at":"2025-04-17T01:25:54.241Z","dependency_job_id":"ea60e6e5-0c46-4cb9-847b-81e2047b09b0","html_url":"https://github.com/Avalin/Unity-CI-Templates","commit_stats":null,"previous_names":["avalin/ci-cd-unity-test-project","avalin/unity-ci-templates"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Avalin%2FUnity-CI-Templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Avalin%2FUnity-CI-Templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Avalin%2FUnity-CI-Templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Avalin%2FUnity-CI-Templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Avalin","download_url":"https://codeload.github.com/Avalin/Unity-CI-Templates/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253948439,"owners_count":21988957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["build-pipelines","ci-cd","cicd","deployment","deployments","game-dev","game-development","github-actions","unity","unity2d","unity3d"],"created_at":"2025-05-13T13:09:54.006Z","updated_at":"2025-05-13T13:10:08.452Z","avatar_url":"https://github.com/Avalin.png","language":"ShaderLab","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Unity CI/CD Pipeline\n\n**Robust GitHub Actions workflows for Unity projects. Automates testing, multi-platform builds, and GitHub Releases with modular, reusable design.**\n\n![CI](https://github.com/Avalin/CI-CD-Unity-Test-Project/actions/workflows/ci-cd-pipeline.yml/badge.svg)\n![License](https://img.shields.io/github/license/Avalin/CI-CD-Unity-Test-Project?color=blue)\n![Unity](https://img.shields.io/badge/unity-2022.3%2B-black?logo=unity)\n![Latest Release](https://img.shields.io/github/v/release/Avalin/Unity-CI-Templates)\n\n## 🌐 WebGL Demo\n\nSee a live WebGL build deployed using this CI/CD pipeline:\n\n➡️ [**Play the Demo**](https://avalin.github.io/Unity-CI-Templates/)\n\n\u003e Deployed via GitHub Pages using the `gh-pages` deploy target.\n\n\n## 🚀 Getting Started\n\n1️⃣ Ensure your Unity project is in a GitHub repository  \n2️⃣ Copy the required GitHub Actions workflows from the [CICD_Workflows folder](https://github.com/Avalin/Unity-CI-Templates/tree/main/CICD_Workflows)  \n3️⃣ Add them to your repository at path: **.github → workflows** _(create folders if missing)_\u003cbr/\u003e\n4️⃣ Configure the [required secrets](https://github.com/Avalin/Unity-CI-Templates/wiki/Required-Secrets) in your repository\u003cbr/\u003e\n5️⃣ Read and optionally setup [repository variables](https://github.com/Avalin/Unity-CI-Templates/wiki/Repository-Variables), they're important to understand the inputs for the workflow dispatch\u003cbr/\u003e\n6️⃣ Try dispatching the `ci-cd-dispatcher.yml` workflow or push a Git tag using [SemVer](https://github.com/Avalin/Unity-CI-Templates/wiki/Versioning-\u0026-Tagging) to see the pipeline in action! \u003cbr/\u003e\n\n\u003e ⚠️ Currently tested deploy targets: `gh-pages` (WebGL only). Others are implemented but not yet fully verified. Contributions welcome!\n\n## 📖 Documentation\n\nFor full setup instructions, deployment target guides, and advanced configuration tips, see the ➡️ [Wiki](https://github.com/Avalin/Unity-CI-Templates/wiki)\n\n## 📌 Features\n\n| Feature                        | Description |\n|-------------------------------|-------------|\n| 🧪 **Test Detection**            | Auto-detects and runs EditMode \u0026 PlayMode tests. |\n| 🛠️ **Cross-Platform Builds**     | Android, iOS, WebGL, macOS, Windows, and Linux supported. |\n| 📦 **Release Deployment**        | Automatically creates GitHub Releases on tag push. |\n| 🧹 **Modular Design**            | Fully split into reusable `workflow_call` templates. |\n| ⚡ **Parallel Matrix Builds**     | Parallel jobs across macOS and Ubuntu runners. |\n| 🔐 **Secure License Activation** | Unity `.ulf` license securely injected during CI. |\n| 🗃️ **LFS \u0026 Cache**               | Optional Git LFS + caching of Unity `Library` and `Packages/`. |\n| 🎛️ **Manual Dispatch**          | Manually trigger preview builds with JSON platform control. |\n| 🚀 **Deploy**                | Upload builds to external platforms like itch.io, TestFlight, or custom servers |\n| 📣 **Notifications**         | Discord/Slack webhook support |\n| 🔍 **Static Analysis**       | C# linters or Unity analyzers |\n\n\u003c/details\u003e\n\n## ⚠ Current Limitations\n\nWhile the pipeline is production-ready and modular, some deploy integrations are still marked as **experimental**:\n\n- 🚧 **Deploy targets like Steam, TestFlight, App Center**  \n  These are implemented but have not yet been fully validated in live release pipelines.\n\n- 🔗 **External platforms may require manual setup**  \n  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.\n\n- 🧪 **Unity version compatibility**  \n  Currently optimized for Unity 2022.3+, tested with Unity 6 too, but older versions may work as well.\n\n\u003e **Contributions and testing feedback are welcome!**  \n\u003e If you successfully validate additional targets or add new ones, please consider opening a PR to improve support for the community.\n\n---\n\n## 🙌 Credits\n\nCrafted with ❤️ by [Avalin](https://github.com/Avalin)  \nPowered by GitHub Actions + Unity + Tears.\n(PRs welcome!)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favalin%2Funity-ci-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favalin%2Funity-ci-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favalin%2Funity-ci-templates/lists"}