Reflectodoro

A Pomodoro app whose real point is forcing a short self-reflection ("what did I do?") at the end of every break, enforced via a hard-to-dismiss overlay. Built with Tauri 2 + SvelteKit.

Download the latest build · Project page

See CLAUDE.md for architecture and data model.

Pre-requisite

https://v2.tauri.app/start/prerequisites/

Run it in development

Run the Desktop app in development

npm install
npm run tauri dev

Run the Android app in development

npm run tauri android dev

This launches the app in an Android emulator or a connected device over USB debugging. Some behavior is native-only and can't be exercised this way from a desktop emulator alone (the "Display over other apps" permission prompt, persistent break notifications, and audio focus pausing) — see CLAUDE.md's "Android" section for how those work.

Run the iOS app in development

npx tauri ios dev "iPhone 17 Pro"

Use npx tauri ios dev, not npm run tauri ios dev — tauri-wrapper.js re-splits its arguments on spaces, so a simulator name passed through npm arrives as several separate arguments. tauri ios init/dev install libimobiledevice/ios-deploy via Homebrew; if Homebrew isn't writable, ios dev just warns, but ios init refuses unless an idevicesyslog is on PATH (only needed to stream logs from a physical device). There's no Apple Developer account yet, so the app isn't distributed — it's installed straight from Xcode with a free personal team, and those installs stop launching after 7 days. iOS also can't enforce a break the way the other platforms do (no drawing over other apps, no foreground scheduling), so it's notifications plus a Live Activity instead, with the overlay only appearing once the app is opened — see CLAUDE.md's "iOS" section for the full picture.

Build a production installer

npm run tauri build

Produces a .exe installer under src-tauri/target/release/bundle/ (a .dmg/.app on macOS, or an .AppImage on Linux). Pushing a vX.Y.Z tag also triggers .github/workflows/release.yml, which builds all platforms and publishes them automatically to the same GitHub Release.

The macOS build is currently unsigned/non-notarized (no Apple Developer account yet), so Gatekeeper will flag it on first launch — right-click the app and choose "Open", or run xattr -cr /Applications/Reflectodoro.app in Terminal.

The Linux build ships as a single .AppImage (not .deb/.rpm, so the app's built-in updater keeps working the same way it does on Windows/macOS — see CLAUDE.md). Make it executable before first run (chmod +x Reflectodoro*.AppImage); some distros also need libfuse2 installed for the AppImage runtime to mount itself. Note the tray icon needs the AppIndicator/KStatusNotifierItem extension to appear at all on a vanilla GNOME (especially under Wayland) — KDE/XFCE work out of the box.

The Android build produces signed release APKs (one per ABI: arm64-v8a, armeabi-v7a) via CI when a vX.Y.Z tag is pushed, using a release keystore stored in repo secrets — see the android job in .github/workflows/release.yml. To build a signed APK locally you need your own keystore and to set ANDROID_KEYSTORE_PATH, ANDROID_KEYSTORE_PASSWORD, ANDROID_KEY_ALIAS, and ANDROID_KEY_PASSWORD (see src-tauri/gen/android/app/build.gradle.kts's signingConfigs block); without those, the build falls back to an unsigned debug APK:

npm run tauri android build -- --apk --split-per-abi --target aarch64 armv7

Produces APKs under src-tauri/gen/android/app/build/outputs/apk/. — see CLAUDE.md's "Android" section fro more details.

Recommended IDE Setup

VS Code + Svelte + Tauri + rust-analyzer.