Skip to content

Release 0.3.0 - #19

Merged
justintout merged 2 commits into
mainfrom
doc/release-0.3.0
Oct 5, 2026
Merged

justintout merged 2 commits into
mainfrom
doc/release-0.3.0

Conversation

@justintout

@justintout justintout commented Oct 5, 2026 •

Copy link
Copy Markdown
Owner

Bumps the version to 0.3.0, adds the CHANGELOG entry for #17 and #18, and adds a Release workflow that follows the process in justintout/systemone.

The tag is the result of a release, not the trigger. After this merges, run Release from the Actions tab on main. It runs the tests, then checks that pubspec.yaml holds a version that isn't tagged yet, that CHANGELOG.md has an entry for it, and that dart pub publish --dry-run passes. Only then does it push an annotated v0.3.0 tag and create the GitHub release from the CHANGELOG section. The tag push starts publish.yml, which publishes to pub.dev.

Differences from systemone:

  • pub.dev only publishes from a workflow started by a tag push. A tag pushed with GITHUB_TOKEN starts no workflows, so the tag is pushed with a deploy key (RELEASE_DEPLOY_KEY). The workflow fails early if the secret is missing.
  • The version lives in pubspec.yaml, so the release PR sets it. There is no bump input.
  • No version-advice workflow. systemone's uses Go's apidiff.

Before the first run:

  • Add a write-access deploy key and store its private key as the RELEASE_DEPLOY_KEY secret.
  • Optionally, add a release tags ruleset like systemone's, which blocks updating or deleting v* tags.

Don't push a v* tag by hand. That publishes a version no check has seen.

Follows the release process in justintout/systemone: the tag is the
result of a release, not the trigger. A maintainer runs Release on main.
It runs the tests, checks that pubspec.yaml holds an untagged version
with a CHANGELOG.md entry, and validates the package. Only then does it
tag and create the GitHub release.

pub.dev only publishes from a workflow started by a tag push, and a tag
pushed with GITHUB_TOKEN starts no workflows. The tag is pushed with a
deploy key so that publish.yml still runs.
@justintout
justintout merged commit 7684db6 into main Oct 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant