Publish
Hyperstone can automatically publish your builds to itch.io, streamlining your distribution workflow. Once configured, you can deploy new versions with a single click.
Prerequisites
Before you can publish to itch.io, you need to configure your credentials in the organization settings:
- Navigate to Settings > Organization Settings
- Add your itch.io username
- Add your itch.io API key
See the organization settings documentation for detailed instructions on credential configuration.
Enabling Publishing
Toggle the "Publish to itch.io" switch in the build pipeline to automatically upload your build after export.
When enabled, Hyperstone will:
- Export your game build
- Package it for distribution
- Upload it to your itch.io project
- Update the specified channel
Channel Mapping
The channel you select in the build pipeline (e.g., linux-stable, windows-playtest) determines which itch.io channel receives the build. This allows you to maintain separate distribution channels for:
- Stable releases: Production-ready builds for your players
- Playtest builds: Beta versions for testing
- Custom channels: Any workflow-specific distribution needs
Published Builds
Once published, your build is immediately available on itch.io for download by your players.
The build appears in your itch.io dashboard with:
- The correct platform tag (Linux, Windows, etc.)
- The specified channel
- Version information
- Upload timestamp
Build Verification
After publishing, you can verify the upload by:
- Checking your itch.io dashboard
- Reviewing the build history in Hyperstone (shows publish status)
- Testing the download from itch.io
Troubleshooting
If publishing fails, check that:
- Your itch.io credentials are correctly configured in organization settings
- Your itch.io API key has the necessary permissions
- Your itch.io project exists and is accessible
- You have sufficient storage quota on itch.io