Skip to content

ixismail/hushdoom

Repository files navigation

Hushdoom

Silence the feeds. Reclaim your focus.

Hushdoom is a Chrome extension that helps you reclaim your focus by hiding the main feeds on social and entertainment sites. Choose which platforms to block, show optional motivational quotes on blocked pages, and add or import your own quotes, all without sending any data outside your browser.


Get the extension

  • Chrome Web Store - Install Hushdoom in Chrome (or any Chromium-based browser).

Features

  • Block feeds on 13+ platforms - Turn blocking on or off per site. When blocking is on, the main feed is hidden and replaced with an optional quote and a link to manage the extension.

  • Motivational quotes on blocked pages - Show a random quote (built-in or your own) where the feed would be. You can turn this on or off.

  • Custom quotes - Add quotes manually, import from CSV (with a text,author header), use built-in quotes, or mix. All stored locally in Chrome.

  • Snooze - Temporarily disable blocking for all sites (e.g. 15 min, 1 hour, 3 hours) without changing your settings.

  • Privacy-first - Uses only Chrome’s storage permission. No analytics, no external servers; everything stays in your browser.


Supported platforms

Platform Domain
YouTube youtube.com
Instagram instagram.com
X / Twitter x.com, twitter.com
Facebook facebook.com
LinkedIn linkedin.com
Threads threads.com
GitHub github.com
TikTok tiktok.com
Snapchat snapchat.com
Pinterest pinterest.com
Reddit reddit.com
Tumblr tumblr.com
Bluesky bsky.app

Usage

  1. Open the options page - Click the extension icon and choose Options, or right‑click the icon → Options.
  2. Sites - Enable blocking for the platforms you want. The feed on those sites will be hidden when you visit them.
  3. Quotes - Toggle “Show quotes on blocked pages,” choose built-in or custom quotes, and add/import quotes as needed.
  4. Snooze - Use “Snooze All” to temporarily show feeds again for a set duration.
  5. On a blocked page, you’ll see the quote (if enabled) and a “Managed by Hushdoom - open extension” link.

Project structure

hushdoom/
├── manifest.json          # Chrome extension manifest (v3)
├── index.html             # Options page entry
├── src/
│   ├── main.jsx           # React entry
│   ├── App.jsx            # Options page layout & tabs
│   ├── background.js      # Extension background script
│   ├── components/        # React components
│   │   ├── About.jsx      # About tab
│   │   ├── Sites.jsx      # Platform toggles
│   │   ├── Quotes.jsx     # Quote settings & modals
│   │   ├── QuickSnooze.jsx # Quick snooze controls
│   │   ├── BlockedPageContent.jsx  # Quote + open extension on blocked pages
│   │   ├── PlatformCard.jsx
│   │   ├── ToogleButton.jsx
│   │   ├── SnoozeButton.jsx
│   │   ├── Header.jsx
│   │   ├── Navigation.jsx
│   │   ├── Footer.jsx
│   │   ├── AllQuotesModal.jsx
│   │   └── AddNewQuoteModal.jsx
│   ├── scripts/
│   │   └── script.js      # Content script (injected on matched sites)
│   ├── zustand/           # State stores (sites.store, quotes.store, snooze.store, hushdoom.store)
│   ├── constants/         # constants.js, plateforms.js, tabs.js, snoozeDurations.js, quotes.js
│   └── utils/             # pickRandomQuote.js, formatRemainingSnooze.js
└── package.json

Development scripts

Command Description
npm run dev Start dev server and watch for changes
npm run build Build for production (output in dist)
npm run preview Preview production build (Vite)

Tech stack

  • React 19 - UI for the options page
  • Vite 7 - Build tooling
  • Tailwind CSS 4 - Styling
  • Zustand - State management (sites, quotes, snooze)
  • @crxjs/vite-plugin - Build Chrome extension from Vite
  • React Icons - Icons

Contributing

  • Bugs - Open an issue.
  • New site - Suggest or upvote in GitHub Discussions.
  • Feature ideas - Share or upvote in the Ideas discussion board.
  • Code - PRs welcome for bug fixes and small improvements. Clone the repo, run npm install and npm run build, then load the dist folder in Chrome via Developer modeLoad unpacked.

Support the project


License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Hushdoom - Feed Blocker: Chrome Extension that block feeds on 13+ social platforms including YouTube, Instagram, X, TikTok, Reddit, and more. Replace them with custom motivational quotes, snooze blocking on demand, and regain your focus. Privacy-first: all settings stored locally in your browser, zero external data collection.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors