Introduction
Thank you for using Pomofy! This guide will help you get the most out of your Pomodoro timer experience. Whether you're a new user or looking to explore advanced features, this comprehensive documentation covers everything you need to know about using Pomofy effectively.
1. Getting Started
What is Pomofy?
Pomofy is a beautiful, customizable Pomodoro timer designed to help you stay focused and productive. The app implements the proven Pomodoro Technique, which involves working in focused sessions followed by short breaks.
First Launch
- Open Pomofy on your device
- Set your timer duration by tapping the timer display on the home screen
- Set your break duration by tapping the break timer display
- Start your first session by tapping the play button
- Customize your experience using the settings options
Default Settings
- Work Timer: 45 minutes (2,700 seconds)
- Break Timer: 15 minutes (900 seconds)
- Font: Baloo 2
- Text Size: 50px
- Text Color: Dark gray
- Background: Default gradient
- Sound: Enabled
2. Core Features
Focus Lock
Focus Lock is Pomofy's advanced feature that helps you maintain concentration by blocking distracting apps during your work sessions. When enabled, it prevents you from accessing selected apps until your timer session completes.
How Focus Lock Works
- iOS: Uses Apple's Screen Time API to block selected apps during work sessions
- Android: Automatically blocks all non-system apps while allowing system apps to function
- App Selection (iOS): Choose which apps to block using Apple's Family Activity Picker
- Automatic Blocking (Android): Blocks all user-installed apps while keeping system apps accessible
Enabling Focus Lock
- Open Pomofy and go to Settings
- Find the Focus Lock toggle
- Turn on Focus Lock
- iOS: Grant required permissions and select apps to block when prompted
- Android: Grant required permissions (Overlay and Usage Access)
- Start your timer - Focus Lock activates automatically
Focus Lock Behavior
- Focus Lock only activates when a timer is running
- You cannot disable Focus Lock while a timer is active
- Apps are automatically unblocked when the timer completes
- iOS: Blocked apps show a "Restricted" message
- Android: Blocked apps show an "App Restricted" message
Timer Controls
- Start: Begin your work or break session
- Pause: Temporarily pause the timer
- Resume: Continue from where you left off
- Reset: Return to the original duration
- Stop: End the current session and move to the next phase
Work Sessions
- Set custom work durations from 1 minute to 23 hours 59 minutes
- Visual countdown with large, clear display
- Sound notification when session completes
- Automatic transition to break timer
Break Sessions
- Configure break durations to match your needs
- Different sound notification for break completion
- Option to skip breaks and continue working
- Visual indicator showing "Break Time"
Sound Notifications
- Gentle bell sound for work session completion
- Different bell sound for break completion
- Option to disable sounds in settings
- Volume follows device settings
3. Customization Options
Font Selection
- Free Users: Access to 20 popular Google Fonts
- Pro Users: Unlimited access to all Google Fonts
- How to change: Tap the font icon on the home screen
- Search: Use the search bar to find specific fonts
Text Size
- Range: 12px to 80px
- How to change: Tap the text size icon on the home screen
- Preview: See changes in real-time
- Recommended: 40-60px for most devices
Text Color
- Color Picker: Full spectrum color selection
- Quick Colors: 15 preset colors for quick selection
- How to change: Tap the color icon on the home screen
- Accessibility: High contrast options available
Background Options
- Solid Colors: Choose any color for your background
- Gradients: Beautiful preset gradient combinations
- Custom Images: Upload your own background images (Pro only)
- How to change: Tap the background icon on the home screen
4. Pro Features
What's Included in Pro?
- Unlimited Fonts: Access to all Google Fonts
- Premium Gradients: Exclusive gradient backgrounds
- Custom Images: Upload and use your own background images
- Ad-Free Experience: No advertisements or interruptions
- Priority Support: Faster response times for support requests
How to Upgrade to Pro
- Open Pomofy
- Tap the profile icon
- Select "Subscription"
- Choose the Pro plan:
- Pro (Lifetime): $9.99 one-time payment
- Complete the purchase through your app store
Pro Purchase Management
- Restore: Tap "Restore Purchases" in the subscription page
- Refunds: Contact your app store for refund requests
- Lifetime Access: One-time purchase provides permanent access to all Pro features
5. Account Management
Sign In with Google/Apple
- Benefits: Sync settings across devices
- Privacy: Only basic profile information is shared
- Security: Uses Google/Apple secure authentication
- How to sign in: Tap the profile icon and select "Sign in with Google/Apple"
Cloud Sync
- What syncs: Timer settings, customization preferences
- When it syncs: Automatically when you sign in
- Offline use: App works without internet connection
- Data storage: Secure Supabase cloud storage
Sign Out
- How to: Tap profile icon → Settings → Sign Out
- What happens: Local settings remain, cloud sync stops
- Re-sign in: Your settings will be restored
6. Troubleshooting
Common Issues
Timer Not Working
- Check sound settings: Ensure device volume is on
- Restart app: Close and reopen Pomofy
- Check permissions: Ensure app has necessary permissions
- Update app: Install the latest version
Settings Not Saving
- Check internet: Ensure stable internet connection
- Sign in again: Re-authenticate
- Clear cache: Restart the app
- Contact support: If issue persists
Customization Not Working
- Pro subscription: Some features require Pro
- App restart: Close and reopen the app
- Check storage: Ensure device has sufficient storage
- Update app: Install latest version
Sync Issues
- Check internet: Ensure stable connection
- Sign in again: Re-authenticate
- Wait: Sync may take a few minutes
- Contact support: If issue persists
Focus Lock Not Working
- Check permissions: Ensure all required permissions are granted
- iOS: Verify Screen Time is enabled in device Settings
- Android: Check Overlay and Usage Access permissions
- Restart app: Close and reopen Pomofy
- Restart device: If issues persist
Apps Not Being Blocked
- iOS: Check if apps are selected in Blocked Apps settings
- Android: Ensure system apps are allowed (they won't be blocked)
- Timer running: Focus Lock only works when timer starts running
- Permissions: Re-grant permissions if needed
Performance Issues
- Close other apps: Free up device memory
- Restart device: Clear system cache
- Update device: Ensure latest OS version
- Reinstall app: As a last resort
Sound Issues
- Check device volume: Ensure volume is not muted
- Check app settings: Verify sound is enabled in Pomofy
- Check device settings: Ensure app has audio permissions
- Test with other apps: Verify device audio works
App Information
System Requirements
- iOS: iOS 12.0 or later
- Android: Android 6.0 (API level 23) or later
- Storage: 50MB available space
- Internet: Required for sync and Pro features
Permissions
- Internet: For cloud sync and Pro features
- Storage: For saving settings and selecting custom images
- Audio: For timer completion sounds
Legal Information
Terms of Service
By using Pomofy, you agree to our Terms of Service, which can be found in the app under Settings → Legal → Terms of Service.
Privacy Policy
Our Privacy Policy explains how we collect, use, and protect your data. Find it in the app under Settings → Legal → Privacy Policy.
FAQ
General Questions
Q: What is the Pomodoro Technique?
A: The Pomodoro Technique is a time management method developed by Francesco Cirillo. It involves working in focused 25-minute sessions followed by short breaks to maintain concentration and prevent burnout.
Q: Can I use Pomofy offline?
A: Yes! Pomofy works perfectly offline. Only cloud sync and Pro features require internet connection.
Q: How do I sync my settings across devices?
A: Sign in with your Google/Apple account, and your settings will automatically sync across all your devices.
Q: Can I customize the timer sounds?
A: Currently, Pomofy uses preset sounds for timer completion. Custom sounds may be added in future updates.
Pro Features
Q: What's the difference between Free and Pro?
A: Free includes basic timer functionality with limited fonts and gradients. Pro includes unlimited fonts, premium gradients, custom images, and ad-free experience. For future updates, Pro will include more features and enhancements.
Q: How do I upgrade to Pro?
A: Tap the profile icon → Subscription → Choose the Pro plan → Complete purchase through your app store.
Q: Can I get a refund for my Pro purchase?
A: Refund requests are subject to your app store's policies. Contact your app store for refund requests.
Q: Do Pro features work offline?
A: Most Pro features work offline, but custom images require internet for initial upload.
Technical Support
Q: The app crashes when I open it
A: Try restarting the app, then your device. If the issue persists, contact support with your device information.
Q: My settings aren't syncing
A: Check your internet connection and try signing out and back in. Contact support if the issue continues.
Q: The timer sound isn't working
A: Check your device volume and ensure sound is enabled in Pomofy settings. Verify the app has audio permissions.
Q: How do I reset all my settings?
A: Go to Settings → Reset All Settings. This will restore default values but won't affect your account.
Focus Lock Questions
Q: What is Focus Lock?
A: Focus Lock is a feature that blocks distracting apps during your work sessions to help you maintain concentration. It prevents you from accessing selected apps until your timer session completes.
Q: How do I enable Focus Lock?
A: Go to Settings → Focus Lock → Turn on the toggle. On iOS, you'll be prompted to select apps to block. On Android, you'll need to grant required permissions.
Q: Why can't I disable Focus Lock while timer is running?
A: This is by design to ensure you complete your work session. Focus Lock prevents distractions and can only be disabled when no timer is active.
Q: Can I choose which apps to block on Android?
A: On Android, Focus Lock automatically blocks all non-system apps while keeping system apps accessible. This ensures comprehensive blocking without manual configuration.
Q: What permissions does Focus Lock need?
A: iOS requires Screen Time permission and Family Activity Selection. Android requires System Alert Window (Draw overlay) and Usage Access permissions. These are only used for app blocking functionality.
Thank You
Thank you for choosing Pomofy! We're committed to providing you with the best Pomodoro timer experience possible. If you have any questions or feedback, please don't hesitate to reach out to our support team.
Happy focusing! 🎯
Last updated: October 2025
Support Email: nosiahstudio@gmail.com