Tracking Number Card

A modern, customizable Home Assistant Lovelace card for displaying package tracking numbers with clickable links. Requires tracking-numbers custom integration

Features

• Clean, modern card design following Home Assistant design language
• Visual configuration UI editor
• Clickable tracking numbers that open package tracking pages
• Copy tracking number to clipboard with one click
• Add manual tracking numbers directly from the card
• Remove or hide entries with a single click
• Display carrier information with icons
• Show relative timestamps (e.g., "2 hours ago")
• Summary statistics by carrier
• Fully customizable sorting and display options
• Responsive design for mobile and desktop
• Full theme support (dark/light mode)
• Empty state handling
• Stylized console logging with version info

Installation

Installation through HACS

Configuration Options

Option	Type	Default	Description
entity	string	Required	Entity ID with tracking number data
title	string	Entity friendly name	Custom card title
show_summary	boolean	true	Show summary statistics by carrier
show_carrier	boolean	true	Display carrier information for each package
show_origin	boolean	true	Display retailer or sender information when available
show_dates	boolean	true	Show last updated timestamps
sort_by	string	first_seen	Sort field: first_seen, carrier, or tracking_number
sort_direction	string	desc	Sort direction: asc or desc
max_items	number	unlimited	Maximum number of packages to display

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Release Process

• Update the version in package.json and commit your changes.
• Create and push a tag matching v* (for example, git tag v4.1.0 && git push origin v4.1.0).
• The GitHub Actions workflow builds the distribution files and publishes a release with the generated assets.

License

MIT License - see LICENSE file for details

Support

For issues, feature requests, or questions:

• GitHub Issues: tracking-number-card/issues