GitHub repository snapshots
GitHub repository snapshots
If part of what you deliver is code, you can attach a snapshot of a GitHub repository — at an exact commit — as a deliverable, held under the same lock-until-paid protection as any other file.
Steps
- Go to Settings → Integrations and find the GitHub card.
- Click Connect and install the Handl GitHub App on your organisation, choosing which repositories to allow.
- When adding a deliverable to a milestone or invoice, choose Repo snapshot and select the repository and branch.
- Handl captures the current commit and prepares a downloadable snapshot tied to that exact point in your code's history.
- The snapshot follows the same lock-until-paid rules as any other deliverable — visible as Locked once the linked invoice is sent, and released automatically once it's paid.
Good to know
- The snapshot captures the repository at a specific commit, so your client gets exactly the code that corresponds to what they've paid for — not whatever's currently on the branch.
- Installing the GitHub App only needs doing once per organisation; after that, any repository you've allowed can be used for a snapshot.
- Large repositories are supported, though very large ones may take a little longer to prepare.
FAQs
Does this replace my normal Git hosting or CI/CD? No — it's purely for handing a client a point-in-time copy of the code as part of a paid deliverable.
Can I attach a snapshot from a private repository? Yes, provided you've allowed that repository when installing the GitHub App.
What if I need to update the snapshot later? Attach a new snapshot from the latest commit — the previous one remains tied to its original invoice.