An open API service indexing awesome lists of open source software.

https://github.com/amowu/probot-conventional-release

A GitHub App built with Probot that creates GitHub Release following Conventional Commits
https://github.com/amowu/probot-conventional-release

conventional-commits probot probot-app semantic-release

Last synced: about 2 months ago
JSON representation

A GitHub App built with Probot that creates GitHub Release following Conventional Commits

Awesome Lists containing this project

README

        



# GitHub Conventional Release Bot

[![Build Status](https://travis-ci.org/amowu/probot-conventional-release.svg?branch=master)](https://travis-ci.org/amowu/probot-conventional-release)

> A GitHub App built with [Probot](https://github.com/probot/probot) that creates [GitHub Release](https://help.github.com/articles/about-releases/) following [Conventional Commits](http://conventionalcommits.org/).

## Usage

1. Install and configure the GitHub App: [github.com/apps/conventional-release-bot](https://github.com/apps/conventional-release-bot)
2. Add commit that message structure should following [Conventional Commits](http://conventionalcommits.org/)

```
[optional scope]:

[optional body]

[optional footer]
```

3. Push commits (or merged PR) to master branch, and then the [GitHub Release](https://help.github.com/articles/about-releases/) will be created

![1_luxfee4jnww2lr9_22sdca](https://user-images.githubusercontent.com/559351/34299744-8a5f42da-e75f-11e7-8dcb-5ca9044759b3.png)

1. Git tags (based on [SemVer](https://semver.org/))
2. Release date
3. Release types: **Bug Fixes**, **New Features** and **BREAKING CHANGES** (follow [Conventional Commits](https://conventionalcommits.org/)'s type)
4. Commit's scope (follow [Conventional Commits](https://conventionalcommits.org/)'s scope)
5. Commit's description
6. Commit's SHA
7. Commit's author
8. Diff with last release

## Developer Guide

Follow the [Configure a GitHub App](https://probot.github.io/docs/development/#configure-a-github-app) section of Probot document to create your GitHub App

### Requirements

- node >= 8.9.3
- yarn >= 1.3.2

### Permissions

![34095403-40e42ca2-e40c-11e7-9fe6-eb28864bfc46](https://user-images.githubusercontent.com/559351/34300324-79da2bde-e762-11e7-983f-3178dbdef8cf.png)

### Subscribe to events

![34095741-8fbe3a6a-e40d-11e7-923d-e2e959c724ab](https://user-images.githubusercontent.com/559351/34300322-76582b32-e762-11e7-8b31-c7afaef50843.png)

### Installation

Clone repository:

```
$ git clone https://github.com/hahow/probot-conventional-release.git
```

Install packages:

```
$ yarn install
```

Run Probot server:

```
$ yarn start
```

### Deployment

You can deploy the app to [Glitch](https://probot.github.io/docs/deployment/#glitch), [Heroku](https://probot.github.io/docs/deployment/#heroku) or [Now](https://probot.github.io/docs/deployment/#now).