Repolode
Submit
googleapis

googleapis/release-please

Automates changelogs, GitHub releases and version bumps by parsing Conventional Commits into a release PR.

View on GitHubWebsite
Stars
7,655
Forks
615
Open issues
378
Last commit
3 days ago

What is it?

Release Please automates CHANGELOG generation, GitHub release creation, and version bumps. It reads your git history for Conventional Commit messages and keeps a release pull request up to date as new work is merged. When that release PR is merged, it updates the changelog and language-specific version files, tags the commit with the version number, and creates a GitHub Release.

It supports many project types, including Node.js, Python, Go, Java/Maven, Rust, Ruby, Dart, Helm, Terraform modules and more, and can handle monorepos through manifest configuration. It is available as a GitHub Action or a CLI. It does not publish packages to registries or manage complex branch workflows.

Key features

  • 01Generates release PRs that update as new commits are merged
  • 02Updates CHANGELOG files and language-specific version files on release
  • 03Tags releases and creates GitHub Releases automatically
  • 04Supports many release types such as Node.js, Python, Go, Rust, and Maven
  • 05Handles multiple packages in one repository via manifest configuration

Use cases

  • Automating changelogs and version bumps for an open-source library
  • Releasing several packages from one monorepo
  • Standardizing release workflows on repositories that use Conventional Commits

Quick start

  1. 1

    Use the GitHub Action (recommended); see the release-please-action repository for setup

  2. 2

    Or run the CLI; see docs/cli.md for all configuration options

Things to know

  • It does not handle publication to package managers or complex branch management.
  • Releases require commits that follow the Conventional Commits format.

Topics

#conventional-commits#changelog#semantic-versioning#github-action#release-automation#monorepo

FAQ

What is release-please?
Automates changelogs, GitHub releases and version bumps by parsing Conventional Commits into a release PR. Release Please automates CHANGELOG generation, GitHub release creation, and version bumps. It reads your git history for Conventional Commit messages and keeps a release pull request up to date as new work is merged. When that release PR is merged, it updates the changelog and language-specific version files, tags the commit with the version number, and creates a GitHub Release.
Is release-please free to use? What license does it have?
release-please is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is release-please still maintained?
Actively maintained. The last commit to release-please was on Oct 19, 2026.
What can I use release-please for?
Automating changelogs and version bumps for an open-source library Releasing several packages from one monorepo Standardizing release workflows on repositories that use Conventional Commits
How do I install release-please?
Use the GitHub Action (recommended); see the release-please-action repository for setup Or run the CLI; see docs/cli.md for all configuration options
Where can I get release-please?
The source code and installation instructions are on GitHub: https://github.com/googleapis/release-please

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects