What it does

TaskBandit is a self-hosted household task manager that turns daily chores into a lightweight game. Household members complete tasks, earn points, unlock achievements, and can redeem those points for real-world rewards through a parent-managed shop — all running on your own server with no cloud dependency.

Templates are organised into group, type, and optional sub-type layers so chore lists stay readable on both the admin side and the daily client views. Chores can chain — completing one task can automatically trigger a follow-up, modelling routines like laundry cycles, kitchen cleanups, and bedding changes.

Feature overview

• Chore assignment — round-robin, specific-member, or follow-up chains triggered on completion.
• Points & streaks — members earn points for completions; streaks track consistent daily progress and appear on the leaderboard.
• Achievements — configurable unlock milestones that reward members for streaks, perfect days, and total completions.
• Rewards shop — household admins define a catalogue of real-world incentives (screen time, treats, activities, allowance). Children redeem accumulated points; admins approve requests or configure auto-approval. Per-reward eligibility covers child-only, adult-only, or shared rewards.
• Overdue section — missed chores surface with prominent alerting on both web and Android so nothing slips.
• Proof photos — optional photo evidence required before a chore is accepted as complete.
• Takeover requests — members can request or grant coverage of another member's chore.
• Templates with translations — built-in starter templates in English, German, and Hungarian; the admin editor keeps all language variants in compact tabs.
• Web/PWA + Android — a browser-first client installable as a PWA, plus a native Kotlin/Compose Android app with offline queueing, speed-dial FAB, and in-app update delivery.
• Live sync — foreground sync while the app is open; optional Web Push and FCM for background delivery.

Core documentation areas

• Quick Start — fastest path to a running local stack with Docker Compose.
• Deployment — two-container shape, image names, and upgrade order.
• Reverse Proxy — HTTPS, headers, WebSocket routing, Nginx and Traefik examples.
• Clients — what the admin UI, client web/PWA, and Android app each cover.
• Configuration — environment variables, optional providers, and household settings.
• Troubleshooting — practical checks for install, proxy, certificate, and reset issues.
• Releases — Docker images, versioning, Android APK signing, and release automation.
• Development — local setup for server, web, and Android workspaces.

Start here

For a new install, start with the quick start. Edit .env before exposing the app publicly — at minimum change the JWT secret, database password, and public base URLs. The first household setup can import built-in starter templates and starter rewards (all disabled by default) so you can enable exactly the ones that fit your household.

Review configuration and reverse proxy setup for production installs. The troubleshooting guide covers common CORS, proxy, and container issues.