Questboard -- pixel art RPG chore tracker for families, runs as a HA dashboard

Share your Projects!
1

Questboard -- pixel art RPG chore tracker for families, runs as a HA dashboard

GitHub: GitHub - thillygooth/questboard: A gamified family chore tracker built with React, FastAPI, and Docker. Family members claim daily and weekly chores to earn points, then redeem them for real-world rewards. Features per-player profiles, age-appropriate chore filtering, auto daily/weekly resets, and a shared backend for real-time sync across devices. · GitHub

I built this for my kitchen tablet. The idea: turn daily chores into a pixel art RPG for the whole family. Each family member gets a hero and a monster to fight. Completing chores deals damage. Kill the monster
before midnight, earn gold. Fail, and it hits back.

Runs as a Docker container and drops into a Home Assistant sidebar via panel_iframe -- no add-on store, no port forwarding needed.

Screenshots
Screenshots1920×2863 752 KB

Features

  • Monster battles -- each player fights a unique animated pixel art monster daily. Chain chores fast for combo damage, crits, and loot drops
  • Dungeon map -- chores earn dungeon moves. Explore a fog-of-war dungeon with rooms, keys, locked chests, and mini-bosses. 54 monsters with animated sprites
  • XP, leveling, prestige -- hit level 10, prestige for a permanent gold bonus
  • Kill streaks -- multi-day streaks multiply gold up to 2x
  • Reward shop -- spend gold on family rewards you configure yourself (screen time, treats, choosing dinner)
  • Kids and adults modes -- separate difficulty scaling
  • Weekly leaderboard, history log, badges and titles
  • CRT scanline overlay for retro vibes
  • Up to 6 players, each with their own hero class, gold, XP, and dungeon
  • Daily / weekly / monthly chores auto-reset at midnight

Install on Home Assistant

Step 1 -- run the container

In the HA Terminal add-on:

mkdir -p /mnt/data/supervisor/questboard/data
docker run -d --restart unless-stopped --name questboard -p 8099:8099
-v /mnt/data/supervisor/questboard/data:/data

Step 2 -- add to the sidebar

In configuration.yaml (File Editor add-on):

panel_iframe:
questboard:
title: "Questboard"
url: "http://:8099"
icon: mdi:sword-cross
require_admin: false

Replace with your HA IP (Settings > System > Network), then restart HA.

Can also run on a separate Docker host -- just point the url at that machine's IP instead.

First-run setup

A wizard runs on first open: set player count, pick names and hero classes, configure which chores to track, set reward costs, toggle the CRT overlay. Data is stored as a JSON file in the mounted volume -- back it
up with the rest of your HA data.

Multi-arch image (amd64 + arm64), so it runs natively on Raspberry Pi. MIT license. Sprite assets from OpenGameArt .org under CC-BY / CC0.

Happy to answer questions. If your kids find a way to game the chore system before you patch it, I want to hear about it.