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

+405 -5
View File
@@ -803,7 +803,8 @@
"tabs": {
"ariaLabel": "Custom widget sections",
"installed": "Installed",
"workshop": "Workshop"
"workshop": "Workshop",
"packages": "Packages"
}
},
"action": {
@@ -912,6 +913,16 @@
"preview": "Test and preview",
"previewLoading": "Testing requests"
},
"history": {
"undo": "Undo",
"redo": "Redo",
"reset": "Reset to saved",
"credentialsExcluded": "Credentials are excluded from history and recovery.",
"recoveryTitle": "Recover your unsaved widget",
"recoveryDescription": "A draft from this browser is available. Review it before saving; enter unsaved credentials again.",
"restore": "Restore draft",
"discard": "Discard draft"
},
"requests": {
"title": "Named queries and actions",
"label": "Requests",
@@ -929,6 +940,7 @@
"type": "Type",
"method": "Method",
"source": "API source",
"sourceRequired": "This widget works without requests. Add an API source when you need live data or actions.",
"run": "Run",
"runLoad": "When the widget loads",
"runManual": "From SubFetch",
@@ -994,6 +1006,7 @@
},
"sources": {
"title": "API sources and credentials",
"empty": "No API is required. Build with JSX and widget options, or connect a service below.",
"newName": "API {count, number}",
"duplicateSourceId": "API source IDs must be unique.",
"credentialRemoved": "Credential removed",
@@ -1016,7 +1029,7 @@
"clear": "Clear",
"remove": "Remove source and its requests",
"advanced": "Advanced",
"add": "Add another API source"
"add": "Add API source"
},
"ai": {
"title": "Create or fix with any AI",
@@ -1031,6 +1044,7 @@
},
"preview": {
"invalid": "Fix validation errors to preview this widget.",
"staleSnapshot": "Showing the last data snapshot with your latest JSX. Run Test and preview to refresh data and enable API interactions.",
"fixtureError": "Preview fixture error",
"requestData": "Request data",
"status": {
@@ -1097,6 +1111,13 @@
"empty": "Empty",
"error": "Error"
}
},
"repair": {
"title": "Repair widget",
"description": "This saved widget has validation errors. Repair its source without changing its dashboard identity. Credentials are retained only when the source and authentication binding remain unchanged.",
"source": "Widget source",
"save": "Save repaired widget",
"export": "Export repair draft"
}
},
"preview": {
@@ -1168,6 +1189,363 @@
"username": "Username",
"password": "Password",
"savedPlaceholder": "••••••• (saved, leave empty to keep)"
},
"package": {
"title": "Widget packages",
"create": "Create package",
"library": "Packages",
"libraryDescription": "Build dashboard widgets with full TSX, CSS, modules, and optional server code. Import a package to inspect its source and connect your local services before activating it.",
"search": "Search packages",
"empty": "No matching packages. Create a source-free widget or import a package to get started.",
"openWorkspace": "Open workspace",
"draftOnly": "Draft only",
"active": "Active",
"disabled": "Disabled",
"import": "Import package",
"importTooLarge": "Package exceeds the 25 MB import limit.",
"invalidPackage": "Choose a widget package or archive JSON file.",
"name": "Installation name",
"unsaved": "Unsaved changes",
"saved": "Saved draft",
"saveDraft": "Save draft",
"draftSaved": "Draft saved. Dashboard placements still use the active release.",
"recovery": "A recovery draft is available for this package. Local connection credentials are stored separately; recognized credential literals are removed from recovery source.",
"restore": "Restore draft",
"discard": "Discard recovery",
"undo": "Undo",
"redo": "Redo",
"reset": "Reset to saved",
"historyDescription": "Undo/Redo covers the whole document, up to 100 changes and 2 MB. One browser recovery draft, up to 1 MB.",
"code": "Source files",
"connections": "Connections",
"installation": "Activation & boards",
"starter": "Reference starter",
"chooseStarter": "Choose a reference package",
"clock": "World clock · no API required",
"filePath": "Relative file path",
"addFile": "Add",
"renameFile": "Rename",
"removeFile": "Remove",
"invalidPath": "Enter an unused relative file path without parent-directory traversal.",
"duplicatePath": "A file already exists at this path.",
"renameImports": "File renamed. Update imports and manifest entrypoints that refer to its previous path.",
"draftInvalid": "This draft can be saved. Resolve these package errors before preview or activation.",
"reviewTrust": "Review code & dependencies",
"trustedCode": "This package runs trusted JavaScript in Homarr and may run Node code with Homarr's server privileges. Review every source file and dependency before running it. Preview also executes package code.",
"dependencies": "Additional dependencies",
"hostOnly": "Shared Homarr modules only",
"trustAcknowledgement": "I trust this source and its dependencies to run on my Homarr instance.",
"preview": "Run preview",
"exportDraft": "Export source draft",
"saveFirst": "Save this draft first to enable preview, save local bindings, and activate it.",
"surface": "Preview surface",
"tile": "Dashboard tile",
"advanced": "Advanced view",
"configuration": "Configuration view",
"width": "Width",
"height": "Height",
"previewStale": "Showing the previous preview. Its SDK activity is paused. Run preview to verify the current draft.",
"previewEmpty": "Review the code, acknowledge trust, then run this draft in a preview session.",
"previewDescription": "Preview uses its own temporary widget storage. SDK named actions are simulated unless live actions are enabled for this session. Trusted code can still make direct network calls or external changes.",
"previewLiveActions": "Allow live SDK actions for this preview session",
"languageService": {
"loading": "Loading TypeScript…",
"ready": "TypeScript ready",
"problems": "{count} TypeScript issues",
"unavailable": "TypeScript assistance is unavailable",
"help": "Ctrl+Space: completions with types. Hover: type and documentation. F12: definition. F2: rename across package files. Types come from this Homarr installation; other dependencies can include local .d.ts files.",
"rename": "New symbol name",
"applyRename": "Rename in package",
"cancel": "Cancel",
"changed": "The source changed. Select the symbol and start rename again.",
"declaration": "Installed declaration · read-only excerpt starting at line {line}",
"backToSource": "Back to package source"
},
"resizeEditor": "Resize code editor and preview",
"options": "Widget options",
"resizeEditorHint": "Drag or use the arrow keys to resize. Double-click to reset.",
"collections": {
"title": "Widget collections",
"description": "Share several independent widgets in one archive and connect their services once.",
"empty": "Import a collection archive, or export a collection from your activated packages.",
"members": "{count, plural, one {# widget} other {# widgets}} · {enabled} active",
"configure": "Set up collection",
"export": "Export a collection",
"exportDescription": "Choose activated packages to share. The archive includes compiled code and connection requirements. Local credentials, addresses, placement settings and stored data are excluded.",
"widgets": "Widgets",
"name": "Collection name",
"identity": "Collection ID",
"identityDescription": "A stable name such as my-homelab.",
"identityPlaceholder": "my-homelab",
"version": "Version",
"importTooLarge": "Collection archives must be smaller than 128 MiB.",
"setupDescription": "Connect the shared services, choose your widgets, then activate them and add them to a board.",
"optionsDescription": "These settings apply to new tiles. Existing tiles can be configured from their board.",
"review": "Review source",
"needsRepair": "{name} needs repair. Open its workspace before activating it.",
"bindingConflicts": "Some widgets use different connections for these shared services: {names}. Save the shared connections to align them.",
"trust": "I trust the selected packages and their dependencies to run inside Homarr.",
"activationDescription": "Activation applies saved package code to every board using that installation. Each widget reports its result separately.",
"activateAndAdd": "Activate and add missing widgets",
"activating": "Activating package…",
"adding": "Adding to board…",
"added": "Added to board",
"alreadyPlaced": "Already on this board",
"stop": "Stop after this widget"
},
"previewLiveSession": "Session: live SDK actions",
"previewSimulatedSession": "Session: simulated SDK actions",
"connectionsDescription": "Bind the package's named connections to services on this Homarr instance. Saving bindings updates every placement that inherits them; placements can override a connection in board settings.",
"noConnections": "This package needs no API or service connection.",
"diagnose": "Diagnose",
"newConnection": "Create local connection",
"saveBindings": "Save installation bindings",
"bindingsSaved": "Installation bindings saved.",
"connectionKind": "Connection type",
"integration": "Homarr integration",
"serverUrl": "Server URL",
"browserUrl": "Browser URL (optional)",
"localNetwork": "Requests originate from the Homarr server/container. LAN, Docker DNS, localhost, and Tailscale addresses are supported; localhost points to Homarr's own network namespace.",
"authentication": "Authentication",
"username": "Username",
"credential": "Credential",
"secretHeaders": "Secret headers (JSON object)",
"verifyTls": "Verify TLS certificates",
"timeout": "Request timeout (ms)",
"saveConnection": "Save connection",
"stringMap": "Enter a JSON object whose values are strings.",
"previewOptions": "Preview options",
"resetOptions": "Reset preview options to package defaults",
"activation": "Activation",
"activationDescription": "Activate the saved draft for all {count} dashboard placements of this installation. Existing placements keep their option values. A failed activation keeps the current release running.",
"activeArtifact": "Active artifact",
"none": "None",
"saveBeforeActivate": "Save your changes before activating. Activation always uses the saved draft.",
"activate": "Activate saved draft",
"activated": "Saved package activated.",
"disable": "Disable installation",
"enable": "Enable installation",
"stateSaved": "Installation state saved.",
"exportActive": "Export active archive",
"rollbackAcknowledgement": "Restore the previous activation, connection bindings, placement options, and widget data. I accept losing newer widget data. External service changes cannot be undone.",
"rollback": "Roll back previous activation",
"rolledBack": "Previous activation restored. Your source draft is retained.",
"addToBoard": "Add to board",
"board": "Board",
"placementDescription": "Add a placement of the active release. These options belong to this placement; future placements can use different values.",
"bindFirst": "Configure installation connections first: {names}",
"addedToBoard": "Widget added to the board.",
"placements": "{count} dashboard placements",
"openBoard": "Open board",
"guestActions": "Guest actions",
"guestDescription": "Allow guests to invoke only the named action with the exact inputs below. Grants must be renewed when server code, dependencies, or bound connections change.",
"allowedInputs": "Allowed inputs (JSON array)",
"inputsArray": "Enter an array of exact action inputs.",
"enableGuest": "Enable this guest action",
"disableGuest": "Disable this guest action",
"activity": "Recent activity",
"refresh": "Refresh",
"noActivity": "No recent widget activity.",
"changes": "Review saved draft changes",
"before": "Active release",
"after": "Saved draft",
"dependenciesChanged": "Dependencies changed",
"connectionsChanged": "Connections changed",
"configurationChanged": "Configuration changed",
"stageUpdate": "Stage archive update",
"replaceDraft": "Replace my saved source draft with the selected update. My active release continues running until I activate the update.",
"fork": "Fork as a new package",
"forkName": "Fork name",
"forkDescription": "Fork the saved source into a new disabled installation with a new package identity.",
"updateStaged": "Update staged for review.",
"sourceOnly": "Source files and dependency metadata are shown without executing package code.",
"releaseReview": "Review package release",
"release": "Release",
"installDisabled": "This imports a disabled draft. You will review trust, preview it, and activate it in the workspace.",
"installReview": "Import for review",
"workshopLifecycle": "Workshop releases",
"checkUpdates": "Check for updates",
"upstreamRelease": "Imported release: {version}",
"localChanges": "Your saved source differs from its Workshop release. Export or fork it before replacing your draft.",
"updateAvailable": "Release {version} is available",
"stageWorkshopUpdate": "Stage Workshop update",
"publishWorkshop": "Publish to Workshop",
"publishMode": "Publish as",
"publishNew": "New package",
"publishUpdate": "New release of my package",
"publishFork": "Fork with upstream attribution",
"forkedFrom": "Original Workshop release ID",
"changelog": "Release notes",
"publishAcknowledgement": "I reviewed the complete saved source for secrets and local information, and I have permission to share this code and its dependencies publicly.",
"published": "Published release {version}.",
"openWorkshop": "Open Workshop page",
"manifestFile": "widget.json",
"filePathExample": "components/Status.tsx",
"serverUrlExample": "http://sonarr:8989",
"headersExample": "{\"X-Api-Key\":\"...\"}",
"collection": "History collection",
"collectionDescription": "Opt in to scheduled collection for this placement. Homarr runs the selected query even when no dashboard is open and retains a bounded series. Collection is disabled until you enable it.",
"collectorName": "Collection name",
"queryHandler": "Query handler",
"queryInput": "Query input (JSON)",
"valuePath": "Value path (optional, dot separated)",
"unit": "Unit",
"collectionInterval": "Interval (seconds)",
"retentionDays": "Retention (days)",
"maximumPoints": "Maximum samples",
"enableCollection": "Enable scheduled collection",
"saveCollector": "Save collection",
"pauseCollection": "Pause collection",
"discardCollectedHistory": "Discard this collection and its stored history.",
"removeCollector": "Remove collection",
"newName": "My widget",
"editConnection": "Edit connection",
"editConnectionImpact": "Changes apply to every widget using this connection. Leave credential fields empty to keep stored credentials. Changing authentication replaces the previous credentials; enter all required values for the new method.",
"files": "Files",
"historyInfo": "Undo, redo, and recovery details",
"trustShort": "Trust this code and its dependencies",
"executionDetails": "Execution & dependency details",
"size": "Size",
"retryPreparation": "Retry widget preparation",
"connectionName": "Connection name",
"assistant": {
"open": "Ask Assistant",
"context": "Uses this draft and public SDK context",
"request": "What would you like to build?",
"requestPlaceholder": "Describe a widget, a design change, or a capability…",
"send": "Propose changes",
"improve": "Improve this widget",
"advanced": "Add an advanced view",
"fix": "Fix current errors",
"improvePrompt": "Improve this widget’s design, responsiveness and useful capabilities while preserving its purpose.",
"advancedPrompt": "Add a useful advanced view to this widget, sharing components and state with the dashboard tile. Include a clear way to open it.",
"fixPrompt": "Inspect this widget’s current source and diagnostics. Propose a focused fix for the current errors without changing unrelated behavior.",
"review": "Review package changes",
"reviewDescription": "Apply changes to the open draft as one Undo step. Save, preview and activation remain separate actions.",
"before": "Before",
"after": "After",
"apply": "Apply to draft",
"reject": "Reject",
"applied": "Changes applied to the draft. Save and preview to verify them.",
"rejected": "Proposal rejected.",
"preparing": "Preparing proposed changes…",
"invalidProposal": "This proposal is incomplete or invalid.",
"reading": "Reading the open package draft…",
"read": "Read the open package draft"
},
"sessionUnavailable": "Preview session unavailable",
"sessionUnavailableDescription": "The session expired, was discarded, or belongs to another account. Sign in as the API key owner and create a fresh CLI preview.",
"sessionDescription": "This is the exact preview candidate already trusted through the CLI. Opening it renders its compiled code. SDK actions remain simulated; arbitrary trusted code can still run.",
"webhook": {
"title": "Webhooks",
"description": "Run a named action with an authenticated POST and JSON matching its input schema (up to 1 MiB). Code and connection changes invalidate tokens; issue a new token afterward. Rollback does not restore revoked tokens.",
"handler": "Action handler",
"create": "Create webhook",
"noHandlers": "Declare an action with an input schema to enable webhooks.",
"issued": "Copy this token now",
"issuedDescription": "The token is shown once and stays only in this browser view. Send it in the Authorization header as Bearer followed by the token. Closing this message removes it from view.",
"url": "POST URL",
"token": "Bearer token",
"copyUrl": "Copy URL",
"copyToken": "Copy token",
"current": "Current",
"reissue": "Needs reissue",
"revoke": "Revoke"
},
"conversion": {
"title": "Convert to a widget package",
"description": "Create a disabled package copy, preserving the current Custom JSX widget and its board placements. Local source connections and credentials are copied on the server. Review the generated files, preview the package and activate it before adding it to a board.",
"savedSource": "Conversion uses the saved Custom JSX definition. The initial package keeps a compatible JSX surface that you can extend with new TSX modules and advanced views.",
"name": "Package installation name",
"create": "Create package copy",
"back": "Back to Custom JSX",
"shortTitle": "Convert to package",
"replaceTitle": "Replace an existing Custom JSX tile",
"replaceDescription": "Choose one original tile to use this activated package. Its position, size, refresh interval and configured values are preserved. The original Custom JSX definition and its other tiles remain available.",
"activateFirst": "Preview and activate this package before replacing an existing tile.",
"choosePlacement": "Choose an original tile",
"noOriginalPlacements": "No remaining tiles use the original Custom JSX definition. You can add the package as a new tile instead.",
"replaceSelected": "Replace selected tile",
"replaced": "The selected tile now uses this package. Its placement and configuration were preserved."
},
"useUrlSuggestion": "Use {url}",
"diagnostic": {
"status": {
"connected": "Service reached",
"integration": "Native integration selected",
"dnsError": "Hostname could not be resolved",
"unavailable": "Service could not be reached",
"credentialsRequired": "Authentication needs attention",
"httpError": "Service returned an error",
"redirect": "Service returned a redirect",
"serviceConfigured": "Service settings saved",
"fileReadable": "File is readable",
"transportReachable": "TCP endpoint is reachable",
"serviceUnavailable": "Service probe failed"
},
"help": {
"connected": "Homarr received a successful HTTP response. Preview the widget to verify its required endpoint and data.",
"integration": "This connection uses an existing Homarr integration. Preview its query to verify the application data.",
"dnsError": "Check the hostname and the DNS or Docker network available to the Homarr server.",
"unavailable": "Check the service address, port, network reachability and certificate configuration.",
"credentialsRequired": "Check this local connection’s authentication method and stored credentials.",
"httpError": "The server responded. Check the URL and application endpoint in the technical details.",
"redirect": "The service returned a redirect. Use the destination URL for this connection if appropriate.",
"serviceConfigured": "This service has no generic network probe. Run the widget preview to validate its adapter, settings and credentials.",
"fileReadable": "The Homarr process can open this regular file for reading. Run preview to check its format and the widget query.",
"transportReachable": "The broker accepted a TCP connection. TLS, MQTT authentication and topic permissions are checked when the widget subscribes in preview.",
"serviceUnavailable": "Check the configured service settings, mounted file permissions, network address and container access. Details describe the failed transport probe."
},
"stage": {
"dns": "DNS lookup",
"connection": "Network connection",
"tls": "TLS verification",
"response": "HTTP response"
},
"phase": "Reached stage: {phase}",
"response": "HTTP {status} · {milliseconds} ms",
"fields": "Top-level JSON fields: {fields}",
"details": "Technical details"
},
"historySummary": {
"latest": "Latest sample: {time}",
"empty": "No retained samples yet. Enable collection and wait for its next scheduled run.",
"samples": "View {count} sampled points",
"time": "Time",
"value": "Value",
"details": "Technical details"
},
"artifactReview": {
"title": "Inspect compiled code and dependency lock",
"file": "Compiled output",
"description": "These supplied browser and server outputs may execute during preview or activation. The digest verifies artifact integrity; it does not prove that the compiled output was built from the accompanying source. Review the actual code and dependency lock before trusting it."
},
"secretQuery": "Secret query parameters (JSON)",
"service": "Service (database, MQTT, SSH, files…)",
"serviceType": "Service type",
"serviceTypeHelp": "Must match the widget requirement, for example sqlite, mqtt, file, ssh or custom. No HTTP URL is required.",
"serviceSettings": "Nonsecret settings (JSON)",
"serviceSettingsHelp": "JSON settings for your server adapter. SQLite and files use a path property; MQTT uses url and topics properties.",
"serviceSettingsObject": "Service settings must be a JSON object.",
"serviceSecrets": "Encrypted credentials (JSON string values)",
"serviceSecretsHelp": "A JSON object with string values such as username and password. Saved credentials are never returned to this form. Leave blank to retain them.",
"replaceServiceSecrets": "Replace saved credentials, including clearing them when the field is blank.",
"previewScenario": "Preview data",
"previewConnected": "Connected services",
"previewSynthetic": "Synthetic data: {name}",
"previewViewport": "Viewport",
"viewportCustom": "Custom size",
"viewportcompact": "Compact · 320 × 260",
"viewportwide": "Wide · 640 × 320",
"viewportphone": "Phone · 390 × 640",
"viewporttablet": "Tablet · 768 × 540",
"previewTheme": "Appearance",
"previewThemeCurrent": "Current theme",
"previewThemeLight": "Light",
"previewThemeDark": "Dark",
"previewScale": "Display scale",
"savedSourceChanged": "The saved source changed. Reload and review it before activating.",
"previewPane": "Preview"
}
},
"workshop": {
@@ -2030,7 +2408,8 @@
"settings": "Settings",
"settingsFor": "Settings for {name}",
"options": "Options",
"actions": "Actions"
"actions": "Actions",
"customize": "Customize as a widget package"
},
"status": {
"success": "OK",
@@ -4977,12 +5356,18 @@
"migrationRequired": "Migration required",
"migrationDescription": "This placed v1 widget cannot run yet. Copy its redacted prompt to an LLM, then paste the single JSON response into Homarr.",
"manageMigration": "Open Manage custom widgets",
"contactAdmin": "Contact an administrator."
"contactAdmin": "Contact an administrator.",
"trustedPackage": "Trusted package"
},
"configuration": {
"needsAttention": "Configuration needs attention: {message}",
"advancedOptions": "Advanced options",
"invalidJson": "Invalid JSON"
"invalidJson": "Invalid JSON",
"connectionDefault": "Use installation connection ({name})",
"connectionUnbound": "Choose a connection",
"connectionMissing": "This required connection is not bound.",
"connectionUnavailable": "Saved connection is unavailable",
"connectionsError": "Unable to load local connections."
}
},
"beszelSystemTable": {
@@ -7030,6 +7415,21 @@
},
"publish": {
"label": "Publish to Workshop"
},
"packages": {
"label": "Packages",
"new": {
"label": "New package"
},
"preview": {
"label": "Preview"
},
"convert": {
"label": "Convert"
},
"collections": {
"label": "Widget collections"
}
}
},
"users": {