Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FlowDesk logo

FlowDesk

Turn focused time into meaningful progress.

A modern desktop workspace for organizing activities, tracking focus sessions, and understanding how your time is spent.

Electron desktop app Node.js SQLite


Your time, clearly organized

FlowDesk brings activities, focus tracking, and productivity insights together in one calm desktop experience. Create your own categories, start a distraction-free timer, and let every completed session become part of a clear picture of your day.

Highlights

  • Focused activity management — Create, organize, review, and remove activities and categories.
  • Distraction-free timer — Starting a session turns FlowDesk into a dedicated full-screen focus space.
  • Persistent sessions — Active and paused timers survive app restarts without losing elapsed time.
  • Meaningful dashboard — See today’s productive time, completed sessions, recent activities, and your most-used activity.
  • Flexible statistics — Explore time distribution by activity and compare daily progress across a week, month, or year.
  • Daily calendar — Jump directly to today or select any date to review its activities, durations, percentages, and dedicated chart.
  • Accurate history — Every insight is calculated from time actually recorded through completed focus sessions.
  • Safe cleanup — Removing an activity or category also keeps calendars, totals, and charts consistent.

The FlowDesk experience

  1. Create an activity and assign it to one of your own categories.
  2. Start a focus session when you are ready to work.
  3. Pause or resume whenever needed.
  4. Finish the session to record the time permanently.
  5. Review your progress through the dashboard, statistics, and calendar.

Getting started

Requirements

  • Node.js 20 or later
  • npm
  • No external database installation required

Install and launch

npm install
npm start

FlowDesk will open as a native desktop window.

Useful commands

Command Purpose
npm start Launch FlowDesk
npm run dev Launch in development mode
npm test Run the automated tests

Android

An offline Android WebView edition is available in the android directory. It uses its own private SQLite database and can be built with:

cd android
./gradlew assembleDebug

See android/README.md for the APK location and installation command.

Data and privacy

FlowDesk creates and manages a private SQLite database automatically on your computer. No database server, network connection, credentials, or manual import is required. Activities, categories, timers, and completed sessions remain under your control on your machine.

The original MySQL schema remains available in Database/schema.sql for future migrations or server-based deployments.


Make time visible. Make focus intentional.

About

FlowDesk is a modern desktop app for organizing activities, tracking focused work sessions, and visualizing productivity through statistics, charts, and a daily calendar.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages