Skip to content

smile-plzz/BalanceFLow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Work-Break Balance App

A single-tap web app for balancing work and break cycles to enhance productivity and well-being. This app is designed for simplicity and can be easily deployed to GitHub Pages.

Features

  • Single-Tap Control: Start and end work/break sessions with a single button.
  • Customizable Durations: Users can set custom work and break durations, overriding the 1:1 ratio.
  • Real-Time Digital Timer: Displays elapsed and remaining time with millisecond precision.
  • Analog Second Hand: Visualizes time progress with a sweeping second hand on an analog clock face.
  • Local Time Display: Shows the current local time in the header.
  • Progress Bar: Visual representation of work/break progress.
  • Color-Coded Modes: The UI changes color to indicate whether you are in a "Work" (blue) or "Break" (green) session, with dynamic progress bar colors.
  • Persistent State: Automatically saves and restores your current timer progress and session data, even if the app is closed.
  • Daily Session Log: Tracks and displays a log of all completed work and break sessions for the current day.
  • Stopwatch Functionality: A separate, full-featured stopwatch with start, stop, reset, and lap capabilities.
  • Improved Labeling: Clear and descriptive button labels guide you through the app's flow.
  • PWA Support: Installable on mobile devices and works offline.
  • Keyboard Shortcuts: Use the spacebar to toggle sessions.

How to Use

  1. Open the App: Open the index.html file in your web browser, or access it via the deployed GitHub Pages link.
  2. Start Working: Click the "Start Work" button to begin your first work session.
  3. End Work Session: When you're ready for a break, click the "End Work, Start Break" button. The app will automatically start a break session of equal duration.
  4. Take a Break: The timer will count down your break time.
  5. Resume Work: Once the break is over, the app will notify you. Click "End Break, Start Work" to begin the next cycle.
  6. Pause/Resume: You can pause and resume the timer at any point without losing your progress.
  7. Session Log: View your completed sessions for the day in the "Today's Sessions" log at the bottom of the page.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published