Skip to content

GITFLOW.md

Latest commit

 

History

History
21 lines (12 loc) · 1.64 KB

GITFLOW.md

File metadata and controls

21 lines (12 loc) · 1.64 KB

Gitflow and CI

Branch model

  • Default branch: develop. All PRs merge into develop; release or hotfix branches may target main when used.
  • Feature branches: Create from develop with npm run start-feature (or ./scripts/start-feature.sh). The script creates branches named e.g. feature/name, fix/name, chore/name, docs/name, hotfix/name, or release/name.
  • Alpha branch: alpha is the release-candidate branch. When you merge (or push) to alpha, the Publish Alpha workflow runs and builds Docker images to GitHub Container Registry. PRs targeting alpha are used when cutting a release. See PUBLISH.md.

When CI runs

CI does not run on push to develop or main, and it does not run automatically when a PR is opened or updated. It runs only when an OWNER, MEMBER, or COLLABORATOR comments /test on a pull request. A reaction (e.g. rocket) is added to the comment; on success or failure a PR comment and commit status are posted.

Comment-Triggered CI: This keeps Actions usage and branch-protection checks under maintainer control and avoids CI runs from untrusted or high-volume PRs.

Validate job

The job runs: checkout, Node 24, npm ci, npm run build, npm run lint, npm run type-check. No database migration step is run unless one is added later.

Repository setup

For one-time GitHub configuration (labels, branch protection, default branch), see repo-management/GITHUB-SETUP.md. See also repo-management/BRANCH-PROTECTION.md and repo-management/GITHUB-LABELS.md.