Taskfolio

Taskfolio is an Android task management app built using Google Tasks API. Developed to demonstrate my expertise in modern Android development, it highlights my skills in architecture, UI design with Jetpack Compose, OAuth authentication, and more—all packaged in a sleek, user-friendly interface.

I set out to revisit the classical TODO app, ‘local-first’ syncing with Google Tasks—aiming for an MVE in 2 weeks, focusing on the 80/20 rule to nail the essentials.

🎯 Project intentions

• Showcase my expertise in Android application development
• Demonstrate UI development using Jetpack Compose with Material Design 3.
• Include local-first capabilities for local data storage using Room.
• OAuth 2.0 authentication.
• Provide sync capabilities with Google Tasks for seamless task management.
• Illustrate my ability to set up CI/CD pipelines and publish apps to the Play Store.

❌ Out of scope

This project is not intended as a comprehensive task manager for public use. I do not aim to implement advanced features beyond what is supported by the Google Tasks REST API.

• no starred task
• no task priority
• only due date, no custom time support
• no task recurrence
• limited hierarchy (2 levels)

🚧 Known Limitations

• Authentication flow isn't 100% reliable yet.
• Local-first support with Google Tasks sync is limited, in particular sorting & conflict management is barely implemented.
• Task deletion undo is not implemented
• Very limited move capabilities
  • can't move task from one list to another
  • can't indent/unindent
  • can't create sub-task
  • no drag'n'drop
• Task list ordering isn't supported (there is no API for that in the Google Tasks API)

🛠️ Tech stack

• Kotlin, Multiplatform (KMP) (currently Desktop & Android are supported)
  • iOS & Web are not planned any time soon (contribution are welcome 🤝)
• Kotlin coroutines
• Kotlin multiplatform (aka KMP)
• Ktor client (+ Kotlinx serialization)
• Room (local persistance)
• Koin for dependency injection
• Material Design Components
• Jetpack Compose
• Kinda follows Google architecture guidelines
• Coil
• GitHub Actions for CI
  • build Android & Desktop apps
  • run tests
  • publish app on Play Store
  • publish companion website on Github pages

🗺️ Project breakdown

• :google
  • :oauth ■■■■■■■■■■ 100%
    • Google OAuth2 authentication with Kotlin & Ktor
    • KMP
  • :tasks ■■■■■■■■■■ 100%
    • Google Tasks REST API bindings for Kotlin using Ktor HTTP client
    • KMP
• :lucide-icons ■■■■■■■■■■ 100%
  • Lucide Icons for Compose
  • Made from Compose Icons (not using the direct Gradle dependency to tweak stroke width)
  • Only integrates what seem relevant for the app needs
  • KMP
• :tasks-core ■■■■■■□□□□ 60%
  • Taskfolio business logic
  • Local first with Room database, sync with Google Tasks
  • KMP
• :tasks-app-shared ■■■■■■■□□□ 70%
  • All screens & UI components integrating the :tasks-core business logic in Compose
  • KMP
• :tasks-app-desktop ■■■■■■■■■□ 90%
  • The Desktop application (thin layer fully reusing :tasks-app-shared)
• :tasks-app-android ■■■■■■■■□□ 80%
  • The Android application (thin layer fully reusing :tasks-app-shared)
• website/ ■■□□□□□□□□ 20%
  • The static site presenting the project
  • Made with Jekyll and served by Github pages

🧑‍💻 Local development

See details…

Decrypt `*.gpg` files needed for development, and copy decrypted versions in proper places.

PLAYSTORE_SECRET_PASSPHRASE=MY_SECRET ./_ci/decrypt_secrets.sh

Updating google-services.json

The production google-services.json file is ignored by SCM to avoid exposing API keys in public repository. To update it, download the new version, encrypt it using gpg --symmetric --cipher-algo AES256 google-services.json and store this in _ci/google-services.json.gpg. The decrypt_secrets.sh will take it into account.

⚖️ License

The MIT License (MIT)

Copyright (c) 2024 Olivier Patry

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.