application public active Verified 2026-04-07

Topolo Nodo

Cluster of Nodo-era distribution, feed, analytics, and Android surfaces retained in the platform repo.

Documentation Map

What It Is

Cluster of Nodo-era distribution, feed, analytics, and Android surfaces retained in the platform repo.

Canonical documentation for Topolo Nodo lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

Architecture

Owners: device-platform

Source repos: NodoPlatform

Dependencies: topolo-auth

Repo shape

  • NodoPlatform/NodoAppLibraryAPI/
  • NodoPlatform/NodoFeedApi/
  • NodoPlatform/NodoOS/
  • NodoPlatform/README.md

Runtime Surfaces

Hosts:

No primary host is registered.

nodo-app-library-api

Config: NodoPlatform/NodoAppLibraryAPI/wrangler.toml

Main: index.ts

Routes: workers.dev or asset-only surface

"nodo-feed-api" # Replace with your worker's name

Config: NodoPlatform/NodoFeedApi/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

nodo-feed-analytics-api

Config: NodoPlatform/NodoOS/FeedAnalyticsApi/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

nodo-provision

Config: NodoPlatform/NodoOS/NodoProvision/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/nodo.mdx

Source exists in repo: yes

Canonical Nodo family coverage now lives in the docs application.

App API page: /reference/apps/topolo-nodo

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

svc_nodo_state_api

API key scopes

state.read

Read device state and status data

Resource pattern: none

state.write

Update device state information

Resource pattern: none

commands.read

View device command history

Resource pattern: none

commands.write

Send commands to devices

Resource pattern: none

events.read

View device events and logs

Resource pattern: none

analytics.read

Access device analytics and metrics

Resource pattern: none

Service permissions

state:read, state:write, commands:read, commands:write, events:read, analytics:read

Data Ownership

kv

Binding: NODO_FEED_CONFIG

Target: 6a325c245ac0433696b3a127a8da3ee8

Environment: default

Source: NodoPlatform/NodoFeedApi/api/wrangler.toml

kv

Binding: NODO_STATE

Target: 37a037b342994ab5b722b12746d7cbd7

Environment: default

Source: NodoPlatform/NodoFeedApi/api/wrangler.toml

d1

Binding: DB

Target: 7e2729cc-1dbe-4f4f-bdbf-105d8c10cd66

Environment: default

Source: NodoPlatform/NodoOS/FeedAnalyticsApi/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

ENVIRONMENT RATE_LIMIT_ENABLED RATE_LIMIT_PERIOD RATE_LIMIT_REQUESTS

All wrangler bindings

  • NODO_FEED_CONFIG (kv) -> 6a325c245ac0433696b3a127a8da3ee8
  • NODO_STATE (kv) -> 37a037b342994ab5b722b12746d7cbd7
  • DB (d1) -> 7e2729cc-1dbe-4f4f-bdbf-105d8c10cd66

Deployments

Deployment environments: development, production

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • NodoPlatform/NodoAppLibraryAPI/wrangler.toml -> nodo-app-library-api
  • NodoPlatform/NodoFeedApi/api/wrangler.toml -> "nodo-feed-api" # Replace with your worker's name
  • NodoPlatform/NodoOS/FeedAnalyticsApi/wrangler.toml -> nodo-feed-analytics-api
  • NodoPlatform/NodoOS/NodoProvision/wrangler.toml -> nodo-provision

Build and deploy commands

  • deploy — NodoPlatform/NodoAppLibraryAPI/package.json :: wrangler deploy
  • deploy:dry-run — NodoPlatform/NodoAppLibraryAPI/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — NodoPlatform/NodoAppLibraryAPI/package.json :: tsc --noEmit
  • deploy — NodoPlatform/NodoFeedApi/api/package.json :: wrangler deploy
  • deploy:dry-run — NodoPlatform/NodoFeedApi/api/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — NodoPlatform/NodoFeedApi/api/package.json :: tsc --noEmit
  • build — NodoPlatform/NodoFeedApi/ui/package.json :: mkdir -p dist && cp -r *.html *.css js dist/
  • deploy — NodoPlatform/NodoOS/FeedAnalyticsApi/package.json :: wrangler deploy
  • deploy:dry-run — NodoPlatform/NodoOS/FeedAnalyticsApi/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — NodoPlatform/NodoOS/FeedAnalyticsApi/package.json :: tsc --noEmit

Failure Modes

  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • NodoPlatform/NodoAppLibraryAPI/wrangler.toml
  • NodoPlatform/NodoFeedApi/api/wrangler.toml
  • NodoPlatform/NodoOS/FeedAnalyticsApi/wrangler.toml
  • NodoPlatform/NodoOS/NodoProvision/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/nodo.mdx
  • NodoPlatform/README.md
  • NodoPlatform/NodoAppLibraryAPI/package.json
  • NodoPlatform/NodoFeedApi/api/package.json
  • NodoPlatform/NodoFeedApi/ui/package.json
  • NodoPlatform/NodoOS/FeedAnalyticsApi/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.