/trueblock

A simple website blocker extension for Chrome.

Primary LanguageTypeScriptMIT LicenseMIT

TrueBlock

The simple website blocker which blocks websites and helps you remember why you blocked them.

This extension is a heavy-handed blocker whose purpose is to block entire domains. If you want more granular blocking control, we recommend using a different tool.

Install

Get TrueBlock for Chrome

Usage

First, visit the site you wish to block.

Then, click the extension icon (T for "TrueBlock") next to the address bar to open the extension.

Extension popup

The popup page will show the domain of the current tab. This is the domain that will be blocked.

Optionally, you may enter a reason for blocking the domain.

Finally, click the "Add site to blocklist" button to block the domain.

You can visit the extension options page to view this note later, to remind yourself why you blocked the domain. Right-click the extension icon, then select "Options".

Extension options

For Developers

System requirements:

  • Node.js >= 18.6.0
  • NPM >= 8.14
  • Overmind

Getting started:

  1. Install dependencies

    npm install
  2. Run build watcher

    bin/dev
  3. Load the unpacked extension from the "dist" directory

    https://developer.chrome.com/docs/extensions/mv3/getstarted/#unpacked

Roadmap

General

  • Show "Success" when adding new site to blocklist
  • Form validation states
  • Add tests :)
  • Mutation tests

License

MIT.