Skip to content

Settings ​

The gear button on the Home screen's top bar opens the on-device settings — the few knobs a family actually tweaks day to day:

SettingWhat it doesDefault
Sleep starts / endsThe scheduled blackout window (24h clock)22 → 7
Screensaver afterIdle minutes before the photo slideshow starts3 min
Photo changes everySlideshow interval20 s
Chore reminderKill-switch for the scheduled morning pushon
Dinner digestKill-switch for the scheduled dinner pushon
Chore celebrationsConfetti + a chime when a kid finishes a choreon

The two notification toggles stop the scheduled pushes for everyone — the quick answer to "these got annoying." Each phone's bell (in the mobile app) only controls that one phone.

Chore celebrations are a bit of fun for younger kids: marking a chore done throws a short confetti burst from that child's avatar, pops the avatar, ticks their star count, and plays a quick chime. It only fires for members flagged as a kid in the roster ("kid": true) — grown-ups just get the plain green check — and this toggle turns it off entirely.

A kid completing a chore — the avatar pops and confetti bursts

Changes apply to every connected display immediately after Save — no reload needed.

Parent PIN gate ​

Like Budget, Settings is locked behind a parent PIN (the members in BUDGET_UNLOCK_MEMBERS, default dad,mom): tap a parent's avatar, enter their PIN, and settings stay unlocked on that display for about 15 minutes. One unlock covers both Budget and Settings.

Where the values live ​

Saved settings persist in the app's database and override the matching .env values (SLEEP_START_HOUR, SCREENSAVER_IDLE_MIN, …) — the env vars remain the fresh-install defaults. Everything deeper (family roster, data-source tokens, notification hours) stays file/env-configured on purpose: those change once, not from the kitchen wall. See First-time setup.

Released under the MIT License.