Adding own custom card to the HACS store - struggeling on actions

Development
1

I want to add my custom card:

to HACS to make it a bit easier for the Users. Currently they have to click on the link in my readme.md to add it as a custom repository.

Using google leads to million of manuals how to install HACS or how to add custom components to HA.

Trying to ask ChatGPT leads to outdated information, also if you tell ChatGPT only to work with facts. But at least ChatGPT confirms that the documentation is unclear.

So far I forked the hacs/default

and added my integration to the plugin file with this code
"Nisbo/ha-shopping-list-improved",

Now I am lost. The docu says something with Actions and that actions lives here:

If I want to submit a pull request it also request to check the actions

- [ ] I've read the [publishing documentation](https://hacs.xyz/docs/publish/start).
- [ ] I've added the [HACS action](https://hacs.xyz/docs/publish/action) to my repository.
- [ ] (For integrations only) I've added the [hassfest action](https://developers.home-assistant.io/blog/2020/04/16/hassfest/) to my repository.
- [ ] The actions are passing without any disabled checks in my repository.
- [ ] I've added a link to the action run on my repository below in the links section.
- [ ] I've created a new release of the repository after the validation actions were run successfully.

Please dont tell me to follow the link to the documentation, I already tried this together with ChatGPT. :wink: Normally I am not that stupid but in this case I am lost.

Can someone please lead me with the exact remaining steps I have to do to submit my card to the HACS store ?

2

This is what you need:

You don’t need a fork of HACS itself. The code of all integrations/cards is not inside HACS itself, only links to repos.

You create your own repo with the structure exemplified in GitHub - custom-cards/boilerplate-card: A community driven blueprint for best practices, then you request HACS to add your repo in the list that is distributed to all users.

3

Thx for your answer, but I am still lost.
I think I already did this:

But how/where can I do this:

then you request HACS to add your repo in the list that is distributed to all users.

4

Include default repositories - HACS is simplified/explained below.
I’m going to pretend you haven’t done anything yet aside from code the card.

  1. Add HACS Action to your Github repo and make sure it runs successfully. After it runs successfully, create a new release.

  2. Make a fork of HACS/Default. BEFORE you edit it go to [your repo’s url]default/branches and press New branch and choose master as the source. Make sure you’re on your new branch- in my case I named it ‘kattcrazy’.

    image
    image279×516 15.4 KB

  3. Go to the file named plugin and add your github repo (‘Nisbo/ha-shopping-list-improved’) to the list, making sure it’s in alphabetical order.

  4. Press ‘contribute’ to create a pull request. Make sure to complete and tick off each required item… see the below items.

I’ve read the publishing documentation.
Read the docs!
I’ve added the HACS action to my repository.
Item #1 in this post
(For integrations only) I’ve added the hassfest action to my repository.
Not required since this is a card.
The actions are passing without any disabled checks in my repository.
Did the HACS action from #1 successfully run?
I’ve added a link to the action run on my repository below in the links section.
Go add the link to the successful HACS action run.
I’ve created a new release of the repository after the validation actions were run successfully.
Again, #1.

  1. Wait for the devs to review the request and hopefully add it (may take weeks)

Hope this helps :slight_smile:

1 Like