Skip to content

CaspianG/focus-flow

Repository files navigation

Focus Flow

Focus Flow logo

A premium desktop focus timer for deep work rituals, calm breaks, and beautifully structured days.

Latest release Windows MIT license Languages

50/10 and 90/15 rhythms | session planning | gentle sound cues | Light / Dark / System themes

Download for Windows

Preview

Focus Flow light theme Focus Flow dark theme

Why Focus Flow

Focus Flow is a desktop timer for people who want a calm, premium workspace for structured focus. It supports classic 50 / 10 and 90 / 15 rhythms, pleasant audio transitions between phases, and day planning by sessions instead of one endless timer.

If you want to work through 2 sessions x 4 hours, the app can calculate that day in two ways:

  • Pure focus time: 4 hours means 4 hours of actual focus, with breaks added on top.
  • Full session length: 4 hours already includes both focus blocks and breaks.

That choice lives in Settings, so the planner adapts to the way you personally count work.

Features

  • Two deep-work presets: 50 / 10 and 90 / 15
  • Day planning by session count and session duration
  • Two accounting modes: Pure focus time and Full session length
  • Language switcher with persisted English / Russian UI
  • Theme modes: Light, Dark, and System
  • Gentle built-in sound cues with two sound profiles: Dawn and Glass
  • System tray mode: closing the window keeps the timer running in the background
  • Start, pause, skip, and reset controls
  • Progress overview for the current block, current session, and the full day
  • Persistent local state so your plan survives app restarts
  • Packaged as a desktop app with Electron

Download

The easiest way to use Focus Flow is from the GitHub Releases page.

Windows installer

  1. Download Focus.Flow.Setup.0.2.2.exe from the latest release.
  2. Run the installer.
  3. Launch Focus Flow from the Start menu or desktop shortcut.

Portable build

If you prefer to run it without installation, download Focus.Flow.Portable.0.2.2.zip, extract it, and open Focus Flow.exe.

Interface Language

Focus Flow opens in English by default for new installs. If you switch the interface to Russian in Settings, that choice is saved locally and restored automatically on future launches.

Background Timer

Closing the Focus Flow window hides it to the Windows system tray instead of stopping the app. Your active timer keeps running in the background, and you can reopen the window from the tray icon. Use Quit Focus Flow in the tray menu when you want to fully exit.

Create A Desktop Shortcut

If Windows does not create a shortcut automatically:

  1. Open the installed app folder or the unpacked portable folder.
  2. Right-click Focus Flow.exe.
  3. Choose Send to -> Desktop (create shortcut).

If you are running a local build from this repository, the executable is usually at:

release/win-unpacked/Focus Flow.exe

Tech Stack

  • Electron
  • React 19
  • TypeScript
  • Vite
  • Framer Motion
  • Vitest

Local Development

npm install
npm run dev

Build

npm run dist

This creates release artifacts in the release/ directory.

Testing

npm test

Project Structure

electron/              Electron main and preload processes
src/App.tsx            Main desktop UI
src/hooks/             App state and timer hooks
src/lib/               Planner, timer, sound, storage, and localization logic
src/styles.css         Visual system and theme tokens
docs/screenshots/      README screenshots and GitHub visual assets
build/                 Packaged app icon sources

License

Released under the MIT License.

Notes

  • Windows is the primary verified target right now.
  • macOS and Linux targets are configured in Electron Builder, but they still need real-device verification and signing before public distribution.

About

Minimal desktop focus timer for 50/10 and 90/15 deep-work sessions with session planning, light/dark themes, and English/Russian UI.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors