TaskWarrior Mobile App - Enhancing the User Experience with CCSync
Mentor
Mabud Alam
- Zulip Handle: https://ccextractor.zulipchat.com/#user/856060
Time Estimation
175 hours
Project Overview
TaskWarrior is a powerful command-line task management tool that helps users manage their tasks efficiently through a terminal interface. It offers task synchronization, advanced filtering, and script-based integration via CLI.
However, despite its power, TaskWarrior lacks a modern cross-platform graphical user interface (GUI) that can match its CLI capabilities. To bridge this gap, we built a Flutter-based mobile app for TaskWarrior that allows users to:
โ What We Achieved Last Year (2025)
Last year, we made significant progress by:
- ๐ Migrating most of the codebase to GetXfor better state management. - ๐พ Enabling sync with TaskServer 2.0 (TS 2.0). - ๐ฑ Improving the mobile app's usability and performance.
- Unit tests
However, a few key challenges still remain:
- Some parts of the app still use the old provider-based state management, so we want to complete the migration toGetX. - We haven't fully integrated CCSync/TaskServer 3.0(which we built separately), and our app only supports TaskServer 2.0. - We lack automated build releases (to F-Droid) and automated testing workflows. - There's no iOS home widgetfor quick task access. - Desktop optimization is still missing despite Flutter's growing desktop support.
โ Your Task for This Year (2026)
This year, we aim to finalize the TaskWarrior app by:
Completing the migration to GetX.**Extending sync support for CCSync (TaskServer 3.0)**without breaking existing TaskServer 2.0 support.Automating nightly builds via F-Droid and GitHub Actions.Building an iOS home screen widgetfor quick task access.Optimizing the app for desktop usage (macOS).Ensuring complete test coverage(unit, integration, end-to-end).Simplifying codebase architectureand reducing unnecessary bloat.Maintaining the core TaskWarrior philosophyโ minimal, fast, and powerful.
Key Deliverables
โ 1. Complete Migration to GetX (High Priority)
-
A large portion of the app has already been migrated to GetX, but some modules still useheavy setStatefor state management. - Your task will be to:
-
๐ Move the remaining sections to GetX. - ๐ก Ensure state management is clean, reusable, and optimized.
-
โ Remove redundant code and reduce app bloat.
-
๐ Move the remaining sections to
-
This will future-proof the app and improve scalability.
โ 2. Integrate CCSync (TaskServer 3.0) Without Breaking TaskServer 2.0
Current State:The app supports sync only withTaskServer 2.0.Goal:Extend support forCCSync/TaskServer 3.0without breaking existing TaskWarrior 2.0 functionality.Tasks:- ๐ Create separate data modelsfor TaskServer 2.0 and TaskServer 3.0. - ๐ก Implement an UI to allow user which taskserver they want to use for different profiles.
-
๐ก Provide seamless sync functionality for both versions.
-
๐ฌ Collaborate with CCSync developersto ensure full compatibility.
-
๐
๐ก Note: Some groundwork has already been done to integrate CCSync, so your job will be to improve, optimize, and finalize the integration.
โ 3. Build Full Test Coverage (Must-Have)
-
The app currently lacks complete test coverage. Your task will be to:
-
๐ Write unit testsfor all major functionalities. - ๐งช Implement integration teststo ensure seamless task sync. - โ Enable end-to-end testingusing Flutter integration tests. - ๐ Achieve at least 90% test coverageacross the codebase.
-
๐ Write
This will ensure production-level stability and prevent future bugs.
โ 4. Automate Nightly Builds (to F-Droid + GitHub Actions)
-
One major issue is that our app doesn't have automated builds.
-
Your task will be to:
-
๐ค Setup F-Droidfor nightly builds. - ๐ Create GitHub Actions CI/CD workflowsthat automatically:- Build APK and AAB packages.
-
Push releases to F-Droid. - Notify on failures via GitHub Actions.
-
๐ค Setup
-
This will drastically simplify app distribution for users.
โ 5. Develop an iOS Home Widget for Quick Task Access
-
Create an iOS home screen widget that allows users to:
-
โ View pending tasks.
-
โ Mark tasks as completed.
-
โ Add new tasks quickly.
-
This will significantly improve user retention for iOS users.
-
Android widget is already done : https://github.com/CCExtractor/taskwarrior-flutter/pull/417
โ 6. Optimize Desktop Support (macOS/Linux)
-
Since Flutter now supports desktop, we want to optimize TaskWarrior to:- โ Run smoothly on macOS/Linux/Windows desktops. - โ Provide a desktop-friendly UI/UX.
-
โ Sync tasks seamlessly across desktop and mobile.
-
โ Run smoothly on
-
This will position TaskWarrioras a powerful multi-platform task manager.
โ 7. Ensure No Feature Regression
- One of our biggest concerns is breaking existing functionality. - Your task is to ensure that:
- โ TaskServer 2.0 sync continues to work as-is.
- โ TaskServer 3.0 integration works without conflict.
- โ The app does not introduce unnecessary bloat or complexity.
โ 8. iOS App
- Release the first version of the Flutter app in AppStore
- Test all the features and make sure all works.
โ 9. Propose Minimalist Improvements (Optional but Appreciated)
- We don't want to make TaskWarrior bloatedlike other task managers. - However, we encourage you to propose:
- Minimalist UI improvements.
- Feature enhancements that align with TaskWarrior's philosophy. - Improvements that boost productivity without adding complexity.
โ Why Is This Project Important?
By completing this project, you'll help:
- ๐ Make TaskWarrior a powerful cross-platform task manager. - ๐ Provide seamless sync between mobile, desktop, and CLI.
- ๐ฒ Improve the overall user experience for TaskWarrior users.
- ๐พ Ensure TaskWarrior remains fast, minimal, and focused.
We don't want bloat โ we want efficiency, speed, and simplicity.
โ Tech Stack
Here's the preferred tech stack:
Frontend:
- โ Flutter + Dart(mandatory). - โ GetXfor state management.
CI/CD:
- โ GitHub Actions. - โ F-Droidfor nightly releases.
Testing:
- โ Flutter Test / Integration Test.
๐ Ready to Contribute?
๐ Start the Qualification Task
๐ฌ Questions? Put your questions in Zulip.
๐ Helpful Resources
inthe.am- Open-source TaskWarrior sync server.Freecinc fork- Self-hosted TaskWarrior server.Golang TaskServer- Alternative TaskServer.Wingtask- Task management stack.
โ We're super excited to see how you contribute. Let's make TaskWarrior the most powerful open-source task manager โ without any bloat! ๐