Week Progress

55% elapsed WEEK PROGRESS

Week Progress is a lightweight, single-file HTML page that shows how much of the current work week (Monday–Friday) has elapsed — with a live progress bar, day-of-week indicator, and hours remaining.

Includes an optional toggle to extend tracking to the full 7-day week.

Inspired by yearprogress.

Features

• Live progress bar — animated bar showing elapsed percentage, updated every second
• Day of week indicator — shows current day name and ISO week number
• Hours remaining — real-time countdown of hours and minutes left in the work week
• Weekend detection — automatically shows "Enjoy your weekend!" on Saturdays and Sundays
• 7-day toggle — switch between Mon–Fri work week and full 7-day week tracking
• Persistent preference — your toggle choice is saved in localStorage
• Dark theme — deep dark background with orange accent (#ff6b35)
• Responsive — works on desktop, tablet, and mobile
• Zero dependencies — no CDN, no frameworks, no external resources
• Single file — everything (HTML, CSS, JS) in one file, ready to deploy

How It Works

The page calculates week progress entirely in the browser using JavaScript's Date API. The flow:

flowchart TD
    A[Get current date & time] --> B[Get day of week]
    B --> C{Is it weekend?}
    C -->|Yes| D[Show 100% with ☕ weekend message]
    C -->|No| E[Set Monday 00:00 as week start]
    E --> F[Set Friday 23:59 as week end]
    F --> G[Calculate elapsed time from Monday]
    G --> H[Compute progress = elapsed / total work week]
    H --> I[Update progress bar width]
    H --> J[Display percentage]
    H --> K[Compute time remaining]
    K --> L[Display hours & minutes left]
    B --> M{Include weekends toggle?}
    M -->|On| N[Use Sunday–Saturday 7-day week]
    N --> E
    M -->|Off| E
    H --> O[Schedule next update in 1 s]

The default work week is Monday 00:00 to Friday 23:59 (120 hours). When the 7-day toggle is enabled, the full Sunday–Saturday week (168 hours) is used instead.

Live Demo

🔗 soumendrak.github.io/weekprogress/

Usage

1. Open index.html in any modern browser.
2. No build step, no server, no installation required.
3. Deploy on GitHub Pages, Netlify, or any static host.

# Clone the repo
git clone https://github.com/soumendrak/weekprogress.git
# Open directly
open weekprogress/index.html

License

Licensed under the MIT License.

_{Built with ❤️ and zero dependencies}