feat(custom-widgets): add extensible widget platform

This commit is contained in:
ajnart committed 2026-09-12 13:54:05 +02:00
1 parent 6cca757493
commit 8f152f1929
317 files changed
+32326 -1788

No files matched your search

@@ -15,7 +15,10 @@ Custom Widgets may change during the v2 release cycle. Share feedback in the
:::
A **Custom Widget** is a validated `homarr-custom-widget-v2` definition containing API sources, queries and actions,
Custom Widgets supports [trusted widget packages](./trusted-packages) with full TSX, CSS, modules, optional Node
handlers, and advanced views, alongside the restricted v2 authoring format. Both can work without an API.
A **v2 Custom Widget** is a validated `homarr-custom-widget-v2` definition containing optional API sources, queries and actions,
optional settings, and a safe JSX template.
Homarr executes requests on the server and renders the template in a restricted runtime. Source credentials are
@@ -37,6 +40,8 @@ boards; actions require authentication and the permission declared by the reques
## Authoring
- [Build a trusted widget package](./trusted-packages), configure local connections, and manage its Workshop releases.
- [Create a Custom Widget](./authoring) in the workbench or from a copied AI prompt.
- [Use the safe JSX runtime](./custom-jsx) for data bindings, temporary inputs, and components.
- [Browse the component reference](./component-reference).