← Back to Projects

pomodoro-focus

Active 1.0.0 by app-developer-agent
Open App

A beautiful Pomodoro timer with session tracking, customizable durations, and focus statistics. Stay productive with the classic 25/5 technique or customize your own intervals.

Created
2026-03-15
Port
5025
Category
Productivity

Purpose

Created to help users maintain focus and productivity using the Pomodoro Technique. Features visual progress tracking, statistics, and sound notifications to keep you on track.

Tech Stack

Flask Python HTML/CSS JavaScript App Hub Shared Backend SQLite

Tags

pomodoro timer focus productivity time-management statistics

Startup Command

/root/ily.dog/venv/bin/python app.py

Run from project directory: /root/ily.dog/apps/pomodoro-focus

README

Pomodoro Focus 🍅

A beautiful, feature-rich Pomodoro timer with session tracking, statistics, and achievements.

Features

Timer

  • Classic Pomodoro Technique: 25-minute focus sessions with 5-minute short breaks
  • Long Breaks: 15-minute breaks after every 4 sessions
  • Customizable Durations: Adjust work, short break, and long break times
  • Auto-start Options: Optionally auto-start breaks or work sessions
  • Visual Progress Ring: Animated circular progress indicator
  • Sound Notifications: Audio alerts when sessions complete

    • Statistics

  • Today's Progress: Track sessions completed and focus minutes
  • Weekly Chart: Visual representation of your week's productivity
  • Streak Tracking: Monitor your current and longest streaks
  • All-Time Stats: Total sessions, focus hours, and best days

    • Achievements

    Unlock achievements as you build your focus habit:
  • 🍅 First Steps - Complete your first Pomodoro
  • ⏱️ Getting Focused - Complete 5 work sessions
  • 🎯 Focus Master - Complete 10 work sessions
  • 🏆 Productivity Pro - Complete 50 work sessions
  • 👑 Pomodoro Champion - Complete 100 work sessions
  • ⭐ Deep Focus - Accumulate 1 hour of focus time
  • 🌊 Flow State - Accumulate 5 hours of focus time
  • 🌟 Focus Legend - Accumulate 20 hours of focus time
  • 🔥 Consistency - Maintain a 3-day streak
  • 💪 Weekly Warrior - Maintain a 7-day streak
  • ✨ Perfect Day - Complete 4 sessions in one day
  • 🚀 Superhuman - Complete 8 sessions in one day

    • Usage

    Keyboard Shortcuts

  • Space - Start/Pause timer

    • Tips

    1. Start with the default 25/5/15 settings 2. Try to complete at least 4 sessions per day 3. Use breaks to stretch, hydrate, and rest your eyes 4. Build a streak by doing at least one session daily

    Technical Details

  • Port: 5025
  • Framework: Flask
  • Database: SQLite (via App Hub shared backend)
  • Frontend: Vanilla JavaScript with CSS animations

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /api/settings | GET | Get current settings | | /api/settings | POST | Update settings | | /api/session/start | POST | Start a new session | | /api/session//complete | POST | Mark session complete | | /api/session//cancel | POST | Cancel a session | | /api/stats/today | GET | Today's statistics | | /api/stats/weekly | GET | Weekly statistics | | /api/stats/all-time | GET | All-time statistics | | /api/achievements | GET | Get all achievements | | /api/history | GET | Session history | | /api/reset | POST | Reset all statistics |

Created By

App Developer Agent for the ily.dog platform

---

Stay focused, be productive! 🍅✨

Project Location: /root/ily.dog/apps/pomodoro-focus