🍅 Pomodoro Buddy

Your productivity companion
Focus
25:00
TikTok
YouTube
Texts
Snack
Random
Other
Today's Goal 0 / 120 min

Settings

Privacy: everything stays on-device.

How to Use Pomodoro Buddy 🍅

Welcome to Pomodoro Buddy! Here's everything you need to know to make the most of your productivity sessions:

🍅 Pomodoro Timer

The Pomodoro technique is a time management method that uses a timer to break work into intervals, typically 25 minutes in length, separated by short breaks. When the timer starts, you'll be in Focus Mode, and when the break time hits, you'll automatically get suggestions for short activities!

How it works:

  • Click Start to begin your focus session
  • Work until the timer reaches zero
  • Take a break when prompted
  • Repeat to build consistent focus habits!
💼 Task Input

Type in what you're working on (e.g., "Finish Chapter 3" or "Code Review") and start the timer. You'll be able to focus better with clear goals for each session!

Pro tip: Be specific! Instead of "Work on project", try "Complete API documentation" - it helps your brain focus on a concrete goal.

⏱️ Preset Options

Choose from the following presets to match your work style:

  • Quick Focus (15/5) - Ideal for short, intense bursts of work. Perfect for quick tasks or when you're short on time!
  • Classic (25/5) - The standard Pomodoro interval: 25 minutes of focus, followed by a 5-minute break. Great for most tasks!
  • Deep Work (50/10) - Perfect for deep, uninterrupted focus. Use this when you need to dive deep into complex problems!

After every 4 focus sessions, you'll get a longer break to recharge! 🎉

🛑 Break Suggestions

After a focus session, take a break! Here are some suggestions that will appear:

  • 💧 Hydrate! Drink some water - your brain needs it!
  • 🧘 Breathe - Take 5 deep breaths to reset
  • 🚶 Walk around - Get your blood flowing with a 2-minute walk
  • 👀 Eye rest - Look at something 20 feet away to rest your eyes
  • 🤸 Stretch - Do a quick stretch to release tension
  • 🎵 Music - Listen to a favorite song to recharge

These suggestions are randomized each break, so you'll always get fresh ideas!

🚨 Distraction Button

If you get distracted during focus time, click the "I got distracted" button and log your distraction type. This helps you track how often distractions occur and identify patterns!

Available distraction types:

  • TikTok, YouTube, Texts, Snack, Random, or Other

Your distraction data is tracked weekly so you can see your top distractors and work on reducing them!

🏅 XP and Leveling System

Every focus minute gives you 1 XP! Gain enough XP, and you'll level up! 🎮

  • Complete focus sessions to earn XP
  • Watch your level increase as you build consistency
  • After 4 focus sessions, defeat the Boss Battle and celebrate! 🎉

The more you focus, the higher you level up - it's that simple!

📊 Stats & Tracking

Track your productivity with comprehensive stats:

  • Daily Focus Minutes - See how much you've focused today
  • Day Streak - Build consistency with daily focus sessions (includes 1 grace day per week!)
  • Weekly Recap - Get a summary of your week including top distractors
  • Heatmap - Visualize when you're most productive throughout the day
  • Task Breakdown - See how much time you've spent on each task

Click the 📊 Stats button to view your progress!

🎨 Themes & Customization

Make Pomodoro Buddy yours with customizable themes:

  • Default - Beautiful purple gradient
  • Minimal - Clean and simple gray theme
  • Study Café - Warm, cozy café vibes
  • Space - Dark space theme for night owls
  • RPG - Green forest theme for adventure

Go to ⚙️ Settings to change your theme and customize your experience!

💬 Message Modes

Choose your productivity companion's personality:

  • Hype Mode - Supportive and encouraging messages to keep you motivated! 💪
  • Roast Mode - Playful, sassy messages that keep you accountable (in a fun way!) 😏

Switch between modes in Settings to find what works best for you!

⌨️ Keyboard Shortcuts

Work faster with these keyboard shortcuts:

  • Space - Pause/Resume the timer
  • R - Reset the current session
  • N - Skip to the next session
  • ? - Show all keyboard shortcuts

Click the ⌨️ Shortcuts button anytime to see this list!

⚡ Advanced Features

Unlock more productivity with these advanced features:

  • Overtime Mode - Continue working past the timer if you're in the zone (toggle in Settings)
  • Hard Mode - Limit pauses or disable pausing entirely for maximum focus
  • Daily Goals - Set a daily focus minute goal and track your progress
  • Task List - Keep up to 5 tasks and quickly use them for your next Pomodoro
  • Session Review - Rate each session (Good/Distracted) to track your focus quality
  • Auto-start - Automatically start breaks or focus sessions

Explore ⚙️ Settings to enable and customize these features!

💡 Pro tip: Check out the "Settings" panel for more customizations and features!

⬆️ Back to Top

Welcome to Pomodoro Buddy! 🍅

How did that session go?

🎉

BOSS DEFEATED!

You've completed 4 focus sessions! You're on fire! 🔥

Keyboard Shortcuts

Space Pause/Resume
R Reset
N Skip
? Show shortcuts