34 lines
1.8 KiB
Plaintext
34 lines
1.8 KiB
Plaintext
---
|
|
sidebar_label: Troubleshooting
|
|
---
|
|
|
|
# Troubleshooting
|
|
|
|
## The preview says the template is required
|
|
|
|
New Custom JSX forms always include the starter fixture. If an imported definition has an empty template, reopen its import review; malformed imports must be corrected rather than previewed as JSX.
|
|
|
|
## A prop is ignored
|
|
|
|
The diagnostics name the component and prop. Check the generated component reference. Unsupported props are intentionally removed; use a supported layout primitive or wrapper prop instead of polymorphic, portal, ref, positioning, or raw handler props.
|
|
|
|
## A request does not run
|
|
|
|
Confirm that the component kind matches the manifest: `SubFetch` needs a query; action controls need an action. Parameter names and primitive types must match exactly. Base requests and queries require GET. Actions only run from a gesture, and edit mode disables controls.
|
|
|
|
## Network scope errors
|
|
|
|
Resolve the hostname from the Homarr server environment. Select private or loopback scope only when required and understood. Link-local and metadata destinations cannot be enabled by any scope. Redirects must remain on the base origin.
|
|
|
|
## Permission errors
|
|
|
|
The placed board item is the authorization anchor. A definition ID alone cannot authorize credential use. Verify board view/modify/full access, explicit viewer-action approval, and that the caller is not anonymous.
|
|
|
|
## Stale or failed preview data
|
|
|
|
Connection, authentication, body, method, secret, or manifest changes mark samples stale. Run the GET test again. Background query failures keep prior content visible and offer retry; actions roll toggles back and show error feedback.
|
|
|
|
## Import paste is ignored
|
|
|
|
Paste a complete v2/v3 JSON export or authoring bundle while the list or edit page is focused. Ordinary text and partial JSON are ignored so normal typing is not intercepted.
|