Skip to content

Prachi9506/Focus-beta-Focus

Repository files navigation

Focus Beta Focus - Discipline Without Distractions

A powerful Chrome extension that helps you stay focused by blocking distracting websites during your designated focus hours. No more losing productivity to endless scrolling!

🎯 Features

πŸ”’ Smart Website Blocking

  • Block any website during your focus hours
  • Time-based scheduling (e.g., 9 AM - 5 PM)
  • Instant activation with one click

🧠 Psychology-Based Motivation

  • Motivational quotes on blocked pages
  • 10-second reflection countdown before override
  • Streak tracking with celebration effects
  • Visual progress indicators

⏰ Built-in Pomodoro Timer

  • 25-minute focus sessions
  • Integrated with blocking system
  • Audio notifications for session completion

πŸ“Š Focus Analytics

  • Daily streak counter
  • Time saved tracking
  • Blocking statistics
  • Progress visualization

🎨 Beautiful Design

  • Modern, clean interface
  • Smooth animations and transitions
  • Apple-level design aesthetics
  • Responsive popup and options pages

πŸ“¦ Installation

Install from Source (Developer Mode)

  1. Download the Extension

    • Extract the files to a folder on your computer by cloning the repo
  2. Enable Developer Mode

    • Open Chrome and go to chrome://extensions/
    • Toggle "Developer mode" in the top right corner
  3. Load the Extension

    • Click "Load unpacked"
    • Select the folder containing the extension files
    • The Focus Beta Focus icon should appear in your toolbar

πŸš€ Quick Start Guide

1. Set Your Focus Schedule

  1. Click the Focus Beta Focus icon in your toolbar
  2. Click the gear icon to open settings
  3. Set your focus hours (default: 9:00 AM - 5:00 PM)
  4. Enable scheduled blocking

2. Add Websites to Block

  1. In settings, scroll to "Blocked Websites"
  2. Type a website (e.g., youtube.com) and click "Add Site"
  3. Or use quick-add buttons for popular distracting sites
  4. Remove sites by clicking the Γ— button

3. Start Focusing

  1. Click the Focus Beta Focus icon
  2. Click "Start Focus Mode"
  3. The extension will now block your selected sites during focus hours

4. Use the Pomodoro Timer

  1. Click the Focus Beta Focus icon
  2. Click the tomato (πŸ…) icon
  3. Click "Start" for a 25-minute focus session
  4. Take breaks when the timer completes

πŸ›  Advanced Features

Emergency Override

  • If you absolutely need to access a blocked site:
    1. Click "Emergency Override" on the blocked page
    2. Wait through the 10-second reflection period
    3. Confirm (this will break your streak)

Statistics Tracking

  • View your focus statistics in the settings page
  • Track current streak, best streak, time saved, and daily blocks
  • Export your data for backup

Customization Options

  • Adjust override countdown time (5-60 seconds)
  • Toggle motivational quotes and celebration effects
  • Enable/disable streak warnings
  • Customize your blocked sites list

πŸ”§ Troubleshooting

Extension Not Working?

  1. Make sure Focus Mode is activated (green dot in popup)
  2. Check that your current time falls within your scheduled focus hours
  3. Verify the websites are correctly added to your blocked list
  4. Try refreshing the page or restarting Chrome

Sites Still Loading?

  1. Make sure you entered the correct domain (e.g., youtube.com not www.youtube.com)

Timer Not Working?

  1. Ensure Chrome allows notifications from the extension
  2. Check your computer's volume settings
  3. Try closing and reopening the popup

About

Focus Beta Focus – Block distractions, boost productivity. πŸ”’βœ¨ A Chrome extension that helps you stay focused by blocking distracting sites, tracking your streaks, and keeping you motivated with a Pomodoro timer and progress analytics.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors