Skip to content

Add apps info page for non-HAOS installations#30364

Open
mishasyrbu wants to merge 1 commit intohome-assistant:devfrom
mishasyrbu:add-apps-info-page-non-hassio
Open

Add apps info page for non-HAOS installations#30364
mishasyrbu wants to merge 1 commit intohome-assistant:devfrom
mishasyrbu:add-apps-info-page-non-hassio

Conversation

@mishasyrbu
Copy link
Copy Markdown

@mishasyrbu mishasyrbu commented Mar 26, 2026

Proposed change

On non-Home Assistant Operating System installations, the Apps item in settings opens a page that explains what apps are and why the user doesn't have access to them, referencing the Apps

The page explains:

  • What is an app
  • Why you see this page instead of an app store

A "Don't show again" button lets the user dismiss the page and hides the Apps entry from the settings dashboard. If the user later migrates to HAOS, the full app store reappears automatically.

Screenshots

image image

Type of change

  • Dependency upgrade
  • Bugfix (non-breaking change which fixes an issue)
  • New feature (thank you!)
  • Breaking change (fix/feature causing existing functionality to break)
  • Code quality improvements to existing code or addition of tests

Additional information

Checklist

  • I understand the code I am submitting and can explain how it works.
  • The code change is tested and works locally.
  • There is no commented out code in this PR.
  • I have followed the development checklist
  • I have followed the perfect PR recommendations
  • Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

To help with the load of incoming pull requests:

Testing

Setup

For non-HAOS installations only (where the hassio component is not loaded).

Test the info page

  1. Navigate to Settings and click Apps
  2. Verify the info page is displayed with:
    • "What is an app?" section explaining what apps are
    • "Why you see this page instead of an app store" section
    • An info alert about Home Assistant Operating System
    • A "Learn more" link pointing to the documentation
    • A "Don't show again" button

Test the dismiss flow

  1. On the info page, click Don't show again
  2. Verify you are navigated back to the Settings dashboard
  3. Verify the Apps item is no longer visible in the Settings dashboard

Test reset (to re-show the info page)

Run the following in the browser console:

const ha = document.querySelector("home-assistant").hass; 
const current = await ha.connection.sendMessagePromise({ type: "frontend/get_user_data", key: "core" });
await ha.connection.sendMessagePromise({ type: "frontend/set_user_data", key: "core", value: { ...current.value, apps_info_dismissed: false } });

Then refresh the page and verify the Apps item reappears in Settings.

Test HAOS installations

  1. On an HAOS installation (where hassio is loaded), verify the Apps item navigates to the normal app store as before
  2. Verify the info page is never shown, even if apps_info_dismissed is false

Copy link
Copy Markdown

@home-assistant home-assistant bot left a comment

Choose a reason for hiding this comment

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

Hi @mishasyrbu

It seems you haven't yet signed a CLA. Please do so here.

Once you do that we will be able to review and accept this pull request.

Thanks!

@home-assistant home-assistant bot marked this pull request as draft March 26, 2026 17:25
@home-assistant
Copy link
Copy Markdown

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@mishasyrbu mishasyrbu force-pushed the add-apps-info-page-non-hassio branch from 7588f60 to 6f97a3f Compare March 26, 2026 17:29
@mishasyrbu mishasyrbu marked this pull request as ready for review March 26, 2026 18:43
@Yevgenium
Copy link
Copy Markdown
Contributor

Please don't clutter the menu with useless items. Anyone who has managed to install a non-HAOS system probably knows why he doesn't have access to apps.

@MindFreeze MindFreeze added the Needs UX Items requiring a review from the Home Assistant design team label Mar 27, 2026
@timmo001
Copy link
Copy Markdown
Member

timmo001 commented Mar 27, 2026

Some installations are managed by other providers (see SwitchBot AI Hub and I think Aqara make a wall panel with HA inside too?)

These are cases where something like this could be useful.

Might be a good idea to always hide for unsupported installs like python direct installs, I agree there. Not sure what frontend has access to in this regard. May need additional core change for knowing the exact install case

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Needs UX Items requiring a review from the Home Assistant design team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add "App" item in Settings menu for container users

4 participants