Add support for custom integrations (#1558)

.github/PULL_REQUEST_TEMPLATE.md

@@ -17,8 +17,11 @@
   split it into multiple PRs. This makes things easier and faster to code review.
 -->
 
-- [ ] Add a new logo or icon for a new integration
-- [ ] Add a missing icon or logo for an existing integration
+- [ ] Add a new logo or icon for a new core integration
+- [ ] Add a missing icon or logo for an existing core integration
+- [ ] Add a new logo or icon for a custom integration (custom component)
+  - [ ] I've opened up a PR for my custom integration on the [Home Assistant
+    Python wheels repository](https://github.com/home-assistant/wheels-custom-integrations)
 - [ ] Replace an existing icon or logo with a higher quality version
 - [ ] Removing an icon or logo
 

.github/workflows/validate/validate.sh

@@ -38,6 +38,11 @@ while read image; do
     [[ "${foldername}" == _* && "${foldername}" != "_placeholder" && "${foldername}" != "_homeassistant" ]] \
       && error "${folderpath}" "Directories should not start with an underscore (_), please use the integration domain instead"
 
+    # Ensure the core and custom integrations don't collide
+    [[ -d "core_integrations/${foldername}" ]] \
+      && [[ -d "custom_integrations/${foldername}" ]] \
+        && error "${folderpath}" "The integration ${foldername} exists in both core and custom integrations. Core wins." 
+
     # Ensure file is actually a PNG file
     [[ "${type}" != "PNG" ]] \
       && error "${image}" "Invalid file type '${type}' for file"
@@ -98,7 +103,7 @@ while read image; do
     fi
 
     ((IMAGES++))
-done <<< $(find src -type f)
+done <<< $(find core_integrations custom_integrations -type f)
 
 echo ""
 echo "Total of ${IMAGES} images checked, found ${ERRORS} issues."

README.md

@@ -11,8 +11,18 @@ repository of brand images.
 
 ## Inner workings
 
-The `./src` folder contains a folder for each `domain` Home Assistant provides
-an integration for. A domain can contain four files:
+This repository provides two main folders to store images in:
+
+- `core_integrations`: Contains images for integrations bundled with the
+  Home Assistant Core.
+- `custom_integrations`: Contains images for custom integrations
+  (custom components).
+
+Each of these two main folders contain domain folders. Each domain folder is
+named to the integration `domain` and must match the domain set in the
+integration `manifest.json` file.
+
+A domain folder can contain four files:
 
 - `icon.png`: A square avatar-like icon, representing the brand or product for that domain.
 - `logo.png`: The logo of the brand or product for that domain.
@@ -117,6 +127,12 @@ cases and new directories with an underscore (`_`) should not be created.
 The names of directories must always match the integration domain. Additional
 directories are not allowed.
 
+## Integration domain conflict between custom and core integrations
+
+It is possible for a custom integration and a core integration to collide on
+a `domain` name level. In these cases, the core integration domain get
+preference.
+
 ## Tips, Tools & Resources
 
 When adding a new set of icons and logos, the following resources can help you