n8n-nodes-orbitpage 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this package are documented here.
 
+## 0.3.5 - 2026-10-30
+
+### Fixed
+
+- Include the light and dark OrbitPage icons in the built npm package so the
+  action node, polling trigger, and API credential display their logos in n8n.
+  Package-load checks now reject missing icon files before a release.
+
+### Documentation
+
+- Clarify Verified Community Node approval, separate catalog publication from
+  approval, and document Cloud/self-hosted installation, package links and
+  missing-catalog troubleshooting. Runtime behavior is unchanged.
+
+## 0.3.4 - 2026-10-26
+
+### Fixed
+
+- Use the fully qualified `n8n-nodes-orbitpage.orbitPage` and `n8n-nodes-orbitpage.orbitPageTrigger` identifiers in codex metadata for n8n Creator Portal validation.
+
 ## 0.3.3 - 2026-10-26
 
 ### Added

package/README.md

@@ -4,8 +4,9 @@
 [![npm package version](https://img.shields.io/npm/v/n8n-nodes-orbitpage.svg)](https://www.npmjs.com/package/n8n-nodes-orbitpage)
 [![MIT license](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.md)
 
-`n8n-nodes-orbitpage` is the official OrbitPage community node package for
-[n8n](https://n8n.io). It connects n8n workflows to
+`n8n-nodes-orbitpage` is the OrbitPage-maintained community node package for
+[n8n](https://n8n.io), approved by n8n as a **Verified Community Node**.
+It connects n8n workflows to
 [OrbitPage](https://orbitpage.com/en-US), a one-page website and link-in-bio builder.
 It lets you automate a hosted OrbitPage workspace directly from n8n workflows.
 
@@ -41,7 +42,7 @@ the editor.
 | OrbitPage | A hosted OrbitPage account and workspace at `https://orbitpage.com` |
 | n8n | n8n 2.x; the package uses n8n Nodes API v1 and is load-checked with `n8n-workflow` 2.43.5 |
 | Node.js | Runtime `>=22.22`; CI tests Node.js 22.22 and 24; use Node.js 24 for the full development toolchain |
-| n8n Cloud | Availability depends on the n8n community-node review process |
+| n8n Cloud | Install from the nodes panel once OrbitPage appears in n8n's verified catalog; catalog publication follows approval |
 
 If you must use an older n8n 1.x installation or a materially newer runtime,
 validate the package and your workflow in a staging instance before production.
@@ -51,9 +52,32 @@ account permissions.
 
 ## Installation
 
+### Verified nodes panel: n8n Cloud and self-hosted
+
+The package remains a community node: verification does not make it a built-in,
+preinstalled n8n node. Approval and catalog publication are separate steps.
+
+Once OrbitPage appears in the catalog, an instance owner or admin can:
+
+1. Open a workflow's **Canvas** and select **+** to open the nodes panel.
+2. Search for **OrbitPage** under **More from the community**.
+3. Select the node and choose **Install**.
+4. Add **OrbitPage** or **OrbitPage Trigger** to a workflow. All instance members
+   can use the installed package.
+
+Verified community nodes must be enabled for the instance. If OrbitPage is not
+listed yet, Cloud users must wait for catalog publication; self-hosted users
+can use either installation method below. See
+[n8n's verified-node installation guide](https://docs.n8n.io/integrations/community-nodes/installation-and-management/install-verified-community-nodes/).
+
+Package download, versions and source:
+[npm](https://www.npmjs.com/package/n8n-nodes-orbitpage),
+[GitHub](https://github.com/paoloronco/n8n-nodes-orbitpage).
+Install through n8n rather than copying downloaded source into a workflow.
+
 ### Self-hosted n8n UI
 
-As an n8n instance owner, open **Settings > Community Nodes**, select
+As an n8n instance owner or admin, open **Settings > Community Nodes**, select
 **Install**, and enter:
 
 ```text

package/dist/icons/orbitpage.dark.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title desc">
+  <title id="title">OrbitPage</title>
+  <desc id="desc">A blue page crossed by a bright orbit.</desc>
+  <defs>
+    <linearGradient id="page" x1="18" y1="15" x2="50" y2="52" gradientUnits="userSpaceOnUse"><stop stop-color="#5D82F2"/><stop offset=".58" stop-color="#29457F"/><stop offset="1" stop-color="#3B73FF"/></linearGradient>
+    <linearGradient id="fold" x1="22" y1="16" x2="42" y2="46" gradientUnits="userSpaceOnUse"><stop stop-color="#D7E2FF" stop-opacity=".34"/><stop offset="1" stop-color="#3568F4" stop-opacity="0"/></linearGradient>
+    <linearGradient id="orbit" x1="12" y1="48" x2="57" y2="16" gradientUnits="userSpaceOnUse"><stop stop-color="#5285FF"/><stop offset=".55" stop-color="#79A0FF"/><stop offset="1" stop-color="#C4D4FF"/></linearGradient>
+    <clipPath id="page-clip"><rect x="18" y="15" width="32" height="37" rx="5"/></clipPath>
+  </defs>
+  <path d="M35 14c11-5 21-2 21 8 0 9-7 20-16 26" fill="none" stroke="url(#orbit)" stroke-linecap="round" stroke-width="6"/>
+  <rect x="18" y="15" width="32" height="37" rx="5" fill="url(#page)"/>
+  <path d="M18 15h32L18 52Z" fill="url(#fold)" clip-path="url(#page-clip)"/>
+  <path d="M56 22c1 12-9 24-20 30-12 7-23 4-24-4-1-5 1-10 4-14" fill="none" stroke="url(#orbit)" stroke-linecap="round" stroke-width="6.5"/>
+  <path d="M55 20c1 9-5 19-12 26" fill="none" stroke="#fff" stroke-linecap="round" stroke-width="1.3"/>
+  <path d="M34 14c8-5 16-4 20 1" fill="none" stroke="#8CADFF" stroke-linecap="round" stroke-width="3"/>
+</svg>

package/dist/icons/orbitpage.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title desc">
+  <title id="title">OrbitPage</title>
+  <desc id="desc">A deep-blue page crossed by a bright blue orbit.</desc>
+  <defs>
+    <linearGradient id="page" x1="18" y1="15" x2="50" y2="52" gradientUnits="userSpaceOnUse"><stop stop-color="#223B70"/><stop offset=".58" stop-color="#101828"/><stop offset="1" stop-color="#2456D8"/></linearGradient>
+    <linearGradient id="fold" x1="22" y1="16" x2="42" y2="46" gradientUnits="userSpaceOnUse"><stop stop-color="#7BA2FF" stop-opacity=".28"/><stop offset="1" stop-color="#2456D8" stop-opacity="0"/></linearGradient>
+    <linearGradient id="orbit" x1="12" y1="48" x2="57" y2="16" gradientUnits="userSpaceOnUse"><stop stop-color="#2456D8"/><stop offset=".55" stop-color="#3568F4"/><stop offset="1" stop-color="#7BA2FF"/></linearGradient>
+    <clipPath id="page-clip"><rect x="18" y="15" width="32" height="37" rx="5"/></clipPath>
+  </defs>
+  <path d="M35 14c11-5 21-2 21 8 0 9-7 20-16 26" fill="none" stroke="url(#orbit)" stroke-linecap="round" stroke-width="6"/>
+  <rect x="18" y="15" width="32" height="37" rx="5" fill="url(#page)"/>
+  <path d="M18 15h32L18 52Z" fill="url(#fold)" clip-path="url(#page-clip)"/>
+  <path d="M56 22c1 12-9 24-20 30-12 7-23 4-24-4-1-5 1-10 4-14" fill="none" stroke="url(#orbit)" stroke-linecap="round" stroke-width="6.5"/>
+  <path d="M55 20c1 9-5 19-12 26" fill="none" stroke="#fff" stroke-linecap="round" stroke-width="1.3"/>
+  <path d="M34 14c8-5 16-4 20 1" fill="none" stroke="#3568F4" stroke-linecap="round" stroke-width="3"/>
+</svg>

package/dist/nodes/OrbitPage/OrbitPage.node.json

@@ -1,5 +1,5 @@
 {
-  "node": "n8n-nodes-orbitpage",
+  "node": "n8n-nodes-orbitpage.orbitPage",
   "nodeVersion": "1.0",
   "codexVersion": "1.0",
   "categories": ["Marketing & Content", "Development", "Sales"],

package/dist/nodes/OrbitPageTrigger/OrbitPageTrigger.node.json

@@ -1,5 +1,5 @@
 {
-  "node": "n8n-nodes-orbitpage",
+  "node": "n8n-nodes-orbitpage.orbitPageTrigger",
   "nodeVersion": "1.0",
   "codexVersion": "1.0",
   "categories": ["Marketing & Content", "Development", "Sales"],

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "n8n-nodes-orbitpage",
-    "version": "0.3.3",
+    "version": "0.3.5",
     "description": "Official OrbitPage community nodes for n8n website content, publishing, media, analytics, AI, Shop, domains, backups, and workflow triggers",
     "license": "MIT",
     "homepage": "https://orbitpage.com/en-US/docs/api-tokens#integration",

package/docs/guides/development-and-release.md

@@ -177,9 +177,12 @@ Releases are maintainer-only:
 9. Confirm the npm description, keywords, README, repository link, homepage,
    provenance, and automatically created GitHub release all show the new
    version.
-10. Once the published version passes the scan, submit or update the node in the
-    [n8n Creator Portal](https://creators.n8n.io/nodes) for verified in-editor
-    discovery.
+10. For an initial verification, submit the scanned package through the
+    [n8n Creator Portal](https://creators.n8n.io/nodes). For an already verified
+    node, n8n monitors npm versions and propagates updates after a quick
+    re-review, as described in the approval email. Check the portal for any
+    requested follow-up and confirm catalog availability separately from npm
+    publication. Do not describe the package as preinstalled or built into n8n.
 
 The workflow currently authenticates with the repository's `NPM_TOKEN` secret
 and signs provenance through GitHub OIDC. Replace the token with npm Trusted

package/docs/guides/getting-started.md

@@ -6,23 +6,44 @@ and executes a non-destructive workspace read.
 ## Prerequisites
 
 - A hosted OrbitPage account with access to a workspace.
-- An n8n 2.x installation that permits community nodes.
+- An n8n 2.x instance that permits community nodes, with owner or admin access
+  to install the package. On Cloud, OrbitPage must appear in the verified catalog.
 - Node.js 22.22 or newer for a self-hosted runtime. CI validates Node.js 22.22
   and 24.
 - Permission to create personal API tokens in OrbitPage.
 
-## Install through the self-hosted n8n UI
+## Choose an installation method
 
-1. Sign in to self-hosted n8n as the instance owner.
+OrbitPage is approved by n8n as a **Verified Community Node**, maintained by
+OrbitPage. It is not preinstalled or a built-in n8n node. Catalog publication
+follows approval; if the node is not listed yet, use the self-hosted path below
+or wait for publication on Cloud.
+
+Download and version links: [npm package](https://www.npmjs.com/package/n8n-nodes-orbitpage)
+and [public source](https://github.com/paoloronco/n8n-nodes-orbitpage).
+
+### Verified catalog: n8n Cloud and self-hosted
+
+1. Sign in as an instance owner or admin and open a workflow's **Canvas**.
+2. Select **+** to open the nodes panel and search for **OrbitPage**.
+3. Select the result in **More from the community**, then **Install**.
+4. Confirm that **OrbitPage** and **OrbitPage Trigger** can be added.
+
+Once installed, all instance members can use the nodes. If no result or install
+option appears, see [catalog troubleshooting](troubleshooting.md#orbitpage-is-missing-from-the-nodes-panel).
+Cloud does not support installing arbitrary npm packages. See
+[n8n's verified-node installation guide](https://docs.n8n.io/integrations/community-nodes/installation-and-management/install-verified-community-nodes/).
+
+### Self-hosted n8n UI
+
+1. Sign in to self-hosted n8n as the instance owner or admin.
 2. Open **Settings > Community Nodes**.
 3. Select **Install**.
 4. Enter `n8n-nodes-orbitpage`.
 5. Confirm the installation.
 6. Restart n8n if the node is not immediately available.
 
-Availability on n8n Cloud depends on the n8n community-node review process.
-
-## Install on a self-hosted command line
+### Self-hosted command line
 
 From the community-nodes directory used by your n8n installation, run:
 
@@ -114,7 +135,7 @@ handle explicitly.
 
 ## Import an example
 
-The repository includes two starting workflows:
+Start with either of these read-only workflows:
 
 - [`read-workspace.json`](../../examples/read-workspace.json) performs the safe
   read described above;
@@ -123,7 +144,9 @@ The repository includes two starting workflows:
 
 After import, open each OrbitPage node and replace the placeholder credential
 reference with your saved credential. See the
-[examples guide](../../examples/README.md) for scopes and trigger behavior.
+[examples guide](../../examples/README.md) for scopes, trigger behavior, and the
+more advanced Release Guardian and AI Page Copilot workflows. Install the
+package before importing an example; importing JSON does not install its nodes.
 
 ## Upgrade from 0.1.x to 0.2.0
 

package/docs/guides/troubleshooting.md

@@ -3,6 +3,24 @@
 Start with the smallest non-destructive request that exercises the same
 credential boundary: **Workspace & Draft > Get Workspace Overview**.
 
+## OrbitPage is missing from the nodes panel
+
+- Approval as a Verified Community Node and publication in n8n's catalog are
+  separate steps. On Cloud, wait for the catalog entry if it is not listed yet.
+- Search for **OrbitPage** under **More from the community** from a workflow's
+  **+** nodes panel, not only among installed nodes.
+- Only instance owners and admins can install; other members can use the package
+  once installed.
+- On Cloud, check **Verified community nodes** in the Cloud console's
+  **Instance settings**. Self-hosted administrators should check their
+  community-node environment settings and package compatibility.
+- A self-hosted instance can install `n8n-nodes-orbitpage` through
+  **Settings > Community Nodes** or npm. These npm installation paths are not
+  available on n8n Cloud.
+
+Follow [Getting started](getting-started.md#choose-an-installation-method) and
+[n8n's installation guide](https://docs.n8n.io/integrations/community-nodes/installation-and-management/install-verified-community-nodes/).
+
 ## Class could not be found
 
 An interrupted or partial community-node installation can leave stale package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-orbitpage",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Official OrbitPage community nodes for n8n website content, publishing, media, analytics, AI, Shop, domains, backups, and workflow triggers",
   "license": "MIT",
   "homepage": "https://orbitpage.com/en-US/docs/api-tokens#integration",