Skip to content

lupinesse/work-log

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

285 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Work Log

ADHD-friendly work tracker — single HTML file, runs locally in your browser.

Screenshots

Overview

Today's Tasks

Timeblock

Pomodoro

Focus Mode

How to use

Important: The tracker needs to run via a local server (not opened directly as a file) so your data saves correctly between sessions.

Windows

  1. Download work-log.html, launch.bat, and start-server.ps1 into the same folder
  2. Double-click launch.bat
  3. The tracker opens automatically in your browser

Linux / Mac

  1. Download work-log.html and launch.sh into the same folder
  2. Open a terminal in that folder and run:
    bash launch.sh
    
  3. The tracker opens automatically in your browser

Your data is stored locally in your browser — nothing is sent anywhere.

Features

Time tracking

  • Live timer — start a timer on any task, pause and resume, add a handoff note when stopping
  • Time log — every logged entry shown with duration, epic, and billable flag
  • Billable tracking — mark epics and individual entries as billable; totals shown per task and per day
  • Quick pick — recent tasks shown as chips for fast re-logging

Tasks

  • Today's tasks — To do / In Progress / Done with epic colour coding
  • Task subtasks — split any task into child steps; completing all steps completes the parent
  • Deadlines — date picker with overdue (red) and due-today (amber) highlighting
  • Auto-carry — unfinished tasks roll over to the next day automatically
  • Jira import — paste a Jira CSV export to bulk-add tickets as tasks
  • Completion history — done tasks shown for 14 days with timestamp, then expire by iteration

Focus mode

  • Focus screen — one-click distraction-free view showing only the active task and next steps
  • Parked thoughts — capture stray thoughts mid-focus without leaving the screen
  • Pomodoro timer — 5 / 10 / 20 min ring timer with session log; visible in focus mode

Planning

  • Today's meetings — fetched live from Outlook calendar (Windows); shows time, duration, Teams join link
  • Timeblock — visual 08:00–18:00 grid auto-filled from logged entries; drag to rearrange
  • Day streak — consecutive days with logged work

Export & review

  • End the day — one-click summary with test areas and tomorrow's notes, exported as .txt
  • Auto-backup — JSON backup saved automatically on end-of-day to a local JSON backups/ folder
  • Reflection — end-of-day focus-quality and energy ratings with an optional note

Bullet Journal (BuJo) features

  • Rapid logging✏️ button opens a floating capture panel; Enter starts the timer immediately
  • Signifiers — clickable symbol on each entry cycles through meeting / flagged / migrated / cancelled / overtime; cancelled entries are excluded from totals
  • Daily Log — tab view merging time entries, log notes, and task updates in a single chronological feed
  • Monthly Log — heatmap of hours per day with intensity colouring; monthly summary and task inventory
  • Migration — end-of-month close-out flow: carry forward, reschedule, or drop each open task
  • Trackers — custom 28-day progress grids with a daily target and streak counter
  • Sprints — intention-first focus sessions: declare an outcome, run a Pomodoro, then record yes / partly / no

Info widgets

  • Weather — current conditions, rain forecast, sunrise/sunset (Helsinki)
  • Moon phase — current phase, illumination %, and zodiac sign
  • Finnish nameday — fetched live from nimipaivat.fi

Project documentation

Document Purpose
ARCHITECTURE.md Module map, data flow, and design decisions
DATA.md localStorage schema dictionary
CONTRIBUTING.md Dev setup, branching strategy, and quality standard
ROADMAP.md Planned and in-progress features
CHANGELOG.md Full release history
QA.md QA checklist and stakeholder sign-offs per release

Testing

A smoke test suite is included. Requires Node.js ≥ 22.12 (matches engines in package.json; bumped to track @commitlint/cli v21).

node smoke-tests.cjs

Or double-click run-tests.bat on Windows.

To schedule tests to run automatically each morning, run schedule-tests.bat once as Administrator.

To set up automated weekly releases every Friday, run setup-scheduler.ps1 once as Administrator.

About

ADHD-friendly work tracker — local-first, no account needed. Timer, tasks, Pomodoro, focus mode, Outlook calendar, timeblock planner, Jira import, and Notion sync.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors