HelmKeep

Behavior Tracking

Overview

HelmKeep includes a positive behavior recognition system that lets household admins and managers log good behaviors for members. The system is framed around celebration and recognition rather than surveillance or discipline — it tracks positive actions only.

The system name and icon are configurable per household (default: “Good Deeds”). Once enabled, members can earn points for recognized behaviors, build streaks, and work toward rewards.

Good Deeds (Behavior Logging)

Good Deeds are individual records of positive behavior. A parent or authorized member logs an entry when they observe a good behavior — for example, “Used kind words” or “Helped without being asked.”

Each household maintains a customizable behavior library organized by categories (Kindness, Responsibility, Helpfulness, etc.). Behaviors have configurable point values (1-5) and can be marked for quick-log access.

  • Quick Log: Select a member, pick a behavior from favorites, and submit in seconds
  • Detailed Log: Add notes, custom point values, or additional context
  • Batch Log: Catch up on multiple entries at the end of the day
Note: Points are additive only. The system never subtracts earned points or records negative behaviors.

Daily Responsibilities (ADT) Bonus

The ADT (All Daily Tasks) system draws a line between expected daily responsibilities and paid chores. Each member has a daily checklist of expected tasks — things like making the bed, brushing teeth, or completing homework.

The system uses a simple bonus model: each day a member completes their entire checklist without being reminded, they earn a bonus amount (default: $1). The bonus is added to their base allowance at the end of the week, up to a configurable weekly cap.

The rule is binary — if the entire checklist was handled independently, the day counts. If even one reminder was needed, it does not. There is no partial credit. Days can also be marked as “excused” (sick days, vacations) and are excluded from the calculation.

By default, each day is assumed completed without reminders. Parents only need to intervene when a reminder was needed, keeping the daily time investment near zero.

Family Dashboard

The Family Dashboard is a communal view designed for weekly family meetings. It shows all members side by side with their key numbers for the week: ADT completion rate, allowance bonus earned, Good Deed points, and active streaks.

  • Scoreboard: Side-by-side member cards with weekly stats
  • Good Deeds Feed: A chronological feed of all logged behaviors for the week, with notes, designed to be read aloud together
  • Reward Menu: Browse and claim rewards using earned points (when not in Family Mode)
  • ADT Breakdown: A read-only view of the weekly ADT grid showing daily statuses for all members

The Family Dashboard is accessible to all household members from the sidebar. It is read-only except for reward claiming.

Family Mode

Family Mode is a PIN-locked, read-only mode that lets parents hand a device to a child for browsing. When active, all mutation controls are hidden, the sign-out button is removed, and the app restricts to read-only views.

  • Activate from the sidebar lock button; set a 4-6 digit PIN on first use
  • Visible views: Family Dashboard, Reward Menu (browse only), member dashboards, task list, and balances — all read-only
  • Hidden views: Settings, approval queue, admin controls, Good Deed logging, and ADT logging
  • Deactivate by tapping the lock icon and entering your PIN
  • Family Mode persists across sign-out and sign-in — logging out and back in will not bypass the lock
Tip: Family Mode is ideal for handing a tablet around the table during your weekly family meeting so kids can browse their own progress.

Reward Menu

The Reward Menu lets members spend their accumulated Good Deed points on household-configured rewards. Each reward has a name, point cost, reset frequency (daily, weekly, monthly, or unlimited), and a shared flag.

Shared rewards are household-wide: only one member can claim them per reset period. This creates healthy, fair competition — the first child to earn enough points claims the reward, and siblings see it as taken until the next reset.

  • Rewards can be privileges (“Choose tonight’s dinner”), financial bonuses (“$5 to balance”), or experiences (“Movie night pick”)
  • Redemptions can require parent approval or auto-approve, depending on household settings
  • A Mystery Spin option randomly selects from available unclaimed rewards

Behavior Tracking Permissions

Behavior tracking uses the same role-based permission system as the rest of HelmKeep. The following permissions control access to behavior tracking features:

PermissionDescription
behaviors.logLog Good Deed entries for household members
behaviors.approveApprove or reject self-logged Good Deed entries
behaviors.configureManage behavior library, categories, ADT checklists, and reward menu
behaviors.viewView behavior data, streaks, and weekly summaries for all members
behaviors.redeemClaim rewards from the Reward Menu using earned points
behaviors.adt.logLog daily responsibility completions and mark reminder/excused days
HelmKeep

This documentation covers all features as of the current release. If you have questions or find something missing, please open an issue on GitHub.