A browser extension to generate these for you, based on the ticket you're working on.
At bitcrowd we love conventions. One of them is how we name branches and commits. This makes it easy to relate a particular branch or commit to a certain ticket.
Branches follow the format type/id-title
by default, where:
type
is usually one of:feature
(default)bug
chore
- …
id
is the identifier of the ticket in your ticketing systemtitle
is a lowercase, dasherized version of the ticket title
Commits contain [#id] title
by default.
Additionally, Tickety-Tick generates commands to set up a branch with the proper name and to prepare the commit message for your source code management tool. Out of the box, it is set up to work with Git.
If you need your commit messages, branch names or commands to look different, you can configure Tickety-Tick to use a custom format.
Here is a short example for how a possible workflow with Tickety-Tick could look like:
demo.mp4
Tickety-Tick helps you create branches and commits for a few ticket systems.
Currently, we support:
Your ticket system is missing? Go ahead and implement an adapter for it! We are always happy about contributions and here to support you 👋.
Tickety-Tick is available for every major browser:
- Chrome/Chromium
- Firefox
- Opera
- Safari - experimental 🧪
Manually install the extension if you want to use an older version or a beta version.
Click here for instructions
Download and unpack a chrome.zip
file from the releases. Then navigate to the chrome://extensions page, enable "Developer mode", press "Load unpacked extension" and point to the unpacked folder.
Download a tickety_tick-<version>.xpi
file from the releases and open it in Firefox.
Download and unpack a chrome.zip
file from the releases. Then navigate to the opera:extensions page, enable "Developer mode", press "Load unpacked extension" and point to the unpacked folder.
Shortcut | Description |
---|---|
Ctrl + t | Open the extension's popup dialog |
In order to build the extension from source, run:
yarn install
yarn checks
yarn build
To build an un-optimized version for development or debugging, use:
yarn build --mode=development
To only build for a specific browser, use:
yarn build:chrome
yarn build:firefox
Navigate to the chrome://extensions page, enable "Developer mode" and press "Load unpacked extension". Point it to the dist/chrome
directory. Done.
If you just want to try out and debug the extension, go to about:debugging#addons. Then press "Load Temporary Add-On" and select the built manifest.json
from the dist/firefox
extension directory.
If you want to install the extension permanently, you need to enable unsigned add-ons. Then go to about:addons, click on the small cog icon, select Install Add-on From File…
and choose dist/firefox
.
Navigate to the opera://extensions page, enable "Developer mode" and press "Load unpacked extension". Point it to the dist/chrome
directory. Done.
For development use yarn watch:[browser]
. This will watch the files and rebuild the extension whenever source files change.
To test-drive a development version, you can use:
yarn open:chrome
yarn open:firefox
You can run both watch:[browser]
and open:[browser]
scripts in parallel to automatically rebuild and reload the extension as you make changes.
- Debugging
- Firefox: use the developer tools to debug the extension
- Chrome: right-click
inspect
on the popup or the settings page to open a separate debugger
To execute the automated source code checks, run:
yarn checks
Or, to run checks individually:
yarn stylelint
yarn lint
yarn test
Hint: You can append --watch
and other options supported by Jest to the test command, e.g.:
yarn test --watch
The lint commands accept options supported by ESLint and stylelint, e.g.:
yarn lint --fix
yarn stylelint --fix
In order to generate code coverage reports locally, just run:
yarn test --coverage
To view an HTML version of the report:
open coverage/lcov-report/index.html
Chrome Web Store and Firefox Add-ons require you to submit extensions as a single zip archive. To build and zip the extension for a release, run:
yarn bundle:chrome
yarn bundle:firefox
Prepare the release by bumping the version and submitting the change as a pull request:
yarn prepare-release
Once the version change is on the main
branch, you can trigger the release process:
yarn release
You will be prompted for Mozilla Add-Ons and Chrome Web Store API credentials. Alternatively, if you have 1Password CLI installed and access to the Tickety-Tick
vault, it will only ask you for access there.
As mentioned earlier, in addition to branch names and commit messages, Tickety-Tick generates commands to set up a branch with the proper name and to prepare the commit message.
By default, the code generated for copying will look like this:
git checkout -b BRANCH-NAME && git commit --allow-empty -m COMMIT-MESSAGE
These default generated commands make a few assumptions:
-
You're using Git (obviously).
The branch names and commit messages Tickety-Tick generates may work with other version control systems, but the commands generated for copying specifically include Git.
-
You squash commits from feature branches (or you're okay with empty commits).
When you work with feature branches and you squash them before merging, Git (and GitHub) allow you to combine the messages of the feature-branch commits. The empty commit provides a simple mechanism for storing the commit message title generated by Tickety-Tick when setting up the branch.
This approach works nicely with our Git workflow, for which the above assumptions are true. Yours may be different though, in which case you might want to configure Tickety-Tick differently.
If you have different conventions regarding commit messages, branch names or you're just using a different source code management tool, Tickety-Tick allows you to customize the output format for all of these.
You can access the preferences page via the "Settings" link in the Tickety-Tick popup.
Tickety-Tick supports formatting generated commit messages according to these recommendations by Tim Pope. If you do not want this, you can disable this feature in the extension preferences (see above).