A minimal, transparent, and automated setup to generate daily GitHub contributions using GitHub Actions.
This repository updates a small internal file once per day and commits the change automatically, ensuring consistent and legitimate activity on the GitHub contribution graph.
- GitHub Actions runs on a scheduled cron job
- A lightweight file (
.github/heartbeat.txt) is updated with the current timestamp - The change is committed automatically to the
mainbranch - Each successful run results in one valid GitHub contribution
This approach follows GitHubβs contribution rules and avoids unnecessary commit noise.
This project is useful for:
- Maintaining a consistent contribution streak
- Learning and testing GitHub Actions scheduling (cron)
- Understanding automated commits in CI/CD workflows
- Keeping your GitHub profile active during busy periods
- Serving as a reference template for automation-first repositories
β οΈ This project intentionally generates only one commit per day.
Multiple commits on the same day do not increase contribution count.
.
βββ .github
β βββ workflows
β β βββ daily.yml
β βββ heartbeat.txt