Skip to content

Vacation Mode

tempus2016 edited this page Jun 17, 2026 · 2 revisions

Vacation mode lets you mark date ranges as time off. During a vacation, all chores are paused and streaks are frozen — days inside a vacation never count as missed, so a streak survives a holiday.


What a Vacation Does

While today falls inside a vacation period:

  • All chores are paused — every chore reports as unavailable, so children see nothing to do (the child card shows an on-vacation banner instead of the chore list).
  • Streaks are frozen — the nightly streak check is skipped entirely on a vacation day. No streak is reset or paused.
  • Missed days are forgiven — when the streak check next runs, any vacation days between a child's last completion and today are not counted as misses. A genuine, non-vacation day that was missed still breaks the streak as normal.

Vacations are global — they apply to every child, not per-child.


Setting Up a Vacation

Add and remove vacation periods in the Admin Panel under Settings, using the vacation editor. Each period has:

Field Description
Name Optional label (e.g. "Summer holiday")
Start First day of the vacation (inclusive)
End Last day of the vacation (inclusive)

Both bounds are inclusive ISO dates. If you enter the end before the start, TaskMate swaps them automatically. Up to 50 periods can be stored.

Periods are saved in the vacation_periods setting as a list of { id, name, start, end } entries, sorted by start date.


What Resumes Afterwards

There is nothing to switch back on. The moment the current date moves past a vacation's end date:

  • Chores become available again on their normal schedule.
  • The nightly streak check runs again. Because the vacation days were forgiven, a child who was on a streak before the holiday keeps it — completing on the first day back continues the run.

Sensor Attributes

Both sensor.taskmate_overview and the chores sensor expose the current vacation state:

Attribute Description
vacation_active true if today is inside any vacation period
vacation_name Name of the active period (empty if none)
vacation_end End date of the active period (empty if none)

sensor.taskmate_overview additionally exposes vacation_periods — the full validated list, for cards or automations that want to show upcoming time off.


Related

  • Chores — chore availability
  • Bonus Points — streak milestones and perfect-week bonuses that vacations protect

Clone this wiki locally