Taskwarrior Mobile App

A cross-platform Flutter client for Taskwarrior.

---

Table of Contents

• About
• Screenshots
• Built With
• Getting Started
• Syncing
  • TaskChampion (recommended)
  • Legacy TaskServer
• Contributing
• Community
• Project Timeline
• License
• Contact

---

About

Taskwarrior is free and open-source software that manages your TODO list from the command line. It is flexible, fast, and unobtrusive. The CLI tool and its documentation live at taskwarrior.org.

This project brings that workflow to mobile and desktop: manage your tasks, filter them, and keep them in sync across all your devices.

Screenshots

Built With

• Dart
• Flutter
• Rust — TaskChampion storage/sync via flutter_rust_bridge
• GetX — state management and routing

Getting Started

Prerequisites

• Flutter — this repo pins the SDK with FVM in .fvmrc.
• Android Studio (Android) and/or Xcode (iOS/macOS).
• Optional: a Rust toolchain with cargo-ndk if you want to rebuild the native libtc_helper.so yourself. Android builds fall back to the committed libraries under android/app/src/main/jniLibs/.

Run the app

# Clone
git clone https://github.com/CCExtractor/taskwarrior-flutter.git
cd taskwarrior-flutter

# Install the pinned SDK and dependencies (FVM)
fvm install
fvm flutter pub get

# Check your setup
fvm flutter doctor

# Run (production or nightly flavor)
fvm flutter run --flavor production
fvm flutter run --flavor nightly

If you are not using FVM, run the same commands with flutter and make sure your SDK matches the version in .fvmrc.

Syncing

The app supports two sync backends. TaskChampion is the modern one and is recommended for new setups.

TaskChampion (recommended)

The app syncs through TaskChampion. You can use WingTask as a hosted TaskChampion sync server to keep your tasks in sync across devices. Point the app at your server URL, client ID, and encryption secret.

Legacy TaskServer

TaskServer lets you share tasks across clients and devices, and keeps an automatic backup of your data.

Self-hosted TaskServer

• Official setup guide: taskserver-setup
• Video tutorial: Watch on YouTube
• Cloud hosting: run it on Azure or any other cloud provider for access from anywhere.
• Docker: ogarcia/docker-taskd

Contributing

Contributions of every kind are welcome — features, fixes, refactors, performance work, and documentation. See CONTRIBUTING.md for the full guide, and the Contribution Guidelines & Development Practices wiki page.

Found a bug? Open an issue.

Please prefix commits and pull requests with a type:

feat: a new feature
fix:  a bug fix
test: everything related to testing
docs: everything related to documentation

Community

Join the gsoc-taskwarrior channel of the CCExtractor community on Slack:

Project Timeline

This project started as a Google Summer of Code project. See the GSoC project page.

For help getting started with Flutter, see the online documentation.

License

Distributed under the GNU General Public License v3.0. See LICENSE for the full text.

Contact

• Nishant Singhal
• Mabud Alam

Project link: CCExtractor/taskwarrior-flutter