Task Tracker

User Guide

1. Understanding the Layout

• Statistics Section: Overview of tasks and status of Sessions, including the Break Budget. Now includes total sprint time and estimated completion.
• Break Buttons: Below the stats, use these buttons to take a break from the Break Budget.
• Add Task Form: Create work sessions (with color choice!), manage Break Budget, and add tasks. Form is now wider.
• Kanban Board: Columns for "To Do", "In Progress", and "Done".

2. Managing Work Sessions

Work sessions group related tasks with a time budget.

• Adding: Use "Add New Session". Enter name, duration (Hrs/Mins > 0), and choose a color. Click "Add Session".
• Session Tags: Display remaining time and a progress bar. Click to select for adding tasks. Drag a session tag to "To Do" to create a task using its full remaining time.
• Deleting: Click '×' on a tag. Only if no tasks are assigned.
• Duration: Counts down when its tasks are "In Progress".

3. Managing the Break Budget

• Setting Duration: Use "Manage Break Budget" in the form.
• Tracking: Remaining time shown in Statistics.
• Low Budget (Auto-Replenish): If the Break Budget drops to 1% or less of its total capacity, the system will attempt to draw 10% of the total time from each available work session (that has remaining time) to replenish the Break Budget. This draw will not exceed a session's remaining time. The Break Budget will not exceed its configured total after replenishment. You'll be alerted if this happens.

4. Adding Tasks

• Select a Work Session (not Break Budget).
• Enter Task Description and Duration (mins).
• Click "Add Task to Session".
• Validation: Task duration cannot exceed selected session's remaining time.

5. Using the Kanban Board

• Moving Tasks: Drag tasks between columns.
• Status Changes:
  • To In Progress: Starts task & session timer. Ends any "Buffer Task".
  • Out of In Progress: Pauses timers. If "In Progress" becomes empty, a "Buffer Task" may start.
  • To Done: Marks complete, stops timer. If task timer finishes in "In Progress", it moves to "Done" automatically with a notification. Confetti!

6. Timers & Automatic Actions

• Task Timers: Individual countdown on task cards.
• Session Timers: Overall remaining time for each work session.
• Automatic "Done": Tasks auto-move to "Done" when their timer finishes in "In Progress". Tab title changes briefly.
• Automatic Buffer Task: If "In Progress" is empty (and no break is active), a "Buffer Task" starts, using Break Budget time. It stops if a work task enters "In Progress".

7. The Break Feature (Break Budget)

• Click a break duration button (e.g., Take 5 min Break).
• Requires sufficient Break Budget time.
• Deducts time, pauses work tasks (moved to "To Do"), starts a purple "Taking a Break" task.
• Break ends when timer finishes or break task is deleted. Work tasks resume.

8. Deleting Tasks & Sessions

• Task: Click '×' on task card.
• Session: Click '×' on session tag (if no tasks assigned).

9. Reset Application

• Click refresh icon, confirm. Deletes all data.

Enjoy the advanced tracking features!