Create commits & pull requests easily. Cominnek is based on TAYO by Minnek.

• Requirements
• Install
• Update
• First Step
• Usage
• Ticketing System

• Git

1. Download installer

2. Run installer (See MAC Os steps)

3. Now you can run

cominnek -v

Next we will see how to install cominnek in WSL 2 and the necessary packages for authentication.

1. Open the terminal.
2. Download Package

wget https://github.com/Minnek-Digital-Studio/cominnek/releases/latest/download/cominnek-4.0.0.deb

3. Install package cominnek.deb

sudo dpkg -i ./cominnek-4.0.0.deb

4. Verify Installation

cominnek -v

If you have problem with xdg-open follow this steps

1. Install xdg-utils

sudo apt-get install xdg-utils

2. Add repository of wsl utils

sudo add-apt-repository ppa:wslutilities/wslu

3. Update

sudo apt update

4. Install wsl utils

sudo apt install wslu

After mounting the installer maybe you would have some issues at the moment to run the installer on Mac since OS blocks the installer app. So you will need to run the installer.sh manually.

1. Open the terminal.

2. Move into Volumes directory.

$ cd  /Volumes/cominnek-$version/

3. Run the bash installer

$ sudo bash installer.sh

You can get the latest version of cominnek by running the following command:

cominnek update

Login into your GitHub account

cominnek auth login

Then you can test the connection with the:

cominnek auth test

• Init: Initialize cominnek.
• Update version: Create and push a commit with the correct template for conventional commits.
• Push: Commit and push the branch to GitHub.
• Publish: Commit, push and create the pull request as a draft to develop in GitHub.
• Commit: Commit the changes to the branch.
• Branch: Create a new branch.
• Stash: Stash changes from one branch to another one.
• PR: Create a Pull Request as a draft to develop in GitHub.
• Merge: Merge the branch into the received branch.
• Reset: Reset the branch to the selected commit.
• Release: Release a new version. (⚠️ Experimental)
• Update: Update the cominnek version.
• Config: Configure the cominnek.
  • PR: Configure the pull request template.
• Auth: Configure the GitHub authentication.
  • Login: Login into your GitHub account.
  • Test: Test the connection with GitHub.
  • Logout: Logout from your GitHub account.

Initialize cominnek.

cominnek init

This will create a .minnekrc.json file in the root of your project.

Create and push a commit with the correct template for conventional commits.

cominnek update-version <version>

the commit will be: build: update version to <version>

Commit and push the branch to GitHub

cominnek push -m "do some modifications" --fix "home"

the commit will be: fix(home):{Ticket} do some modifications

{Ticket} is the ticket number See more information in the Ticketing system

* required

Commit, push and create the pull request as a draft to develop in GitHub. the commit will be: feat(home):{Ticket} do some modifications

The usage is the same as push just with the difference that this creates a pull request.

cominnek publish -m "do some modifications" --fix "home"

Will commit the changes to the branch.

cominnek commit -m "do some modifications" --fix "home"

the commit will be: feat(home):{Ticket} do some modifications

{Ticket} is the ticket number See more information in the Ticketing system

* required

Create a new branch with the prefix feature/, bugfix/, hotfix/ or release/ and the name of the branch will be the ticket number.

We are following a Git-Flow variant called TAYO by Minnek

cominnek branch feature "<Ticket>"

This the equivalent of: git branch feature/{Ticket}

* required

Stash all the changes in the current branch and apply the changes to another branch.

cominnek stash "<Branch>"

Create a pull request as a draft directly to develop

cominnek pr

The flag --ticket is optional. If it's not provided this will take the ticket number from the current branch.

In a case of a release branch, it will create a pull request to master and develop.

Merge the current branch into the received one. This will help you save time when you are working on a feature branch and you want to merge, for example, the feature branch into the test branch.

cominnek merge "<branch>"

* required

Reset the current branch to the selected commit. By default, it will reset to the last commit.

cominnek reset

This the equivalent of: git reset --soft HEAD~1

⚠️ This is an experimental feature. You can report any issue here

Release a new version using semantic versioning

cominnek release

Update the Cominnek version.

cominnek update

Configure the cominnek.

cominnek config -h

This command will help you to modify the pull request template.

cominnek config pr -b path/to/template.md

* required

In some cases, you will want to set some dynamic values, for example, ticket number.

# Example

- Ticket: ${ticket}
- Branch: ${branch}

This command will help you to set the GitHub token.

cominnek auth -h

This command will help you to set the GitHub token.

cominnek auth login

This command will help you to test the GitHub token.

cominnek auth test

This command will help you to remove the GitHub token.

cominnek auth logout

You can add a body to commit using the --message flag twice.

cominnek push -m "Changes in home page" -f "home" -m "the title was aligned to right"

This is the same as git commit -m "fix(home):{Ticket} Changes in home page" -m "the title was aligned to right"

{Ticket} is the ticket number See more information in the Ticketing system

To do a commit without a scope, use the flag and on windows, you should use it with a space.

Mac Os and Linux:

cominnek push -m "theme setup" -b

Windows:

cominnek push -m "theme setup" -b " "

the commit will be: build: theme setup

Move your changes to a new feature branch

cominnek feature "<Ticket>" -s

This takes the ticket number from the branch name. This is important to create the pull request with the correct ticket number.

Example:

You are in the branch feature/MJ-11

The ticker number will be MJ-11

If you execute the command:

cominnek push -m "Changes on homepage" -F "home"

the commit will be: feat(home): MJ-11 Changes on the homepage

This going to let you know that you are not in a feature branch and you will accept the commit without a ticket number.

Example: You're in the branch develop

$ cominnek push -m "Changes in home page" -F "home"
  This is not a feature. Do you want to continue? (yes or no)
        Commit message: "feat(home): Changes in home page"

If you want to contribute to this project, please read the contributing guide

Cominnek V4.0.0

With ❤ by isaacismaelx14

This project is maintained and funded by Minnek.

We ❤️ open source and do our part in sharing our work with the community! See our other projects or hire our team to help build your product.

Want to join? Check out our Jobs!