application public active Verified 2026-04-07

Bytes

Media and asset management surface for uploads, organization, review, and sharing.

Documentation Map

What It Is

Media and asset management surface for uploads, organization, review, and sharing.

Canonical documentation for Topolo Bytes 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: media-platform

Source repos: PlatformApplications/TopoloBytes

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloBytes/README.md
  • PlatformApplications/TopoloBytes/apps/
  • PlatformApplications/TopoloBytes/docker/
  • PlatformApplications/TopoloBytes/package.json
  • PlatformApplications/TopoloBytes/pnpm-lock.yaml
  • PlatformApplications/TopoloBytes/pnpm-workspace.yaml
  • PlatformApplications/TopoloBytes/scripts/
  • PlatformApplications/TopoloBytes/src/
  • PlatformApplications/TopoloBytes/start-dev-simple.sh
  • PlatformApplications/TopoloBytes/start-dev.sh
  • PlatformApplications/TopoloBytes/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://bytes.topolo.app https://bytes.pages.dev
bytes

Config: PlatformApplications/TopoloBytes/apps/web/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

r2-media-manager-worker

Config: PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

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

Source exists in repo: yes

Canonical Bytes coverage now lives in the docs application.

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

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_r2_media_manager

API key scopes

files.read

View and download files

Resource pattern: none

files.write

Upload and edit files

Resource pattern: none

folders.read

View folder structure

Resource pattern: none

folders.write

Create and organize folders

Resource pattern: none

shares.read

View shared files and permissions

Resource pattern: none

shares.write

Share files and manage permissions

Resource pattern: none

media.read

View media assets

Resource pattern: none

media.write

Manage media assets

Resource pattern: none

settings.read

View Bytes settings

Resource pattern: none

settings.write

Manage Bytes settings

Resource pattern: none

Service permissions

files:read, files:write, files:delete, folders:read, folders:write, sharing:read, sharing:write, storage:read

Data Ownership

kv

Binding: SHARE_LINKS

Target: 728a7a682f024c468f6f55fd3dce64d6

Environment: default

Source: PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

vectorize

Binding: VEC

Target: media-embeddings

Environment: default

Source: PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

  • */5 * * * * via PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

Workflow signals

  • cron */5 * * * *

Environment Variables and Bindings

Environment variables:

SERVICE_ID

All wrangler bindings

  • SHARE_LINKS (kv) -> 728a7a682f024c468f6f55fd3dce64d6
  • VEC (vectorize) -> media-embeddings

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloBytes/apps/web/wrangler.toml -> bytes
  • PlatformApplications/TopoloBytes/apps/worker/wrangler.toml -> r2-media-manager-worker

Build and deploy commands

  • build — PlatformApplications/TopoloBytes/apps/desktop/package.json :: tsc -b && vite build
  • build — PlatformApplications/TopoloBytes/apps/web/package.json :: VITE_API_BASE=https://r2-media-manager-worker.topolo.workers.dev tsc -b && vite build
  • preview — PlatformApplications/TopoloBytes/apps/web/package.json :: vite preview
  • deploy — PlatformApplications/TopoloBytes/apps/worker/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloBytes/apps/worker/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloBytes/apps/worker/package.json :: tsc --noEmit
  • build — PlatformApplications/TopoloBytes/package.json :: cd apps/web && pnpm run build
  • build:desktop — PlatformApplications/TopoloBytes/package.json :: pnpm --filter desktop build
  • build:all — PlatformApplications/TopoloBytes/package.json :: pnpm run --filter worker build && pnpm run --filter web build
  • deploy:worker — PlatformApplications/TopoloBytes/package.json :: wrangler deploy --config apps/worker/wrangler.toml
  • deploy:web — PlatformApplications/TopoloBytes/package.json :: cd apps/web && pnpm build && cp -r functions dist/ && npx wrangler pages deploy dist --project-name=bytes --branch=main
  • deploy — PlatformApplications/TopoloBytes/package.json :: pnpm deploy:worker && pnpm deploy:web

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloBytes/apps/web/wrangler.toml
  • PlatformApplications/TopoloBytes/apps/worker/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx
  • PlatformApplications/TopoloBytes/README.md
  • PlatformApplications/TopoloBytes/apps/desktop/package.json
  • PlatformApplications/TopoloBytes/apps/web/package.json
  • PlatformApplications/TopoloBytes/apps/worker/package.json
  • PlatformApplications/TopoloBytes/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.