A cute, privacy-first Pomodoro companion to help you stay focused.
Report Bug
·
Request Feature
·
Türkçe
Table of Contents
FocusBuddy is a privacy-first, open-source Pomodoro timer for Android, wrapped in a cozy, gamified experience. Choose a little animal companion, start a focus session, and let your buddy keep you company while you work. Complete sessions to earn XP, level up, unlock new companions, and build a daily streak.
This app is built for people who want a distraction-free, offline-friendly focus tool without ads, trackers, or subscription walls.
- Node.js (LTS recommended)
- npm or yarn
- Android Studio (for local Android builds)
- Java 17 or later
- Clone the repo
git clone https://github.com/toprakpt1/Focusbudy.git cd Focusbudy - Install dependencies
npm install
- Start the development server
npx expo start
- Build for Android (F-Droid / local APK)
The unsigned APK will be located at
npx expo prebuild --platform android cd android ./gradlew assembleReleaseandroid/app/build/outputs/apk/release/app-release-unsigned.apk.
- Pomodoro Timer — Focus & break cycles with customizable durations (10s test, 25 min, 45 min, 60 min)
- Animal Companions — Choose a buddy; unlock more as you level up
- XP & Level System — Earn XP for every completed session
- Daily Streaks — Keep your streak alive with consistent focus sessions
- Focus Heatmap — Visualize your productivity over time
- Themes — Warm pastel, Dark, and Paper themes
- Notifications — Session end and streak reminders (optional)
- Keep Screen On — Prevent display timeout during sessions
- Fully Offline — No internet required; no trackers, no ads
- Bilingual — English & Turkish support (more languages welcome!)
| Home & Timer | Profile & Stats | Shop |
|---|---|---|
 |
 |
 |
- Onboarding — Launch the app and pick your first companion.
- Start a Session — Tap "Start Focus" on the home screen.
- Stay Focused — Your buddy stays with you while the timer runs.
- Complete & Earn — Finish the session to earn XP and see confetti!
- Track Progress — Visit the Profile tab to see your streak, total focus time, and heatmap.
- Unlock Buddies — Level up to unlock new animal companions in the Shop tab.
- Pomodoro timer with customizable durations
- XP & level system
- Daily streaks
- Companion unlock system
- Focus heatmap
- Theme support (Warm, Dark, Paper)
- Notifications
- English & Turkish localization
- Widget support
- Session history & export
- More companions & moods
- Wear OS support
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
FocusBuddy - A privacy-first Pomodoro companion.
Copyright (C) 2026 Toprak Talha Karcılar
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
See the LICENSE file for the full license text.
FocusBuddy is designed with privacy in mind:
- Zero network permissions required for core functionality
- No analytics, crash trackers, or ads
- All data is stored locally on your device
- Fully functional offline
Toprak Talha Karcılar — @toprakpt1
Project Link: https://github.com/toprakpt1/Focusbudy