Skip to content

Kids Chores is a custom integration for Home Assistant. This is a dynamic dashboard that can provide a simple full featured interface into the capabilities of that integration without building individual chores and dashboards.

License

Notifications You must be signed in to change notification settings

dehoej/kidschores-ha-dashboard

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏑 Kids Chores and Rewards Dashboard

A fully automated UI dashboard designed for the KidsChores Integration by VaReTaS, seamlessly integrating with Home Assistant. This dashboard provides a front-end interface for interacting with the KidsChores system, which manages all backend logic for chores, points, rewards, and penalties. No custom buttons or manual dashboards are neededβ€”just install, configure, and enjoy a fully featured interface in minutes.

🌟 Overview

The KidsChores Dashboard is a front-end UI built on top of the KidsChores Integration, which handles all chore tracking, reward management, and point calculations in the background. The dashboard provides a user-friendly interface to interact with those features, giving kids a fun, engaging experience and parents a complete management view without any manual setup.

image

Buy Me A Coffee

What This UI Provides:

βœ… A fully automated, kid-friendly interface for viewing and claiming tasks.
βœ… A comprehensive parent control panel for reviewing and approving chore completions and rewards.
βœ… Automatic categorization of chores based on their due dates and statuses.
βœ… Built-in gamification with badges, streaks, challenges, and rewards.
βœ… Real-time tracking of achievements and challenges in easy-to-read cards.
βœ… Designed to work well on mobile screen size but also works great on desktop, and tablets

What the KidsChores Integration Handles (Backend):

πŸ”Ή Chore state management (e.g., overdue, claimed, completed).
πŸ”Ή Point calculations and balances.
πŸ”Ή Badge, challenge, and reward logic.
πŸ”Ή Approvals and penalties tracking.


πŸ“Œ Features at a Glance

πŸ§’ For Kids

βœ… Chores organized by category: Overdue, Morning, Daily, and Anytime.
βœ… Track progress with badges earned, streak counts, and points.
βœ… Redeem rewards quickly with an interactive button system.
βœ… View achievements and challenges with clear progress indicators and rewards.

πŸ‘©β€πŸ‘¦ For Parents

βœ… Chore Approvals: Instantly approve or deny completed chores with a simple hold action.
βœ… Reward Approvals: Quickly review and approve claimed rewards.
βœ… Overdue Chore Management: Reset all overdue chores or individual chore statuses with one tap.
βœ… Due Date Adjustments: Change the due date of any chore, including adding or clearing dates.
βœ… Penalties: Apply deductions for missed or overdue tasks.
βœ… Manual Points Adjustments: Add or remove points for corrections or bonuses.
βœ… 7-Day Activity Log: View a complete history of chore claims, approvals, penalties, and rewards.


🎨 Kids Dashboard

🏠 Overview

The Kids Dashboard is designed to give kids a simple, fun, and engaging way to track their progress, earn rewards, and celebrate their achievements. Built automatically from the KidsChores Integration, it encourages responsibility and consistency without any manual setup or customization.

⭐ Easy and Fun: Simple, one-click actions for chores and rewards.
πŸš€ Motivating: See progress on achievements, challenges, and badges in real-time.
🎯 Clear Goals: Automatically updates with current points, streaks, and upcoming tasks.


πŸ“Œ Example Kids Dashboard UI:

image


πŸ”Ή Dashboard Sections Overview

1️⃣ Points & Progress Tracking

  • Displays the child's current points and highest earned badge, with icons for easy recognition.
  • Shows progress for:
    • πŸ“… Weekly completed chores
    • β˜€οΈ Today’s completed tasks
    • πŸ† Achievements and challenge goals with clear status indicators.
  • Points labels and icons are automatically sourced from the integration.

2️⃣ Chores Section

  • Chores are automatically categorized into:

    • πŸ›‘ Overdue β€” Chores past their due date
    • β˜€οΈ Due this Morning β€” Chores due before noon
    • 🌞 Due Today β€” Chores due between noon and midnight
    • πŸ—“οΈ Upcoming & Bonus β€” Future chores or those without a set date
  • Each chore card displays:

    • πŸ’Ž Points earned
    • πŸ”₯ Streak count
    • πŸ“… Due date and time
    • πŸ“Œ Status: Pending, Approved, or Claimed
  • Shared chores are clearly marked with β€œ(S)” for easy identification. When one child claims a shared chore, the dashboard visually updates for the other assigned kids by displaying a purple icon and a multi-person symbol, indicating that someone else has already completed it. However, this is purely for awarenessβ€”each child's chore responsibility remains independently handled in the backend system. Their task can still become overdue if unclaimed, and they can still claim and get approval for completing it. While single-completion shared chores aren't currently supported, this visual indicator can serve as a helpful workaround for families managing shared tasks.

image

  • Multi-claim chores now display in blue after their first approval. These chores also show an "(M)" after their status, indicating they can be claimed again.

image

  • All chores are claimed with a single clickβ€”no extra actions needed.
  • Completion is indicated by icon color and a badge overlay (no separate β€œCompleted” category).

image


3️⃣ Rewards Section

  • Allows kids to redeem rewards instantly using their earned points.
  • Displays reward details, including:
    • πŸ’° Cost in points
    • πŸ“₯ Claims made
    • βœ… Approval status (if needed)
    • 🟒 Can be redeemed now β€” clearly indicates if the child has enough points
  • Rewards are automatically listed from the integrationβ€”no manual setup required.
  • Simple one-click redemption makes rewards easy to claim and enjoy.

4️⃣ Kids Showcase – Celebrate Progress and Achievements

The Kids Showcase section is a dedicated dashboard celebrating the child’s progress, milestones, and goals. This section highlights achievements and badges earned while providing detailed progress tracking for ongoing challenges.

Showcase Highlights:

  • πŸ… Badges Earned: Displays all collected badges with icons and descriptions.
  • 🌟 Highest Badge and Multiplier: Shows the child’s highest badge and its impact on their points earnings.
  • πŸ† Achievements: Lists completed and in-progress achievement goals, including total points earned from each.
  • πŸ”₯ Challenges: Provides detailed tracking of current challenges, progress percentages, and remaining goals.
  • πŸ’Ž Point Multipliers: Highlights how badges increase points earned for completing chores.

The Kids Showcase offers a fun and motivational way for kids to see their hard work pay off, track their goals, and stay excited about their progress. πŸš€


πŸ“Œ Example Kids Showcase Dashboard UI:

image


The KidsChores Dashboard is designed with kids in mindβ€”simple, fun, and automatic. Everything is generated directly from the integration, so kids can focus on achieving their goals and earning rewards without any confusion or extra steps. πŸš€


πŸ‘©β€πŸ‘¦ Parent Chore Dashboard

🏠 Overview

The Parent Dashboard is a fully automated control panel for managing chore approvals, point adjustments, and penalties. It is designed to minimize space by dynamically showing sections only when actions are neededβ€”such as pending approvals or overdue chore resets. Built on the KidsChores Integration, it offers intuitive, space-efficient cards for full parental control.

πŸ“Œ Smart Display: Sections like approvals and overdue chore resets only appear when required.
πŸ’₯ Quick Actions: All actions use β€œSingle click to apply” for quick and easy interactions.
πŸ“Š Full Visibility: Activity logs provide a complete history of points and approvals.


πŸ”Ή Features Overview

  • βœ… Parent Dashboard Overview Card β€” Displays key stats such as points, progress, and penalties.
  • βœ… Approve or deny chores and rewards with a simple hold action.
  • βœ… Reset overdue chores individually or all at once.
  • βœ… Adjust individual chore due dates quickly.
  • βœ… Manage points and penalties under β€œPluses & Minuses.”
  • βœ… Monitor all activity with a 7-day activity log.

πŸ“Œ Example Parents Dashboard UI:

image


πŸ“Œ Parent Dashboard Sections

1️⃣ Parent Dashboard Overview Card

The Parent Dashboard Overview Card provides a quick snapshot of the child's progress and current status:

  • πŸ“Š Current Points Total with point label and icon.
  • πŸ“… Chores Completed: Today, This Week, and This Month.
  • 🚨 Number of Overdue Chores, if any.
  • πŸ’Ž Reward Activity: Recent claims and approvals.
  • ⚠️ Penalties Applied: Number of penalties and total points lost.
  • πŸ“ˆ Total Penalty Points deducted to date.

2️⃣ Approvals Section

  • Appears only when approvals are pendingβ€”fully hidden otherwise.
  • Allows parents to approve or deny:
    • πŸ“ Pending Chores
    • 🎁 Pending Rewards
  • Displays important details like points earned and completion status.

image


3️⃣ Overdue Chores Management

  • Appears only when chores are overdue.
  • Provides two options:
    • πŸ›‘ Reset All Overdue Chores for the child.
    • πŸ“Œ Reset Individual Chores with due date and status shown.

image


5️⃣ Chore Due Date Adjustments

  • Displays a chore selector to quickly find and update due dates.

  • Provides options for adjusting due dates:

    • πŸ“… +Next Due
    • πŸ“… +1 Day
    • πŸ“… +1 Week
    • ❌ Clear Date
    • πŸ“† Set Custom Date and Time with a date picker.
  • Before selecting a chore:

image

  • Options appear after chore is selected:

image


4️⃣ Pluses & Minuses

The Pluses & Minuses section combines Manual Points Adjustments and Penalties, providing an all-in-one interface for point management.

βž• Manual Points Adjustment

  • Displays easy-access buttons to:
    • βž• Add points (e.g., for extra chores or positive behavior).
    • βž– Remove points (e.g., corrections or adjustments).
  • Shows the child's current point total and updates immediately.

πŸ’₯ Penalties Management

  • Displays penalty options to deduct points for missed chores or behavior issues.
  • Each penalty button shows:
    • πŸ’₯ Points deducted
    • πŸ“Š Times penalty was applied
  • Total penalty points applied are shown in the Parent Overview.

6️⃣ Activity Log (7-Day History)

  • Logs all chore-related activity, including:
    • πŸ“ Chore claims
    • βœ… Chore and reward approvals
    • πŸ’₯ Penalties applied
    • πŸ’° Reward redemptions
  • Provides a clear timeline of events for easy tracking.

The Parent Chore Dashboard is designed to be efficient and intuitive, showing only necessary options and grouping key actions under β€œPluses & Minuses” for simplicity. All functionality is powered by the KidsChores Integration, ensuring automatic updates and zero manual setup. πŸš€


πŸ”§ How to Implement This Dashboard

Follow these steps to quickly set up the KidsChores Dashboard in Home Assistant, including both the Kids and Parent sections.

This approach creates a complete dashboard in one step. Once it’s set up, you can:

  • πŸ“Œ Move individual cards to different positions or dashboards.
  • πŸ› οΈ Customize the layout to suit your needs.
  • πŸ“ Extract specific sections from the dashboard YAML if you prefer to use them individually or in other dashboards.

If you’re comfortable working with YAML, you can review the dashboard code to select and reuse any individual cards or sections that fit your needs.

πŸ“Œ Step 1: Install Custom Cards

This dashboard requires custom frontend cards to function correctly.

  1. Open Home Assistant
  2. Go to HACS β†’ Frontend
  3. Search and install the following cards:
    • 🟒 Mushroom Cards (custom:mushroom-template-card)
    • 🟒 Auto-Entities (custom:auto-entities)
    • 🟒 Mini Graph Card (custom:mini-graph-card)
  4. Restart Home Assistant to apply the changes.

πŸ“Œ Step 2: Create a New Section Dashboard

To keep the dashboard organized, create a separate section for chore tracking. You can skip this step if you have an existing location you want to use.

  1. Go to Home Assistant β†’ Settings β†’ Dashboards
  2. Click "Create Dashboard"
  3. Enter a name (e.g., "Kids Chores")
  4. Click "Save"

πŸ“Œ Step 3: Add the Dashboard YAML

  1. Open your new dashboard.
  2. Click **"Edit Dashboard" β†’ "Manage Dashboard"
  3. Click the "Edit Pencil" next to the view name and select "Edit Yaml"
  4. Copy and paste the Kids Chore Dashboard YAML into the view.

image

https://github.com/ccpk1/kidschores-ha-dashboard/blob/main/files/kc-dashboard.yaml


πŸ“Œ Step 4: Find and Replace "Kidname"

Since this YAML uses a placeholder name, update it to match your child's name.

  1. Find and replace all instances of:
    • Kidname β†’ (e.g., "Payton")
  2. Ensure case-sensitive replacement to avoid errors.
  3. Click "Save" to apply changes.

Note - No longer required to change the "points" text, the new dashboard dynamically grabs the point label from the integration.


πŸ“Œ Step 5: Add Required Helpers (UI Support)

Currently, the KidsChores Dashboard requires a single datetime helper to support interactive features in the UI.

You will need to add:

  • πŸ—“οΈ input_datetime.kc_ui_set_date_helper β€” For setting custom due dates from the dashboard. The name of the entity is critical, so enter it carefully. To add a helper, go to Settings \ Devices & Services \ Helpers then select "+ CREATE HELPER" and choose "Date and/or time"

image

An optional automation can be added to continuously set the date of the date of that helper to tomorrow at 11PM. Without this automation, the datetime will remain at whatever was last selected, which is not an issue.

  • βš™οΈ Automation: kc_ui_set_date_on_hold β€” .

πŸ“„ kc-dashboard-uihelpers.yaml


🎯 Finalizing the Dashboard

  • πŸš€ Exit edit mode and test the new chore tracking system!
  • βœ… Ensure buttons update chore statuses correctly.
  • πŸ›  If any entities are missing, check sensor and button names in Developer Tools β†’ States.

If you are having any issues with the approval buttons working, check these posts:


Your Kids Chore & Reward Dashboard is now fully functional in Home Assistant! πŸŽ‰

If you haven't already done so, take a few minutes to look through the KidsChores integration Wiki which is loaded with helpful information as you get started. πŸ‘‰ Integration Wiki


🚨 Known Issues & Workarounds

πŸ”Ή Renaming Chores and Rewards

While renaming chores and rewards works correctly within the KidsChores integration, it does not update the entity names, which the dashboard relies on to match the friendly_name.

Recommended Workaround:

βœ” Best Option: Delete the chore or reward and recreate it with the new name.

βœ” Manual Fix: If you prefer to keep the existing entity, you can manually rename all associated button and sensor entities to match the new friendly name.

  • However, you must account for Home Assistant's special character handling.
  • Accent characters are automatically normalized (e.g., "Ε tΔ›pΓ‘n" β†’ "stepan").
  • Spaces and special characters are replaced with underscores (_).
  • Duplicate and trailing underscores are removed.
  • Example:
    • "Brush Teeth (Morning)" becomes "_brush_teeth_morning".
    • "Ε imon’s Dishes!" becomes "_simons_dishes".

If you experience issues after renaming a chore or reward, verify that the entity names match the expected format based on Home Assistant’s naming conventions.


πŸ“Œ Need help? Log and issue here or visit the thread on the Home Assistant Forum Introducing the KidsChores and Rewards Dashboard ! πŸš€

About

Kids Chores is a custom integration for Home Assistant. This is a dynamic dashboard that can provide a simple full featured interface into the capabilities of that integration without building individual chores and dashboards.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published