A productivity timer based on the Flowmodoro method, designed with cognitive psychology principles to maximize flow state and minimize anxiety.
Flowmodoro is a web application that implements the Flowmodoro productivity method, a variant of the traditional Pomodoro technique that respects your natural work rhythm. Unlike Pomodoro which forces you to work in fixed 25-minute blocks, Flowmodoro allows you to work until you naturally need a break, rewarding you with proportional rest time based on your effort.
- Respects your Flow: Does not interrupt your concentration with arbitrary alarms
- Rewards Effort: The more you work, the more rest you earn (5:1 ratio)
- Reduces Anxiety: Minimalist design hides seconds to avoid time obsession
- Encourages Honesty: The registration system makes you aware of your real productivity
For detailed information about how Flowmodoro works and its technical architecture, please refer to the documentation in the docs/ folder:
- Business Rules & Philosophy: Explains the Flowmodoro method, state machine logic, psychology-first design principles, and cognitive limits of deep work.
- Technical Documentation: Details the technology stack, project structure, component architecture, and the
useFlowmodorocomposable API.
# Install dependencies
npm install
# Development (hot-reload)
npm run dev
# Production build
npm run build
# Preview build
npm run preview