Skip to content
Tasquera Logo Tasquera Docs

Android & Capacitor

Tasquera runs as a high-performance native Android application powered by Capacitor 8, giving you full offline capability, system-level alarms, and seamless filesystem sync.

Native Android Features

  • Scheduled OS-Level Notifications: Tasks with due dates and reminder times are registered with Android’s system alarm manager via @capacitor/local-notifications, firing alerts reliably even when the app is completely closed or your phone is asleep.
  • Syncthing Folder Sync (Documents/Tsqsync/): Reads and writes tasquera-sync.json directly to public storage, allowing background peer-to-peer sync with desktop instances via the Syncthing Android app.
  • Storage Permission Onboarding: Clear, guided permission flow for Android 11+ (API 30+) devices requiring All files access (MANAGE_EXTERNAL_STORAGE).
  • In-App APK Updater: Built-in GitHub Releases updater in Settings → Check for updates that notifies you when a new release is published and lets you download and install the latest APK with one tap.
  • Edge-to-Edge Dark & Light Themes: Configures an edge-to-edge transparent system status bar and matches system dark/light aesthetics.
  • Android Back Button & Gesture Navigation: Seamless support for Android system back gestures, modal dismissals, and bottom navigation sheets.

Building the Android APK

Automated Build Script (Windows / PowerShell)

Tasquera provides an automated PowerShell build script that bundles web assets, updates Capacitor Android targets, and invokes Gradle:

Terminal window
npm run build:apk

The compiled APK will be output to ./android/app/build/outputs/apk/debug/ (or release).

Manual Build via Android Studio

Terminal window
# 1. Build production web bundle and sync native assets
npm run build:android


# 2. Launch native Android Studio project
npm run cap:open

In Android Studio:

  1. Select Build → Build Bundle(s) / APK(s) → Build APK(s).
  2. Transfer the generated .apk file to your Android device or deploy directly to a connected USB device / emulator.

Setting up Syncthing on Android

  1. Install Syncthing or Syncthing-Fork from F-Droid or Google Play.
  2. Open Tasquera on your phone, go to Settings → Enable Sync, and grant storage permission when prompted.
  3. In your Syncthing app, add a new folder:
    • Folder Path: /storage/emulated/0/Documents/Tsqsync/
    • Folder ID: tsqsync (matching your other devices)
  4. Share the folder with your desktop computer. Edits made on any device will synchronize automatically!