bradcush / mark-tab-manager

Mark is a minimalist tab manager in the form of a browser extension that organizes tabs as you browse. With Mark, tabs are automatically grouped by domain and sorted alphabetically.

Mark tab manager

Automatically group tabs by domain

Store listings

Compatible with any browser powered by Chromium

• Chrome Web Store
• Edge Add-ons

Prerequisites

This repository requires Bun to be installed which is a drop-in replacement for any JavaScript bundler, transpiler, and runtime. Dependencies can be installed using bun install before building from source.

Compatibility

Mark is built as a Manifest Version 3 browser extension meaning that for Chrome, it's only supported in Chrome 89 and above. Edge Chromium is also supported in versions using the same Chromium version shipped in Chrome 89. This includes most versions of any Chromium based browser that also support a native grouping user interface. Firefox and Safari both support Manifest Version 3 but do not support native tab groups.

Manifest files

See the MANIFEST.md for information on manifest files in general, the overall manifest generation process, and associated generate script with examples.

Building

• Not minified with source maps: bun build:dev
• Minified without source maps: bun build:prod

Testing

Unit tests without coverage are automatically run as part of the GitHub CI for both a commit push and pull request. They are required for any pull request to be merged into the main branch. Integration testing has been setup but there is currently no need for any at the moment.

Unit testing: bun test:unit

Linting

Linting using eslint is also automatically run as part of the GitHub CI for both a commit push and pull request. It is also run locally before committing using a pre-commit hook. There must be no errors for any pull request to be merged into the main branch.

Linting: bun lint

Running

After having built the extension locally, using Chrome greater than version 88, navigate to the chrome://extensions page and make sure "Developer mode" is enabled in the top right of the window. Then clicking the button in the top left of the window labeled "Load unpacked", select the folder in the root of this project named dist. If your extension is not automatically activated you can click the toggle for the extension labeled "Mark tab manager".

Onboarding

For additional functionality and control you can pin the extension to your toolbar by clicking on the puzzle icon in the top right of your Chrome toolbar. Then click the pin icon next to the extension labeled "Mark tab manager".

Dependency information

See the PACKAGE.md for package.json information

Releasing

Creating a release version is done by pushing a tag on the main branch representing that specific version following the accepted format. (eg. v0.1.43) Only explicit collaborators have been given the necessary permission to push these tags.

Note: Versions in the package.json and extension manifest file should be incremented manually and merged in a pull request prior to releasing in order to match the subsequent release tag.

License

Mark Apache License 2.0