application public active Verified 2026-04-10

TwinView

Standalone digital-twin application for property capture, twin publishing, inspection workflows, and client share surfaces.

Documentation Map

What It Is

Standalone digital-twin application for property capture, twin publishing, inspection workflows, and client share surfaces.

Architecture

Owners: platform-experience

Source repos: PlatformApplications/TwinView

Dependencies: topolo-auth, topolo-platform

Repo shape

  • PlatformApplications/TwinView/apps/
  • PlatformApplications/TwinView/package-lock.json
  • PlatformApplications/TwinView/package.json
  • PlatformApplications/TwinView/packages/
  • PlatformApplications/TwinView/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://twinview.app https://api.twinview.app
twinview-api

Config: PlatformApplications/TwinView/apps/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

twinview-web

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

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TwinView/apps/api/src/index.ts

Source exists in repo: yes

TwinView exposes a worker-backed application API for properties, property-detail aggregates, units, capture jobs, twins, annotations, inspection tasks, uploads, public share views, and Matterport connection metadata.

App API page: /reference/apps/twinview

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:

srv_twinview

API key scopes

dashboard.read

View TwinView dashboards and portfolio summaries

Resource pattern: none

properties.read

View properties and site records

Resource pattern: property:*

properties.write

Create and update properties and site records

Resource pattern: property:*

units.read

View units and subspaces

Resource pattern: property:*

units.write

Create and update units and subspaces

Resource pattern: property:*

capture_jobs.read

View capture jobs and field status

Resource pattern: none

capture_jobs.write

Create and manage capture jobs and schedules

Resource pattern: none

twins.read

View published and draft twins

Resource pattern: property:*

twins.write

Create and update twin records

Resource pattern: property:*

twins.publish

Publish or archive twin share views

Resource pattern: property:*

annotations.read

View annotations and pinned notes

Resource pattern: property:*

annotations.write

Create and manage annotations and pinned notes

Resource pattern: property:*

inspections.read

View inspection tasks and issue status

Resource pattern: property:*

inspections.write

Create and manage inspection tasks and issue status

Resource pattern: property:*

share_views.read

View public and client share configuration

Resource pattern: property:*

share_views.write

Manage public and client share configuration

Resource pattern: property:*

integrations.read

View Matterport and external integration metadata

Resource pattern: none

integrations.write

Manage Matterport and external integration metadata

Resource pattern: none

reports.read

View TwinView reporting and portfolio summaries

Resource pattern: none

settings.read

View TwinView workspace settings

Resource pattern: none

Service permissions

dashboard:read, properties:read, properties:write, units:read, units:write, capture_jobs:read, capture_jobs:write, twins:read, twins:write, twins:publish, annotations:read, annotations:write, inspections:read, inspections:write, share_views:read, share_views:write, integrations:read, integrations:write, reports:read, settings:read

Data Ownership

d1

Binding: DB

Target: 05bd77a2-5028-4d97-b8dd-e9ef22715a2c

Environment: default

Source: PlatformApplications/TwinView/apps/api/wrangler.toml

r2

Binding: ASSETS

Target: twinview-assets

Environment: default

Source: PlatformApplications/TwinView/apps/api/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

  • JOBS -> twinview-jobs

Cron triggers

No cron triggers were detected.

Workflow signals

  • JOBS -> twinview-jobs

Environment Variables and Bindings

Environment variables:

ALLOWED_ORIGINS APP_ORIGIN ASSET_PUBLIC_BASE_URL AUTH_BASE_URL

All wrangler bindings

  • DB (d1) -> 05bd77a2-5028-4d97-b8dd-e9ef22715a2c
  • ASSETS (r2) -> twinview-assets
  • JOBS (queue) -> twinview-jobs

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TwinView/apps/api/wrangler.toml -> twinview-api
  • PlatformApplications/TwinView/apps/web/wrangler.toml -> twinview-web

Build and deploy commands

  • build — PlatformApplications/TwinView/apps/api/package.json :: tsc -p tsconfig.json
  • deploy — PlatformApplications/TwinView/apps/api/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TwinView/apps/api/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
  • build — PlatformApplications/TwinView/apps/web/package.json :: tsc -p tsconfig.json && vite build
  • preview — PlatformApplications/TwinView/apps/web/package.json :: vite preview
  • build — PlatformApplications/TwinView/package.json :: npm run build -w @twinview/shared && npm run build -w @twinview/api && npm run build -w @twinview/web
  • build — PlatformApplications/TwinView/packages/shared/package.json :: tsc -p tsconfig.json
  • build — PlatformApplications/TwinView/packages/topolo-auth-client/package.json :: tsup src/index.ts --format esm,cjs --dts

Failure Modes

  • Neither OpenAPI nor README-derived interface detail was found.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TwinView/apps/api/wrangler.toml
  • PlatformApplications/TwinView/apps/web/wrangler.toml
  • PlatformApplications/TwinView/apps/api/src/index.ts
  • PlatformApplications/TwinView/apps/api/package.json
  • PlatformApplications/TwinView/apps/web/package.json
  • PlatformApplications/TwinView/package.json
  • PlatformApplications/TwinView/packages/shared/package.json
  • PlatformApplications/TwinView/packages/topolo-auth-client/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-10

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