I follow any instruction how to add custom app to dekstop but it all doesnt work

Frappe Framework
, ,
1

Hi everyone,

I’m trying to do something that should be very simple: adding a custom app to the Desktop in Frappe v16, but I’m having a surprisingly hard time getting it to work.

I followed the instructions from this post:

How to Add a Custom App to Desktop in Frappe v16

I tried both approaches:

  1. Creating a Desktop Icon from the UI

  2. Using hooks.py

My current hooks.py configuration is:

add_to_apps_screen = [
	{
		"name": "perpustakaan",
		"logo": "/assets/perpustakaan/logo.png",
		"title": "Perpustakaan",
		# "route": "/perpustakaan",
		"route": "/desk/workspace-sidebar"
		# "has_permission": "perpustakaan.api.permission.has_app_permission"
	}
]

Initially I tried using:

"route": "/perpustakaan"

but I read that the route must exist, otherwise it won’t work. So for testing purposes I changed it to an existing route:

"route": "/desk/workspace-sidebar"

Then I ran the following commands:

bench migrate
bench sync-desktop-icons
bench clear-cache
bench restart

Unfortunately, the app icon still does not appear on the Desktop.

I also tried:

  • Browser hard refresh

  • Clearing cache

  • Incognito mode

  • Different browsers

None of them made any difference.

Am I missing a step? Is there any additional requirement in v16 (Workspace Sidebar, Desktop Icon linkage, fixtures, etc.) that is not mentioned in the documentation?

I’ve also noticed several other discussions and GitHub issues mentioning Desktop Icons not appearing in v16, so I’m wondering if this is currently a bug or if my configuration is incorrect.

Any help would be greatly appreciated.

Thanks!

2

Small update on this issue:

It turns out the problem is very strange.

image
image1618×470 20 KB

The custom app icon does not appear when logged in as Administrator, but it does appear correctly for a normal user account.

So currently the behavior is:

User App Icon Visible
Administrator :cross_mark: No
Regular User :white_check_mark: Yes

I did not change anything in the configuration between the tests.

This makes me think the issue may not be related to add_to_apps_screen itself, but possibly to:

  • Administrator-specific app filtering

  • Workspace/Desktop cache

  • Module access resolution

  • A v16 bug related to the new Apps/Desktop system

Has anyone encountered this behavior before?

Is there any special handling for Administrator in the new Desktop/Workspace architecture that could explain why the app is hidden only for Administrator?

Thanks!