Skip to content

jo-anb/simple-plant-extended-card

 
 

Repository files navigation

Plant mode Preview of the card Plants overview mode Preview of the overview card

Simple Plant Extended Card

hacs_badge

Simple Plant Extended Card is a custom dashboard card for the Simple Plant Extended integration based on the Simple Plant Card from @ndesgranges

This repository exists only to allow installation through HACS (which does not allow both an integration and custom card in the same repository)

For any issue regarding this custom card, please report it in the main repository.

Features

  • Overview for watering, fertilizing, misting, and cleaning
  • Overview mode with totals and per-plant tasks across all devices
  • Extended plant details (size, location, soil, distance, pot size, sensors, age)
  • Optional activity timeline popup
  • Notes row with timeline and add-note dialog
  • UI options to show/hide misting, cleaning, details, and activity
  • Localized select values (soil, location, size, feed method) with English fallback

Configuration

You can configure the card via the UI editor. The following options are available:

  • mode (default: device): device or overview
  • device (required in device mode): Device from the Simple Plant Extended integration
  • overview_filter (default: overdue): overdue, today, or all (overview mode)
  • show_misting (default: true)
  • show_cleaning (default: true)
  • show_details (default: true)
  • show_activity (default: true)
  • show_notes (default: true)

Example YAML:

type: custom:simple-plant-extended-card
device: 1234567890abcdef
show_misting: true
show_cleaning: false
show_details: true
show_activity: true
show_notes: true

Overview example:

type: custom:simple-plant-extended-card
mode: overview
overview_filter: overdue

Installation

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

OR

  1. Install HACS if you don't have it already
  2. Open HACS in Home Assistant
  3. On the top right side, click the three dot and click Custom repositories
  4. Where asked for a URL, paste the link of this repository: https://github.com/jo-anb/simple-plant-extended-card
  5. Where asked for a type, select dashboard
  6. Click the download button. ⬇️

Development

Building

npm install
npm run build

Releasing

This project uses semantic-release for automated releases.

Important: Follow Conventional Commits format for your commit messages:

  • feat: - New feature (triggers minor version bump)
  • fix: - Bug fix (triggers patch version bump)
  • docs: - Documentation changes (no version bump)
  • chore: - Maintenance tasks (no version bump)

To create a release:

  1. Make sure you have a .env file with your GH_TOKEN:

    GH_TOKEN=your_github_token_here
    
  2. Run the release command:

    npm run release

    Or for a dry run to see what would happen:

    npm run release:dry

This will automatically:

  • Analyze commits since the last release
  • Determine the next version number
  • Update package.json and package-lock.json
  • Generate/update CHANGELOG.md
  • Create a git commit and tag
  • Push to GitHub
  • Create a GitHub release

About

Simple Plant Card is a custom dashboard card for the Simple Plant integration

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 100.0%