application public active Verified 2026-03-29

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.

TopoloNodo is not a single coherent app in this repository yet. It is a cluster of related Nodo-era surfaces that currently live side by side:

This file is the current-state inventory for the repo surface that exists today. It is intentionally factual and does not try to collapse these projects into a single product story before the code does.

This slice adds an explicit lifecycle cut for each top-level Nodo surface based on current repo evidence only.

Architecture

Owners: device-platform

Source repos: Applications/TopoloNodo

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloNodo/NodoAppLibraryAPI/
  • Applications/TopoloNodo/NodoFeedApi/
  • Applications/TopoloNodo/NodoOS/
  • Applications/TopoloNodo/README.md

Runtime Surfaces

Hosts:

No primary host is registered.

nodo-app-library-api

Config: Applications/TopoloNodo/NodoAppLibraryAPI/wrangler.toml

Main: index.ts

Routes: workers.dev or asset-only surface

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

Config: Applications/TopoloNodo/NodoFeedApi/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

nodo-feed-analytics-api

Config: Applications/TopoloNodo/NodoOS/FeedAnalyticsApi/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

nodo-provision

Config: Applications/TopoloNodo/NodoOS/NodoProvision/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: readme

Source: Applications/TopoloNodo/README.md

Source exists in repo: yes

README provides the current-state inventory and lifecycle classification of the Nodo surfaces.

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: Applications/TopoloNodo/NodoFeedApi/api/wrangler.toml

kv

Binding: NODO_STATE

Target: 37a037b342994ab5b722b12746d7cbd7

Environment: default

Source: Applications/TopoloNodo/NodoFeedApi/api/wrangler.toml

d1

Binding: DB

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

Environment: default

Source: Applications/TopoloNodo/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

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

Build and deploy commands

  • deploy — Applications/TopoloNodo/NodoAppLibraryAPI/package.json :: wrangler deploy
  • deploy — Applications/TopoloNodo/NodoFeedApi/api/package.json :: wrangler deploy
  • build — Applications/TopoloNodo/NodoFeedApi/ui/package.json :: mkdir -p dist && cp -r *.html *.css js dist/
  • deploy — Applications/TopoloNodo/NodoOS/FeedAnalyticsApi/package.json :: wrangler deploy

Failure Modes

  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • Applications/TopoloNodo/NodoAppLibraryAPI/wrangler.toml
  • Applications/TopoloNodo/NodoFeedApi/api/wrangler.toml
  • Applications/TopoloNodo/NodoOS/FeedAnalyticsApi/wrangler.toml
  • Applications/TopoloNodo/NodoOS/NodoProvision/wrangler.toml
  • Applications/TopoloNodo/README.md
  • Applications/TopoloNodo/NodoAppLibraryAPI/package.json
  • Applications/TopoloNodo/NodoFeedApi/api/package.json
  • Applications/TopoloNodo/NodoFeedApi/ui/package.json
  • Applications/TopoloNodo/NodoOS/FeedAnalyticsApi/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-03-29

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