Skip to content

Conversation

@frenck
Copy link
Member

@frenck frenck commented Jan 27, 2026

Proposed Changes

Happy New Year 🥂

This PR refactors the general add-on structure a bit, most notably renaming the add-on naming to apps (following Home Assistant's naming change).

This PR also updates for the upstream workflow changes and improvements.

Summary by CodeRabbit

  • Documentation

    • Updated Code of Conduct to version 3.0 with revised reporting, addressing, and repair guidance.
    • Rebranded project content and docs from "Add-on" to "App" throughout README, examples, and docs.
  • Chores

    • Updated license/copyright year to 2026.
    • Updated contribution links and examples to app paths.
    • Adjusted CI/CD workflow permissions and references; tuned Renovate and linting configs.

✏️ Tip: You can customize this high-level summary in your review settings.

@frenck frenck added refactor Improvement of existing code, not introducing new features. maintenance Generic maintenance tasks. labels Jan 27, 2026
@coderabbitai
Copy link

coderabbitai bot commented Jan 27, 2026

Walkthrough

This pull request rebadges the project from "Add-on" to "App" across docs, examples, Docker labels, and scripts; upgrades the Code of Conduct to Contributor Covenant 3.0; adds top-level permissions and updates reusable workflow references to pinned commits; and bumps copyright years to 2026.

Changes

Cohort / File(s) Summary
Code of Conduct & Contributing
.github/CODE_OF_CONDUCT.md, .github/CONTRIBUTING.md
CODE_OF_CONDUCT.md rewritten to Contributor Covenant 3.0 (new pledge, encouraged/restricted behaviors, reporting and repair ladder) (+149/-120). CONTRIBUTING.md URL references changed from addon-exampleapp-example (+2/-2).
Renovate & Linting
.github/renovate.json, .yamllint
renovate.json adds extends: ["helpers:pinGitHubActionDigests"] and renames Docker group labels to "App base image". yamllint relaxes comment spacing and disables line-length rule.
GitHub Workflows
.github/workflows/ci.yaml, .github/workflows/deploy.yaml, .github/workflows/labels.yaml, .github/workflows/lock.yaml, .github/workflows/pr-labels.yaml, .github/workflows/release-drafter.yaml, .github/workflows/stale.yaml
Added top-level permissions fields (contents, packages, issues, pull-requests, security-events as applicable). Reusable workflow uses updated from addon-* @main to app-* pinned commit @ce3689265f9e961665382659491ff91a22cb64ad with # v2.0.0 comments; deploy.yaml also adds workflow_run trigger and a comment about dangerous triggers.
License & README
LICENSE.md, README.md
Copyright year advanced to 2026. README rebrands repo and text from add-on → app, updates badges/links to app-example, and updates maintainer/metadata.
Example docs & metadata
example/.README.j2, example/DOCS.md, example/config.yaml
Rebranded content and links from add-on → app, updated build/environment wording to "Home Assistant Community Apps", bumped copyright years, and updated config.yaml description/url to app-example.
Example Docker & labels
example/Dockerfile
Updated LABEL fields: maintainer email to opensource@frenck.dev, vendor/authors/url adjusted to Home Assistant Community Apps and frenck.dev/home-assistant-apps.
Example runtime scripts & init
example/rootfs/etc/s6-overlay/s6-rc.d/.../run, .../finish, example/rootfs/etc/s6-overlay/s6-rc.d/init-example/run, example/rootfs/usr/bin/*.sh
Header/comment strings updated from "Home Assistant Community Add-on: Example" → "Home Assistant Community App: Example". No functional changes.
Translations
example/translations/en.yaml
Two description strings updated to use "app" instead of "add-on".

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~30 minutes

Poem

🐰 I hopped through files with joyful cheer,

Changed "add-on" to "app" far and near,
New conduct, workflows pinned in line,
Copyrights bumped — the code looks fine! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title accurately reflects the main objective of this changeset: comprehensive refactoring to rename add-ons to apps throughout the project.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@frenck frenck changed the title Refactgoring and renaming add-ons to apps Refactoring and renaming add-ons to apps Jan 27, 2026
@github-advanced-security
Copy link

This pull request sets up GitHub code scanning for this repository. Once the scans have completed and the checks have passed, the analysis results for this pull request branch will appear on this overview. Once you merge this pull request, the 'Security' tab will show more code scanning analysis results (for example, for the default branch). Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results. For more information about GitHub code scanning, check out the documentation.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Fix all issues with AI agents
In @.github/CONTRIBUTING.md:
- Around line 28-29: The CONTRIBUTING.md link references ([github], [prs]) point
to a non-existent repository (app-example) causing 404s; update the URL targets
used by the link labels ([github], [prs]) to the existing addon-example
repository (use https://github.com/hassio-addons/addon-example and the
corresponding /issues and /pulls paths) or restore the original addon-example
links so the links resolve correctly; locate the link definitions for [github]
and [prs] in the file and replace the app-example URLs with the addon-example
equivalents (or adjust to the correct repo if you create/rename app-example).

In @.github/workflows/ci.yaml:
- Around line 22-23: Replace the floating ref "@main" in the reusable workflow
invocation (the string
"hassio-addons/workflows/.github/workflows/app-ci.yaml@main") with an immutable
pinned ref (preferably a full commit SHA or a fixed tag) so CI uses a specific
upstream revision; update the workflow to reference that SHA/tag and
document/update it via deliberate PRs when you want to move to a newer upstream
version.

In `@example/config.yaml`:
- Around line 5-6: The URL in the config.yaml's url field is broken; open the
file, locate the url key (next to the description key) and replace the existing
value "https://github.com/hassio-addons/app-example" with the verified correct
GitHub repository URL for this app (or remove/disable the link if no repository
exists), ensuring the url value is a valid reachable HTTPS GitHub repo.

In `@example/DOCS.md`:
- Around line 34-35: Replace the typo "Eventought" with "Even though" in the
DOCS.md introduction sentence (the string "Eventought this app is just an
example app, it does come with some configuration options to play around with.")
so the line reads "Even though this app is just an example app, it does come
with some configuration options to play around with."

Comment on lines +28 to +29
[github]: https://github.com/hassio-addons/app-example/issues
[prs]: https://github.com/hassio-addons/app-example/pulls
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify the GitHub repository URLs are accessible

echo "Testing app-example repository base URL:"
curl -s -o /dev/null -w "Status: %{http_code}\n" "https://github.com/hassio-addons/app-example"

echo "Testing issues endpoint:"
curl -s -o /dev/null -w "Status: %{http_code}\n" "https://github.com/hassio-addons/app-example/issues"

echo "Testing pulls endpoint:"
curl -s -o /dev/null -w "Status: %{http_code}\n" "https://github.com/hassio-addons/app-example/pulls"

# Also test if the old addon-example still exists for comparison
echo "Testing old addon-example repository (for reference):"
curl -s -o /dev/null -w "Status: %{http_code}\n" "https://github.com/hassio-addons/addon-example"

Repository: hassio-addons/addon-example

Length of output: 262


Do not merge: The new repository URLs are not accessible (404).

The app-example repository does not exist. All three URLs return HTTP 404:

The old addon-example repository is still live and accessible (HTTP 200). Either rename/create the app-example repository before merging, or revert these URLs to point to addon-example.

🤖 Prompt for AI Agents
In @.github/CONTRIBUTING.md around lines 28 - 29, The CONTRIBUTING.md link
references ([github], [prs]) point to a non-existent repository (app-example)
causing 404s; update the URL targets used by the link labels ([github], [prs])
to the existing addon-example repository (use
https://github.com/hassio-addons/addon-example and the corresponding /issues and
/pulls paths) or restore the original addon-example links so the links resolve
correctly; locate the link definitions for [github] and [prs] in the file and
replace the app-example URLs with the addon-example equivalents (or adjust to
the correct repo if you create/rename app-example).

Comment on lines +5 to +6
description: Example app by Home Assistant Community Apps
url: https://github.com/hassio-addons/app-example
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify the GitHub repo URL resolves
curl -s -o /dev/null -w "%{http_code}\n" -I https://github.com/hassio-addons/app-example

Repository: hassio-addons/addon-example

Length of output: 74


Fix broken GitHub repository URL.

The URL https://github.com/hassio-addons/app-example returns HTTP 404 and does not exist. Verify the correct repository name and update the URL accordingly.

🤖 Prompt for AI Agents
In `@example/config.yaml` around lines 5 - 6, The URL in the config.yaml's url
field is broken; open the file, locate the url key (next to the description key)
and replace the existing value "https://github.com/hassio-addons/app-example"
with the verified correct GitHub repository URL for this app (or remove/disable
the link if no repository exists), ensuring the url value is a valid reachable
HTTPS GitHub repo.

Comment on lines +34 to 35
Eventought this app is just an example app, it does come with some
configuration options to play around with.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix typo in configuration intro.

Line 34 reads “Eventought” → “Even though”.

Proposed fix
-Eventought this app is just an example app, it does come with some
+Even though this app is just an example app, it does come with some
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Eventought this app is just an example app, it does come with some
configuration options to play around with.
Even though this app is just an example app, it does come with some
configuration options to play around with.
🤖 Prompt for AI Agents
In `@example/DOCS.md` around lines 34 - 35, Replace the typo "Eventought" with
"Even though" in the DOCS.md introduction sentence (the string "Eventought this
app is just an example app, it does come with some configuration options to play
around with.") so the line reads "Even though this app is just an example app,
it does come with some configuration options to play around with."

@frenck frenck merged commit 17b887c into main Jan 27, 2026
24 checks passed
@frenck frenck deleted the frenck-2026-0010 branch January 27, 2026 21:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance Generic maintenance tasks. refactor Improvement of existing code, not introducing new features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants