fix: simplify widget package publishing and navigation

This commit is contained in:
ajnart committed 2026-09-12 19:28:16 +02:00
1 parent 84058544a4
commit 9ff1019a3d
21 files changed
+811 -396

No files matched your search

@@ -333,14 +333,20 @@ In Workshop, select a release, inspect source files and dependencies, and option
**Import for review** opens the package workspace with a disabled local installation. Preview and activate it after
reviewing trust, then add it to a board.
The workspace's Workshop section checks for newer releases and reports local source changes. Staging an update
requires acknowledging replacement of the saved draft; the active release continues running until activation.
Fork or export local changes you want to keep before replacing the draft.
The **Packages** library shows each installation’s version, author, and **View on Workshop** link. Choose
**Check for updates**, then **Review update** to load a release into the editor. If your saved draft has local
changes, confirm its replacement first. The active release continues running until you activate the reviewed draft.
Use **Duplicate** or export local changes you want to keep before replacing them.
Publishing requires a Workshop account and an explicit review of the saved source for secrets, local information,
and permission to share the code and dependencies. Publish a new package, an immutable release of a package you own,
or an attributed fork. Give each release a new version in the manifest and describe its changes. Local bindings and
credentials remain on the Homarr installation.
Choose **Publish to Workshop** from the package’s action menu or its editor. Packages and Custom JSX widgets use the
same publishing form: sign in, add a title, description, and optional screenshots, then publish. The signed-in Workshop
account receives attribution. Homarr updates your existing listing or creates an attributed copy of another author’s
package automatically. **Release details** contains the version and optional release notes; updates suggest the next
patch version. Review source, dependencies, and fixtures before publishing. Local bindings and credentials remain
on the Homarr installation.
The management sidebar can collapse to icons using its toggle. It collapses automatically in the package editor to
leave more room for code and preview; expand it whenever you need the full labels. On mobile, use the header menu.
## Reference packages with local services
+5
View File
@@ -37,6 +37,11 @@ Custom Widget credentials are configured in your Homarr instance and are not par
Publish a saved Custom Widget from its action menu under **Management → Custom Widgets**. Custom CSS and manual
submissions can be published from the Workshop website.
Trusted v3 packages use the same publishing form, with attribution from your signed-in Workshop account.
Homarr selects a new listing, an update to your listing, or an attributed copy automatically. Version and optional
release notes are under **Release details**. Find version indicators, **Check for updates**, and **View on Workshop**
in the **Packages** library.
Trusted v3 packages publish immutable releases. When editing a release and its screenshots together, Homarr validates
the screenshot count before publishing, so an invalid screenshot edit does not consume the proposed package version.