Coins

Overview

Coins are the core currency of KidMoat's gamification system. Every day, your child is scored across 7 categories of digital behavior. The maximum daily score is 10 coins (before streak multipliers).

The 7 Scoring Categories

1. Screen Time (0-3 coins)

Compares total daily device usage against the configured daily limit.

| Usage vs. Limit | Coins | |-----------------|-------| | Under 50% | 3 | | 50% - 80% | 2 | | 80% - 100% | 1 | | Over limit | 0 | | No limit configured | 1 (default) |

2. Bedtime (0-2 coins)

Checks for any device usage during the configured bedtime window.

| Behavior | Coins | |----------|-------| | No usage during bedtime | 2 | | Any usage during bedtime | 0 | | No bedtime rule set | 1 (default) |

3. Mode Compliance (0-1 coin)

Evaluates whether the child completed mode sessions (Homework, Exam, etc.) without violations.

| Behavior | Coins | |----------|-------| | No violations (compliant or no sessions) | 1 | | Any violation or tamper attempt | 0 |

4. Safe Browsing (0-1 coin)

Counts blocked web requests from the content filter.

| Behavior | Coins | |----------|-------| | Zero blocked attempts | 1 | | Any blocked attempts | 0 |

5. App Mix (0-1 coin)

Checks for educational app usage during the day.

| Behavior | Coins | |----------|-------| | 15+ minutes of educational apps | 1 | | Less than 15 minutes | 0 |

6. Location Trust (0-1 coin)

Checks for geofence breach alerts.

| Behavior | Coins | |----------|-------| | Zero geofence breaches | 1 | | Any breach | 0 |

7. Device Health (0-1 coin)

Evaluates the device health score from the latest heartbeat, checking that all required permissions are enabled.

| Behavior | Coins | |----------|-------| | Health score >= 70 (all permissions OK) | 1 | | Health score < 70 or no data | 0 |

Daily Total

The base daily maximum is 10 coins (3 + 2 + 1 + 1 + 1 + 1 + 1).

This base score is then multiplied by the active streak multiplier. For example, a child with a 30-day streak earning 8 base coins would receive 8 x 1.5 = 12 coins for that day.

When Scoring Happens

The coin calculation runs as an end-of-day batch process. It evaluates the entire day's telemetry data (usage events, web activity, heartbeats, alerts, etc.) and produces the final score. The child sees their updated balance the next morning.