application public active Verified 2026-04-23

Topolo Device Platform

Topolo platform-owned TopoloFeed delivery, analytics, Android playback, and device-side app-catalog consumption surfaces.

Documentation Map

What It Is

Topolo platform-owned TopoloFeed delivery, analytics, Android playback, and device-side app-catalog consumption surfaces.

Canonical documentation for TopoloMDM 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: PlatformApplications/TopoloFeed, PlatformApplications/TopoloMDM, PlatformApplications/TopoloDevelopers

Dependencies: topolo-auth, topolo-mdm, topolo-developers

Repo shape

  • PlatformApplications/TopoloFeed/AnalyticsAPI/
  • PlatformApplications/TopoloFeed/Android/
  • PlatformApplications/TopoloFeed/api/
  • PlatformApplications/TopoloFeed/topolo.cloudcontrol.json
  • PlatformApplications/TopoloFeed/ui/
  • PlatformApplications/TopoloMDM/README.md
  • PlatformApplications/TopoloMDM/topolo-mdm-api/
  • PlatformApplications/TopoloMDM/topolo-mdm-console/
  • PlatformApplications/TopoloMDM/topolo-mdm-mobile/
  • PlatformApplications/TopoloMDM/topolo-provision/
  • PlatformApplications/TopoloMDM/topolo.cloudcontrol.json
  • PlatformApplications/TopoloDevelopers/functions/
  • PlatformApplications/TopoloDevelopers/index.html
  • PlatformApplications/TopoloDevelopers/migrations/
  • PlatformApplications/TopoloDevelopers/package-lock.json
  • PlatformApplications/TopoloDevelopers/package.json
  • PlatformApplications/TopoloDevelopers/postcss.config.cjs
  • PlatformApplications/TopoloDevelopers/public/
  • PlatformApplications/TopoloDevelopers/scripts/
  • PlatformApplications/TopoloDevelopers/src/

Runtime Surfaces

Hosts:

https://topolo-feed-api.topolo.app https://topolo-feed-assets.topolo.app https://topolo-feed-analytics-api.topolo.app
topolo-feed-analytics-api

Config: PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

topolo-feed-api

Config: PlatformApplications/TopoloFeed/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

topolo-mdm-api

Config: PlatformApplications/TopoloMDM/topolo-mdm-api/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

topolo-mdm-console

Config: PlatformApplications/TopoloMDM/topolo-mdm-console/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

topolo-provision

Config: PlatformApplications/TopoloMDM/topolo-provision/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

topolo-developers

Config: PlatformApplications/TopoloDevelopers/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/device-platform.mdx

Source exists in repo: yes

Canonical device-platform coverage lives in the docs application; TopoloFeed contains the feed delivery API, feed asset host, feed operator UI, Android playback runtime, and feed analytics worker. Feed delivery is the callable platform service id `feed` at https://topolo-feed-api.topolo.app, feed media assets are served from the `topolo-feed-assets` R2 bucket at https://topolo-feed-assets.topolo.app, and feed analytics remains a deploy target for device telemetry at https://topolo-feed-analytics-api.topolo.app. TopoloMDM owns device management and Android provisioning. Mobile app catalog metadata belongs to Topolo Developers and is consumed through Developers-owned /api/apps routes. The retained Nodo-origin mobile surfaces are represented there as first-party Topolo Feed, Topolo Provision, and Topolo MDM Mobile records.

App API page: /reference/apps/topolo-device-platform

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:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

d1

Binding: DB

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

Environment: default

Source: PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml

d1

Binding: DB

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

Environment: development

Source: PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml

d1

Binding: DB

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

Environment: production

Source: PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml

kv

Binding: TOPOLO_FEED_CONFIG

Target: 6a325c245ac0433696b3a127a8da3ee8

Environment: default

Source: PlatformApplications/TopoloFeed/api/wrangler.toml

kv

Binding: TOPOLO_STATE

Target: 37a037b342994ab5b722b12746d7cbd7

Environment: default

Source: PlatformApplications/TopoloFeed/api/wrangler.toml

d1

Binding: DEVELOPERS_DB

Target: ab11dc42-6af0-4026-83ec-def345ca7bd3

Environment: default

Source: PlatformApplications/TopoloDevelopers/wrangler.toml

r2

Binding: MOBILE_ARTIFACTS

Target: topolo-apks

Environment: default

Source: PlatformApplications/TopoloDevelopers/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:

APP_CATALOG_URL AUTH_API_URL AUTH_BASE_URL BROWSER_SERVICE_ID DEFAULT_TENANT ENVIRONMENT FEED_API_URL RATE_LIMIT_ENABLED RATE_LIMIT_PERIOD RATE_LIMIT_REQUESTS SERVICE_ID STATE_API_URL

All wrangler bindings

  • DB (d1) -> 7e2729cc-1dbe-4f4f-bdbf-105d8c10cd66
  • DB (d1) -> 7e2729cc-1dbe-4f4f-bdbf-105d8c10cd66 [development]
  • DB (d1) -> 7e2729cc-1dbe-4f4f-bdbf-105d8c10cd66 [production]
  • TOPOLO_FEED_CONFIG (kv) -> 6a325c245ac0433696b3a127a8da3ee8
  • TOPOLO_STATE (kv) -> 37a037b342994ab5b722b12746d7cbd7
  • DEVELOPERS_DB (d1) -> ab11dc42-6af0-4026-83ec-def345ca7bd3
  • MOBILE_ARTIFACTS (r2) -> topolo-apks

Deployments

Deployment environments: development, production

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

Wrangler surfaces

  • PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml -> topolo-feed-analytics-api
  • PlatformApplications/TopoloFeed/api/wrangler.toml -> topolo-feed-api
  • PlatformApplications/TopoloMDM/topolo-mdm-api/wrangler.toml -> topolo-mdm-api
  • PlatformApplications/TopoloMDM/topolo-mdm-console/wrangler.toml -> topolo-mdm-console
  • PlatformApplications/TopoloMDM/topolo-provision/wrangler.toml -> topolo-provision
  • PlatformApplications/TopoloDevelopers/wrangler.toml -> topolo-developers

Build and deploy commands

  • deploy — PlatformApplications/TopoloFeed/AnalyticsAPI/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloFeed/AnalyticsAPI/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloFeed/AnalyticsAPI/package.json :: tsc --noEmit
  • deploy — PlatformApplications/TopoloFeed/api/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloFeed/api/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloFeed/api/package.json :: tsc --noEmit
  • build — PlatformApplications/TopoloFeed/ui/package.json :: mkdir -p dist && cp -r *.html *.css js dist/
  • deploy — PlatformApplications/TopoloMDM/topolo-mdm-api/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloMDM/topolo-mdm-api/package.json :: npx --yes wrangler@4 deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloMDM/topolo-mdm-api/package.json :: node --check index.js
  • build — PlatformApplications/TopoloMDM/topolo-mdm-console/package.json :: astro build
  • deploy — PlatformApplications/TopoloMDM/topolo-mdm-console/package.json :: npm run build && npx wrangler pages deploy dist --project-name topolo-mdm-console
  • preview — PlatformApplications/TopoloMDM/topolo-mdm-console/package.json :: astro preview

Failure Modes

  • No Auth service ID is registered for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloFeed/AnalyticsAPI/wrangler.toml
  • PlatformApplications/TopoloFeed/api/wrangler.toml
  • PlatformApplications/TopoloMDM/topolo-mdm-api/wrangler.toml
  • PlatformApplications/TopoloMDM/topolo-mdm-console/wrangler.toml
  • PlatformApplications/TopoloMDM/topolo-provision/wrangler.toml
  • PlatformApplications/TopoloDevelopers/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/device-platform.mdx
  • PlatformApplications/TopoloMDM/README.md
  • PlatformApplications/TopoloFeed/AnalyticsAPI/package.json
  • PlatformApplications/TopoloFeed/api/package.json
  • PlatformApplications/TopoloFeed/ui/package.json
  • PlatformApplications/TopoloMDM/topolo-mdm-api/package.json
  • PlatformApplications/TopoloMDM/topolo-mdm-console/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-23

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