Skip to content

adityabh2007/deep-focus

Repository files navigation

DeepFocus

Block distractions. Start focus sessions. Stay locked in.

DeepFocus is a minimalist Chrome extension designed to help you stay focused by blocking distracting websites during timed sessions. Choose your discipline level—Easy Mode for flexibility or Hard Mode for zero compromises.


Features

  • Timed Focus Sessions
    Set a duration and stay locked in until the timer ends.

  • Custom Site Blocking
    Add any websites you want to block (e.g., YouTube, Instagram, etc.).

  • Easy Mode
    Allows temporary overrides using "End Session" button

  • Hard Mode
    No bypass. No excuses. Stay committed till the end.

  • Real-time Progress Tracking
    Visual timer and session progress in the popup.

  • Clean Block Screen UI
    Minimal and motivating interface when you hit a blocked site.


Installation

  1. Go to the Releases section of this repository

  2. Download the latest .zip file

  3. Extract the zip file

  4. Open Chrome and go to:

    chrome://extensions/
    
  5. Enable Developer Mode (top right)

  6. Click Load Unpacked

  7. Select the project folder


How It Works

  • Start a focus session from the popup
  • Select:
    • Mode (Easy / Hard)
    • Duration
    • Sites to block
  • During the session:
    • Blocked sites redirect to a focus screen
    • Easy mode allows temporary override
    • Hard mode enforces strict blocking

Tech Stack

  • Chrome Extension (Manifest V3)
  • JavaScript (Vanilla)
  • Chrome APIs:
    • storage
    • tabs
    • alarms

Project Structure

├── manifest.json
├── background.js       # Service worker (core logic)
├── popup.js            # Popup UI logic
├── popup.css           # CSS
├── popup.html          # Extension screen
├── blocked.html        # Block screen UI
├── rules.json          # (Reserved for future use)
├── icons/              # Extension icons

Future Improvements

  • Sync across devices
  • Statistics / focus analytics
  • Custom motivational messages
  • Whitelist mode
  • Dark/Light theme toggle

License

MIT License


Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.


Support

If you find this useful, consider giving the repo a star.

About

DeepFocus is a minimalist Chrome extension that blocks distracting websites during focus sessions. Choose between Easy Mode (temporary overrides) or Hard Mode (no escape), and stay locked into what truly matters.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors