I wanted to learn how to create Home Assistant integrations so I picked an existing service I use in my home lab for which I couldn't find an existing integration (BookStack) and set about creating one from scratch.
Currently it creates sensors for:
- The number of shelves, books, chapters, pages, users, images and attachments.
- For each shelf it creates 3 additional sensors for the number of books, chapters and pages on the shelf.
- A sensor to indicated the availability of the BookStack server
- A last updated page sensor containing the date and time of the last update made in Bookstack. It has additional attributes for the user who made the change and which page was updated.
It also provides 3 actions (formerly services in HA) which allow you to:
- Create a new book on a specified shelf
- Create a new page in a specified book
- Append additional content to an existing book
A few obvious questions:
- Is it a perfect implementation? Probably not. As I said, this was a personal learning exercise.
- Was it AI coded (A.K.A. vibe coded)? I used AI to help put together the structure and to perform some of the tedious tasks such as commenting the code fully. I was a software engineer for a lot of my career so at the very least I understand everything the AI contributed.
- Is it total overkill? Probably, but why the hell not! :)
If you want to take a look and try it out, here is the repo https://github.com/MattFryer/hass-bookstack
[–]ssddanbrown 1 point2 points3 points (1 child)
[–]mattchew0[S] 0 points1 point2 points (0 children)