Getting Started: Dashboard Generation - ad-ha/kidschores-ha GitHub Wiki

Dashboard Generation

The KidsChores integration includes an automated dashboard generator that creates fully-functional Lovelace dashboards with pre-configured views for kids and parents.

Overview

Access the dashboard generator via KidsChores Options → Manage Dashboard.

What it creates:

  • Individual tabs for each kid with their chores, rewards, and progress
  • Optional admin views based on selected admin layout
  • Pre-configured cards using custom frontend components

Prerequisites

Required Custom Cards (install via HACS → Frontend):

  • Mushroom Cards - Modern, customizable card designs
  • Auto-Entities - Automatic entity filtering and display
  • Mini Graph Card - Compact charts for statistics

The integration will check for these cards before generation and warn if any are missing.

Creating a Dashboard

  1. Navigate to Settings → Devices & Services → KidsChores → Configure
  2. Select Manage Dashboard
  3. Choose Create Dashboard
  4. Enter Dashboard Name (appears in sidebar, default: "Chores")
  5. Configure dashboard options:
    • Dashboard Style: Choose layout complexity for kid views
      • Full: All features (chores, rewards, bonuses, achievements, challenges, badges)
      • Minimal: Essential features only (chores, rewards)
      • Compact: Dense layout with key features
    • Kids: Select which kids get individual tabs
    • Admin Layout:
      • None: No admin views
      • Shared: One shared admin view (admin)
      • Per Kid: One admin view per selected kid (admin-<kid-slug>)
      • Both: Shared plus per-kid admin views
  6. Click Submit

The dashboard will be created and appear in your Home Assistant sidebar.

Dashboard Styles

Minimal (Incomplete)

  • Welcome card
  • Chores list
  • Rewards list
  • Best for: Young kids, simple chore systems

Full

  • Welcome card with detailed stats
  • Chores (all states, filtering)
  • Rewards (claimable, claimed)
  • Bonuses & Penalties
  • Achievements & Challenges
  • Badge showcase
  • Statistics graphs
  • Best for: Comprehensive chore systems, older kids

Admin Dashboard

Admin views provide parent management tools:

  • Kid selector dropdown (switch between kids)
  • Pending approvals (chores, rewards)
  • Chore history viewer
  • Shared chore management
  • Quick actions (deposit/withdraw points, reset overdue)
  • System notifications

Performance tip: The admin dashboard uses a system-level selector entity for efficient kid switching.

Updating Dashboards

To update an existing dashboard:

  1. Select Update Dashboard
  2. Choose the existing dashboard from the selector
  3. Adjust sections (kid views, admin layout, access/sidebar, template version)
  4. Submit

Note: Update modifies the selected dashboard in place.

Deleting Dashboards

  1. Select Manage Dashboard
  2. Choose Delete Dashboard
  3. Select dashboard(s) to remove
  4. Submit

Troubleshooting

Dashboard shows errors about missing cards:

  • Install required custom cards via HACS → Frontend
  • Restart Home Assistant after installation
  • Re-run dashboard generator

Dashboard not appearing in sidebar:

  • Check that dashboard name doesn't conflict with existing dashboards
  • Verify you have at least one kid selected
  • Check Home Assistant logs for dashboard creation errors

Per-kid admin views are missing:

  • Confirm Admin Layout is set to Per Kid or Both
  • Confirm at least one kid is selected
  • Verify view paths include admin-<kid-slug> in the dashboard editor

Shared admin view not switching between kids:

  • Verify select.system_kidschores_dashboard_kid_selector entity exists
  • Check entity is enabled in Settings → Devices & Services → KidsChores

Related Topics

⚠️ **GitHub.com Fallback** ⚠️