Skip to content

Move to a main-only branching model - #529

Merged
rickdijk merged 1 commit into
mainfrom
chore/main-only-branching
Sep 16, 2026
Merged

rickdijk merged 1 commit into
mainfrom
chore/main-only-branching

Conversation

@rickdijk

Copy link
Copy Markdown
Contributor

✨ What kind of change does this PR introduce? (Bug fix, feature, docs update...)

Repository workflow change (CI config + docs), aligning with Baseflow's other repositories.

⤵️ What is the current behavior?

The repo runs a two-branch model: develop is the default and integration branch, main lags behind and is fast-forwarded at release time. CI triggers, CONTRIBUTING.md, AGENTS.md and the PR template all point contributors at develop. The core package's homepage embeds /tree/develop/, and the README's codecov badge points at a master branch that no longer exists.

🆕 What is the new behavior (if this is a feature change)?

main is the only long-lived branch and all PRs target it directly. CI triggers, contributor docs and the PR template reference main, and AGENTS.md states the branch policy as a hard requirement. The published homepage now points at the repository root so it can't break when a branch goes away, and the codecov badge points at main.

AGENTS.md also gains a Releases section documenting the existing tag-driven publish flow (tag on main; the tag push is what triggers pub.dev publishing via OIDC), which until now was undocumented.

The GitHub-side changes that accompany this — default branch, squash-only merges, branch protection on main, retargeting open PRs, and retiring develop — are applied separately in repository settings.

💥 Does this PR introduce a breaking change?

No.

🐛 Recommendations for testing

Confirm this PR's own checks run, which verifies the pull_request: branches: [main] trigger works. dart format --set-exit-if-changed . and flutter analyze pass locally for the core package; no Dart source changed.

📝 Links to relevant issues/docs

Matches the model used by flutter-permission-handler.

🤔 Checklist before submitting

  • All projects build
  • Follows style guide lines (code style guide)
  • Relevant documentation was updated
  • Rebased onto current main

🤖 Generated with Claude Code

Aligns this repo with Baseflow's other repositories (flutter-permission-handler):
main is the only long-lived branch and all PRs target it directly. Points CI
triggers, contributor docs and the PR template at main, and documents the
branch policy and the tag-driven release process in AGENTS.md so it holds for
future work.

Also drops the branch name from the published homepage URL and fixes the
codecov badge, both of which referenced branches that no longer apply.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@rickdijk
rickdijk merged commit 6d41478 into main Sep 16, 2026
10 checks passed
@rickdijk
rickdijk deleted the chore/main-only-branching branch September 16, 2026 00:33
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