Maintenance Tracker

Check out my other Home Assistant related creations: HA Dyson Card

Default HACS inclusion is still pending. For now, install it as a custom repository.

Why This One?

I know what you might be thinking: not another tracker integration.

Fair enough. There are already other takes on this idea. But this project was built around a different goal: reducing reminder fatigue instead of creating another dashboard that slowly turns into background noise.

I have been testing this concept in different forms for about 6 years through my older project, HowManyDaysSince, and this is the version that feels most natural to live with in Home Assistant.

The focus here is not on showing every recurring task all the time. The focus is the workflow.

The intended flow is simple:

1. Create the task
2. Complete it when it becomes due
3. Reset it and repeat

That is why visibility filtering is such a core part of the experience.

After you create a task in Manager mode, it stays out of sight until it enters the visibility window you define. That way, your Home Assistant dashboard stays useful instead of becoming a wall of maintenance reminders you unconsciously ignore. Since it already lives in a space you check every day, whether on your phone or on a wall-mounted display, it becomes the right surface for these tasks at the right time.

The goal is simple: make recurring maintenance tracking feel practical, low-friction, and easy to keep up with over time.

Features

Display Modes

• Manager
• Compact
• Badge

Highlights

• Integration-owned JSON storage
• Full create, update, reset, and delete task flow
• Highly customizable compact card content
• Full MDI icon selection
• Expressive colored circular progress bars
• Visibility filtering
• Notification settings
• In-line reset with confirmation in all modes

Intended Workflow

This integration was designed to feel as close to “set it and forget it” as possible:

1. Create the task
2. Set the visibility filter
3. Complete the task when it becomes due or visible on your dashboard
4. Repeat

For the best experience, I recommend placing the Manager card inside a Bubble Card pop-up.

Media

Card content

Demo

mt_demo.mp4

Credits

Badge mode was inspired by ha-trash-card.

Thanks to its creator for the inspiration.

HACS Install

Default HACS inclusion is still pending, so add this repository as a custom repository in HACS:

1. HACS -> top-right menu -> Custom repositories
2. Repository: https://github.com/thanhn062/ha-maintenance-tracker
3. Category: Integration

Quick Start

After HACS downloads the repository:

1. Go to Settings -> Devices & Services -> Add Integration
2. Search for Maintenance Tracker
3. Finish adding the integration
4. Restart Home Assistant once so the card resource is loaded
5. Refresh the Home Assistant page (this is important for the card to show up on search), then search for Maintenance Tracker Manager when adding a card

If the card still does not appear, use a Manual card with:

type: custom:maintenance-tracker-manager

From there, open the card and press Add tracker to create your first maintenance task.

Automation

For automations, scripts, or NFC tags, use the tracker slug as the service value:

• Bedsheets -> bedsheets
• Water Filter -> water_filter
• PC Cleanup -> pc_cleanup

Example:

action: maintenance_tracker.reset
data:
  tracker: water_filter

Disclaimer

This project was built with Codex, with me serving as project manager and overseeing the direction, review, and iteration process throughout.