Skip to content

furkanmavili/x-simple-block

Repository files navigation

X Simple Block 🚫

A lightweight Chrome extension that adds convenient block and mute buttons to X (formerly Twitter) posts, allowing you to quickly manage your feed with a single click.

✨ Features

  • 🎯 One-click block and mute buttons for each post
  • 🔄 Real-time feed updates after blocking/muting
  • 💾 Persistent settings across browser sessions
  • 🌙 Automatic dark/light theme detection
  • 🎮 Simple popup interface for button visibility control
  • 🔒 Minimal permissions required
  • 📊 Block counter badge on extension icon

🚀 Installation

From Chrome Web Store

  1. Visit the Chrome Web Store
  2. Click "Add to Chrome"
  3. Follow the prompts to complete installation

Local Development Installation

  1. Clone the repository
git clone https://github.com/yourusername/x-simple-block.git
  1. Install dependencies
pnpm install
  1. Build the extension
pnpm build
  1. Load in Chrome:
    • Open Chrome and navigate to chrome://extensions/
    • Enable "Developer mode" in the top right corner
    • Click "Load unpacked"
    • Select the dist folder from the cloned repository

🐛 Bug Reports

Found a bug? Please open an issue with:

  • Clear bug description
  • Steps to reproduce
  • Expected vs actual behavior
  • Screenshots (if applicable)
  • Browser version and OS

Buy Me A Coffee