CodeFocus - Productivity & Ad Blocking Extension

A powerful browser extension that helps you stay focused and block distractions while working or studying. CodeFocus combines website blocking, ad blocking, and focus timer features in one simple interface.

✨ Features

• Ad Blocking: Blocks intrusive ads and trackers across all websites
• Focus Mode: Block distracting websites during work sessions
• Whitelist: Allow specific websites even in focus mode
• Block Counter: Track how many ads and trackers have been blocked
• Customizable: Set your own focus session duration and break times
• Sync Across Devices: Settings are synced with your Google account

🚀 Installation

From Chrome Web Store (Recommended)

Manual Installation

1. Download the latest release or clone this repository
2. Open Chrome and go to chrome://extensions/
3. Enable "Developer mode" (toggle in the top-right corner)
4. Click "Load unpacked" and select the extension directory
5. Pin the extension to your toolbar for easy access

🛠️ How to Use

Blocking Distractions

1. Click the CodeFocus icon in your browser's toolbar
2. Block Websites:
   • Add websites to block during focus sessions
   • Toggle focus mode on/off
   • Set custom focus session durations

Ad Blocking

• Automatically blocks ads and trackers
• View blocked ads counter in the popup
• Whitelist specific sites where you want to allow ads

Focus Timer

• Start a focus session with your preferred duration
• Take scheduled breaks between sessions
• Customize work/break intervals in settings

⚙️ Customization

You can customize the extension by:

1. Modifying Defaults:

   • Edit background.js to change default blocked sites
   • Adjust timer settings in popup.js
   • Update the block list in the extension settings

2. Theming:

   • Customize colors and styling in popup.css
   • Add your own icons in the icons folder

🛡️ Privacy

CodeFocus is designed with your privacy in mind:

• All processing happens locally in your browser
• No data is collected or sent to external servers
• Open source and transparent code

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details.

📄 License

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

🙏 Support

If you find this extension useful, please consider giving it a ⭐️ on GitHub or leaving a review on the Chrome Web Store.

---

Made with ❤️ by [Your Name]

Permissions

This extension requires the following permissions:

• storage: To save your blocked sites and preferences
• tabs & webNavigation: To monitor and block website navigation
• alarms: For the focus timer functionality

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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