The One-Click Unity to Itch.io Pipeline

Unity to Itch.io CI/CD Pipeline Toolkit

Automated WebGL builds and Itch.io deployments using GitHub Actions.

You just fixed a critical bug at 2 AM during a game jam. The last thing you want to do is manually build your project, zip the folder, open a terminal, and type out another butler push command—hoping you didn’t miss a step.

This toolkit automates the entire process. Once installed, every push to your GitHub repo triggers a clean WebGL build and uploads it directly to your Itch.io page.

What It Does

• Automates Unity WebGL builds using GitHub Actions

• Automatically deploys your latest build to Itch.io

• Runs every time you push to your GitHub main branch

• Frees you from the build-and-publish grind so you can stay focused on game development

How It Works

This toolkit uses a GitHub Actions workflow and a Unity build script to automate your CI/CD pipeline:

1. GitHub Actions detects a push to your main branch

2. It spins up a virtual machine and runs the included Unity build script

3. The finished WebGL build is published to your specified Itch.io channel using butler

What’s Included

• main.yml – Pre-configured GitHub Actions workflow

• BuildAutomationTool.cs – Unity C# script that auto-selects enabled scenes and builds your game cleanly

• README.md – Step-by-step setup guide with detailed instructions for:

  • Installing and authenticating butler

  • Setting GitHub repository secrets

  • Connecting your Itch.io account

  • Running your first automated build

Requirements

• Unity 2022.3 LTS or newer

• Git-based Unity project hosted on GitHub

• Active Itch.io account

License

This toolkit is provided under the MIT License. You may use it in any number of personal or commercial projects. Redistribution or resale of the toolkit itself is not permitted.