Add automated itch.io deployment workflow for master and tags #4

New issue

Open

opened 2026-06-16 09:11:13 +00:00 by floride · 0 comments

floride commented

2026-06-16 09:11:13 +00:00

Owner

Description

Set up an automated CI pipeline (Forgejo Actions runner) to build and deploy our Bevy game to Itch.io. The workflow should target two deployment streams: automated development builds from the master branch, and stable production releases when a version tag (v*) is pushed.

Technical Details

Create a workflow file.
Triggers:
Push to master branch (deploys to itch.io channel: dev).
Push to tags matching v* (deploys to itch.io channel: stable).
Jobs required:
Install system dependencies for Bevy compilation (e.g., alsa, udev on Linux runners).
Build target binaries (e.g., WASM/Web and/or Native Desktop).
Utilize the Itch.io butler CLI tool (via a pre-built action or binary download) to push the build artifacts.
Secrets needed: BUTLER_API_KEY must be configured in the repository settings.

Acceptance Criteria

Workflow triggers successfully on a merge to master.
Workflow triggers successfully and extracts the version string when a tag like v1.0.0 is pushed.
Artifacts are successfully compiled and delivered to the correct Itch.io channels without manual intervention.

## Description Set up an automated CI pipeline (Forgejo Actions runner) to build and deploy our Bevy game to Itch.io. The workflow should target two deployment streams: automated development builds from the `master` branch, and stable production releases when a version tag (`v*`) is pushed. ## Technical Details * Create a workflow file. * **Triggers:** * Push to `master` branch (deploys to itch.io channel: `dev`). * Push to tags matching `v*` (deploys to itch.io channel: `stable`). * **Jobs required:** * Install system dependencies for Bevy compilation (e.g., `alsa`, `udev` on Linux runners). * Build target binaries (e.g., WASM/Web and/or Native Desktop). * Utilize the Itch.io `butler` CLI tool (via a pre-built action or binary download) to push the build artifacts. * **Secrets needed:** `BUTLER_API_KEY` must be configured in the repository settings. ## Acceptance Criteria * [ ] Workflow triggers successfully on a merge to `master`. * [ ] Workflow triggers successfully and extracts the version string when a tag like `v1.0.0` is pushed. * [ ] Artifacts are successfully compiled and delivered to the correct Itch.io channels without manual intervention.

floride added the

Priority

High

Kind/Feature

labels

2026-06-16 09:11:13 +00:00

floride added reference feat/automatic-push-itch-io

2026-06-19 09:50:08 +00:00