Topolo Bytes

Documentation Map

• Application hub
• Application API surface
• Machine system JSON
• Machine application JSON
• applications/catalog
• API Key Scope Mismatches
• Auth Session and Role Drift
• Resource Binding Sync Failures
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues

What It Is

Media and asset management worker surface currently packaged as the R2 media manager.

A powerful, enterprise-ready media management system built on Cloudflare's edge infrastructure. Manage, organize, and share your media files with advanced features like AI-powered search, automatic organization, and secure guest sharing.

**Lightweight, beautiful interface for sharing collections with guests**

✨ **What's New:** - 📂 **Multi-layer folder navigation** - Guests can browse through nested directories - 🖼️ **Modern media preview** - Full-screen image/video viewing with modal interface - 📱 **Mobile responsive** - Works perfectly on all devices - 🔒 **Permission aware** - Respects view/download restrictions - 🎨 **Professional UI** - Clean, Cloudflare-inspired design

API Reference

Coverage: curated

Source: Applications/TopoloBytes

Source exists in repo: yes

Runtime exists but the contract is not yet formalized as OpenAPI here.

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:

API key scopes

Service permissions

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

Data Ownership

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

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

Build and deploy commands

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

Failure Modes

• No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

• Applications/TopoloBytes/apps/web/wrangler.toml
• Applications/TopoloBytes/apps/worker/wrangler.toml
• Applications/TopoloBytes
• Applications/TopoloBytes/README.md
• Applications/TopoloBytes/apps/desktop/package.json
• Applications/TopoloBytes/apps/web/package.json
• Applications/TopoloBytes/apps/worker/package.json
• Applications/TopoloBytes/package.json

Linked runbooks

• API Key Scope Mismatches
• Auth Session and Role Drift
• Resource Binding Sync Failures
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues

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.