Skip to content

Dashboard Cards

Jump to bottom
tempus2016 edited this page Apr 21, 2026 · 9 revisions

TaskMate includes 17 Lovelace cards. They are automatically registered as resources when the integration loads.

All cards support a header_color config option — a hex colour for the card header background. Each card has its own vibrant default.

Which Cards Do I Need?

For a first-time setup, you only need three cards:

Card Who sees it Purpose
Child Card Kids Complete chores, hear sounds, see celebrations
Rewards Card Kids Browse and claim rewards
Parent Dashboard Card Parents Approve chores, manage points, see overview

Everything else is optional and can be added later as you explore:

Card Best for
Approvals Card Dedicated approval screen (instead of the tab in Parent Dashboard)
Points Card Quick +/- point adjustments with custom amounts
Penalties / Bonuses Cards Reusable named deductions and awards
Streak Card Motivating kids with streak history and badges
Leaderboard Card Competitive households with multiple children
Weekly Card Reviewing the week's activity
Points Graph Card Tracking points trends over time
Points Display Card Wall-mounted tablet showing points
Reward Progress Card Wall-mounted tablet showing progress toward a single reward
Calendar Card Day-by-day view of chore assignments
Overview Card At-a-glance summary for parents
Reorder Card Customising chore display order per child

Adding Cards

  1. Edit your dashboard → + Add Card
  2. Search "taskmate" or scroll to Custom
  3. Select a card and configure via the visual editor, or use YAML

All cards require entity: sensor.taskmate_overview.

Child Card

Purpose: The primary card for kids — displays their chores with big colourful buttons, completion sounds, and celebrations.

Default header colour: Purple #9b59b6

type: custom:taskmate-child-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # required
time_category: anytime        # morning | afternoon | evening | night | anytime | all
due_days_mode: hide           # hide | dim | show — for specific-day chores not due today
recurrence_done_mode: dim     # dim | hide | show — for recurring chores already completed
show_countdown: true          # show midnight reset countdown
show_description: false       # show chore description below name
show_due_days_only: false     # only show chores due today (ignore time_category filter)
default_sound: coin           # default completion sound
undo_sound: undo              # sound when undoing
header_color: "#9b59b6"

Behaviour:

  • Tap a chore row to complete it (the whole row is a button — no small target)
  • Tap a completed chore to undo it
  • Chores requiring approval show as ticked but pending until approved
  • If daily_limit > 1, a counter (0/3) appears beside the points
  • When all chores are done, an animated "All Done!" state is shown
  • A confetti and celebration popup appears on completion

time_category values:

Value Shows
morning Chores with time_category = morning or anytime
afternoon Chores with time_category = afternoon or anytime
evening Chores with time_category = evening or anytime
night Chores with time_category = night or anytime
anytime Chores with time_category = anytime only
all All chores regardless of time_category

due_days_mode values (Mode A — Specific Days chores):

Value Behaviour
hide Chores not due today are hidden
dim Chores not due today shown greyed out, non-interactive
show All chores shown regardless of schedule

Rewards Card

Purpose: Shows available rewards with progress bars. Children can claim rewards from this card.

Default header colour: Orange #e67e22

type: custom:taskmate-rewards-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # optional — filter to one child
show_child_badges: true       # show assigned children on each reward
enable_pool_mode: false       # force all rewards on this card into pool/savings-jar mode
header_color: "#e67e22"

Behaviour:

  • Progress bar shows current points vs reward cost
  • Jackpot rewards show a colour-coded multi-segment bar with each child's contribution
  • Claim button appears when the child can afford the reward
  • After claiming: shows "Awaiting parent approval" until approved
  • If no child_id set, a Viewing as dropdown appears below the header — select a child to activate claim buttons for them

Approvals Card

Purpose: Review and approve or reject pending chore completions.

Default header colour: Green #27ae60

type: custom:taskmate-approvals-card
entity: sensor.taskmate_overview
title: Pending Approvals
child_id: a8c8376a            # optional — filter to one child
header_color: "#27ae60"

Behaviour:

  • Items grouped by date (Today / Yesterday / date) and time of day
  • ✗ button on the left to reject, ✓ button on the right to approve
  • Pulsing red badge in header shows count when items are pending

Points Card

Purpose: Manually add or remove points from a child.

Default header colour: Blue #2980b9

type: custom:taskmate-points-card
entity: sensor.taskmate_overview
title: Manage Points
quick_add_amounts: [1, 5, 10]      # configurable add buttons
quick_remove_amounts: [1, 5, 10]   # configurable remove buttons
show_dialog: true                  # show ⋯ button for custom amount + reason
header_color: "#2980b9"

Behaviour:

  • Each child shows two rows of quick-tap buttons — add row and remove row
  • Tapping a button applies immediately with no confirmation dialog
  • The ⋯ button at the end of each row opens the full dialog for a custom amount with an optional reason
  • show_dialog: false hides the ⋯ buttons entirely if you only want fixed amounts
  • All amounts are configurable in the card editor — enter comma-separated values e.g. 1, 2, 5, 10, 25
  • Quick buttons fire without a reason — use ⋯ when you want to log a reason

Reorder Card

Purpose: Drag-and-drop interface to set the display order of chores for each child.

Default header colour: Teal #16a085

type: custom:taskmate-reorder-card
entity: sensor.taskmate_overview
child_id: a8c8376a
title: Reorder Chores
header_color: "#16a085"

Behaviour:

  • Drag chore rows up and down within each time category group
  • Click Save Order to apply — the order is stored per-child
  • Shows unsaved changes indicator when you have moved items

Parent Dashboard Card

Purpose: All-in-one parent control centre with four tabs.

Default header colour: Crimson #c0392b

type: custom:taskmate-parent-dashboard-card
entity: sensor.taskmate_overview
title: Parent Dashboard
quick_points_amount: 5        # points per +/- button press
show_claims: true             # show the Claims tab
header_color: "#c0392b"

Tabs:

Tab Content
Overview All children's today progress bars and points
Approvals Pending chore completions with approve/reject
Claims Pending reward claims with approve/reject
Points Quick +/- buttons per child

Overview Card

Purpose: At-a-glance parent summary of all children.

Default header colour: Violet #8e44ad

type: custom:taskmate-overview-card
entity: sensor.taskmate_overview
title: TaskMate
approvals_entity: sensor.pending_approvals  # optional — override for pending approvals count
header_color: "#8e44ad"

Shows per child:

  • Today's chore progress bar (approved completions / chores due today)
  • Current points balance
  • Pending approval chip (if any)
  • Footer totals: children count, done today, total points

Note: Progress counts only chores due today. Chores with due_days set are excluded from the denominator on days they are not scheduled. Chores with no due_days set are always included.

Activity Card

Purpose: Scrollable timeline of all activity.

Default header colour: Steel Blue #2471a3

type: custom:taskmate-activity-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # optional — filter to one child
max_items: 30
header_color: "#2471a3"

Shows:

  • Chore completions (approved and pending)
  • Manual point adjustments (add/remove)
  • Bonus point events (weekend multiplier, streak milestones, perfect week)
  • Reward claim events

Grouped by Today / Yesterday / date.

Streak Card

Purpose: Shows streak history and achievement badges.

Default header colour: Red #e74c3c

type: custom:taskmate-streak-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # optional — filter to one child
streak_days_shown: 14         # dot history length
header_color: "#e74c3c"

Shows:

  • Current and best streak numbers
  • Dot history grid (green = completed, grey = missed)
  • Achievement badges for milestones (First!, 3 days, 7 days, 14 days, 30 days, etc.)

Weekly Card

Purpose: Monday–Sunday view with bar chart.

Default header colour: Green #27ae60

type: custom:taskmate-weekly-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # optional — filter to one child
header_color: "#27ae60"

Shows:

  • Daily bar chart (approved completions only)
  • Headline stats: chores, points, days active
  • Per-child breakdown
  • Week date range

Points Graph Card

Purpose: Line graph of points over time.

Default header colour: Burnt Orange #d35400

type: custom:taskmate-graph-card
entity: sensor.taskmate_overview
child_id: a8c8376a            # optional — filter to one child
days: 14                      # date range: 3–90
header_color: "#d35400"

Features:

  • Canvas-based (works on mobile HA app)
  • Multiple children shown as colour-coded lines
  • Hover/touch tooltip showing values per day

Reward Progress Card

Purpose: Full-screen motivational display for a single reward. Designed for wall-mounted tablets.

Default header colour: Deep Purple #7d3c98

type: custom:taskmate-reward-progress-card
entity: sensor.taskmate_overview
reward_id: abc123             # required — see Finding IDs in Getting Started
child_id: a8c8376a            # optional
title: Reward Goal
header_color: "#7d3c98"

Shows:

  • Large reward icon with animated progress bar
  • Points progress and percentage
  • Pulsing "Ready to claim!" badge when affordable

Leaderboard Card

Purpose: Competitive ranking of all children.

Default header colour: Gold #b7950b

type: custom:taskmate-leaderboard-card
entity: sensor.taskmate_overview
sort_by: points               # points | streak | weekly
show_streak: true
show_weekly: true
header_color: "#b7950b"

Behaviour:

  • Top 3 get gold/silver/bronze styling
  • For single-child households: automatically shows personal bests (best streak, total chores, weekly points, total earned) instead of a ranking

Penalties Card

Purpose: Create, manage, and apply point penalties to children.

Default header colour: Red #e74c3c

type: custom:taskmate-penalties-card
entity: sensor.taskmate_overview
title: Penalties                # optional — custom card title
header_color: "#e74c3c"

Behaviour:

  • View all defined penalties with name, points, icon, and assigned children
  • Toggle Edit Mode to add, edit, or delete penalty definitions
  • Apply a penalty to a child with one tap — points are deducted immediately
  • Penalties appear in the Activity Card timeline

See Penalties for service call details and automation examples.

Bonuses Card

Purpose: Create, manage, and apply point bonuses to children.

Default header colour: Green #2e7d32

type: custom:taskmate-bonuses-card
entity: sensor.taskmate_overview
title: Bonuses                  # optional — custom card title
header_color: "#2e7d32"

Behaviour:

  • View all defined bonuses with name, points, icon, and assigned children
  • Toggle Edit Mode to add, edit, or delete bonus definitions
  • Apply a bonus to a child with one tap — points are awarded immediately
  • Bonuses appear in the Activity Card timeline

See Bonuses for service call details and use cases.

Points Display Card

Purpose: Visual points display with three display modes — single child, multi-child grid, or cumulative family total.

Default header colour: Purple #9b59b6

type: custom:taskmate-points-display-card
entity: sensor.taskmate_overview
mode: single                    # single | multi | cumulative
child_id: a8c8376a              # required for single mode
show_streak: true               # show streak info
show_weekly: true               # show weekly stats
show_rank: true                 # show rank medal in multi/cumulative modes
header_color: "#9b59b6"

Modes:

Mode Description
single Large display for one child — shows avatar, points balance, streak, and weekly stats
multi Grid of all children with points and optional rank medals
cumulative Family total — combined points across all children

Calendar Card

Purpose: Calendar view showing chore assignments and completions across days. Navigate with Prev/Next/Today buttons.

Default header colour: Blue #3498db

type: custom:taskmate-calendar-card
entity: sensor.taskmate_overview
child_id: a8c8376a              # optional — filter to one child
title: Task Calendar
header_color: "#3498db"

Behaviour:

  • Shows a day-by-day view of chore assignments based on scheduling rules
  • Colour-codes chores by completion state (done / pending / not yet)
  • Respects all schedule modes: specific days, recurring, and one-shot
  • Handles assignment modes (alternating/random/balanced) — only shows the assigned child for that day
  • Navigate between days with Prev / Next / Today buttons

Completion Sounds

The child card plays a sound when a chore is ticked off. All synth sounds use the Web Audio API — no external files needed.

Sound Type Description
coin Synth Classic video game coin collect
levelup Synth Triumphant ascending arpeggio
fanfare Synth Celebratory trumpet fanfare
chime Synth Pleasant bell chime
powerup Synth Ascending sweep with sparkle
undo Synth Sad descending "womp womp" (played on undo)
fart1–fart10 Audio file Real fart sounds (CC0, BigSoundBank.com)
fart_random Audio file Random fart sound 1–10
none — No sound

Fart sounds require audio files at /config/www/taskmate/fart1.mp3 through fart10.mp3.

Priority: chore-level completion_sound → card default_sound → coin

You can preview sounds using the taskmate.preview_sound service from Developer Tools.

Clone this wiki locally