Git flow adapted by Terminal
Last updated 7 months ago by terminal-co .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install terminal-flow 
SYNC missed versions from official npm registry.


Git-flow adapted for Terminal repos

oclif Version Downloads/week License

alt text


$ npm install -g terminal-flow
$ tflow COMMAND
running command...
$ tflow (-v|--version|version)
terminal-flow/0.0.2 darwin-x64 node-v10.16.3
$ tflow --help [COMMAND]
  $ tflow COMMAND

Terminal Git Flow

We have flows for features and hotfixes. tflow automates the process of creating and merging these into our environments.

Environments rules

We have production (mapped to the production branch), staging (mapped to master branch) and development (mapped to develop branch).

Staging must branch off from production. Develop is free from staging/production and can be broken at times.

When an epic is finished and tested in develop, it must wait in its epic branch until we are ready to release it into production. When the time comes, the epic is merged into staging, tested and it's either reverted or released.

No commit goes directly into production unless its an emergency. The idea is that staging mirrors production all the time, so that new epics behave exactly the same way in staging and production.


Features are created from an epic branch, which groups many features that compose an epic.

  1. Create a feature (tflow feat start, git commit ..., tflow feat finish)

  2. Release a feature to develop (tflow release develop)

  3. Release a feature to staging (tflow release master). Don't do this until its ready to be released to production!

alt text


alt text

  1. Create the hotfix (tflow hotfix start)

  2. Release the hotfix to all envs (tflow hotfix finish)


tflow feat [SUBCOMMAND]

Start or finish a feature by branching from an epic branch

  $ tflow feat [SUBCOMMAND]

  -c, --create  force creation of an epic branch
  -h, --help    show CLI help

  $ tflow feat start: Create a new feature.
  $ tflow feat finish: Finishes the feature and creates a PR towards the epic branch.

See code: src/commands/feat.ts

tflow help [COMMAND]

display help for tflow

  $ tflow help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

tflow hotfix [SUBCOMMAND]

Start or finish a hotfix. A hotfix goes directly into all non-production environments

  $ tflow hotfix [SUBCOMMAND]

  -h, --help  show CLI help

  $ tflow hotfix start: Create a new hotfix branch.
  $ tflow hotfix finish: Finishes the hotfix and creates a PR towards dev and staging

See code: src/commands/hotfix.ts

tflow release [BRANCH]

Release an epic to a test environment

  $ tflow release [BRANCH]

  -e, --epic=epic        The name of the epic to release (will be prompted if left out)
  -h, --help             show CLI help
  -v, --version=version  The version to release (will be prompted if left out)

  $ tflow release develop

See code: src/commands/release.ts

Current Tags

  • 0.0.3                                ...           latest (7 months ago)

3 Versions

  • 0.0.3                                ...           7 months ago
  • 0.0.2                                ...           7 months ago
  • 0.0.1                                ...           7 months ago
Maintainers (1)
Today 0
This Week 0
This Month 2
Last Day 0
Last Week 1
Last Month 3
Dependencies (7)
Dev Dependencies (14)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |