[ceotjoe]

What and why

First dry run of release.yml (run 40008594203) failed in the Android and iOS jobs at bundle install: excon 1.7.2 (Gemfile.lock) requires Ruby >= 3.3, but the workflow hard-coded Ruby 3.2. Web and the version check passed, and the dry run did not wait for any environment (so environment: '' works).

• Add .ruby-version (3.3.6, same as FoxGrid) and have setup-ruby read it.
• The manual run had no visible choice. Add a publish checkbox (default off = dry run). Ticking it on a tag re-runs that release (e.g. a failed store upload); it fails fast on a non-tag ref, a tag/pubspec mismatch or a missing CHANGELOG section. The GitHub release is edited if it already exists.
• docs/release.md and CHANGELOG updated.

Verify

After merging, run Actions -> Release -> Run workflow on main with publish unticked: all three build jobs should pass and nothing is published.

🤖 Generated with Claude Code