Prox OS Internal Docs
ProductAppsApp Connectors

App Connectors

/app-connectors is the external platform connector layer. It replaces the older /app-user-connectors canonical route group. The shell keeps old /app-user-connec

/app-connectors is the external platform connector layer. It replaces the older /app-user-connectors canonical route group. The shell keeps old /app-user-connectors/* links as compatibility aliases, but new manifests and docs should use /app-connectors/*.

Connectors do not define canonical personal entities. They explain where imported data comes from, what permission scope would be needed, when data last synced, how records would be disconnected, and what target apps can use the staged source.

Current Connector Routes

AppRoutePurpose
Connector Wall/app-connectors/wallProvider status wall and future connector boundary map.
Game Connectors/app-connectors/gameSteam, GOG, Epic, consoles, launchers, achievements, cloud saves, wishlist, and library metadata.
Books Connectors/app-connectors/booksGoodreads, Kindle, Apple Books, Readwise, Notion reading list, and manual imports.
Music Connectors/app-connectors/musicSpotify, Apple Music, YouTube Music, Last.fm, Bandcamp, and listening source previews.
Movies Connectors/app-connectors/moviesLetterboxd, IMDB, Trakt, JustWatch, and streaming watch-history placeholders.
Files/app-connectors/filesDrive and file provider metadata for Documents Vault and Alma.
Airtable Connectors/app-connectors/airtableAirtable bases and tables for Food, Work, Collections, and research imports.
Calendar/app-connectors/calendarCalendar provider metadata for time, people, places, work, and Alma context.
Contacts/app-connectors/contactsContact provider imports; /app-track/people remains the canonical people track layer.
Wallet/app-connectors/walletMock financial connector surface for balances, bills, credits, and usage summaries.
Sports Connectors/app-connectors/sportsFIFA, UEFA, LaLiga, NBA, Formula 1, Olympics, schedule, team, highlight, and sports calendar source readiness.
Events Connectors/app-connectors/eventsCalendar, Meetup, Eventbrite, Madrid city events, cinema listings, museums, and concert source readiness.
Tickets Connectors/app-connectors/ticketsEmail attachments, PDF upload, wallet, ticketing, transport, and cinema membership import previews.
Deployment Connectors/app-connectors/deploymentsVercel, Cloudflare Pages, Netlify, GitHub Pages, Railway, Render, Fly.io, domains, previews, and build metadata.
Social Connectors/app-connectors/socialX, Mastodon, Bluesky, Reddit, Hacker News, YouTube, LinkedIn, GitHub Discussions, Discord, and public-link signals.

Older connector apps such as Email, Weather, Messages, Notes, Tasks, Bookmarks, Photos, Projects, Secrets, Places, Health, Project CRM, Knowledge Graph, and Browser Activity also move under /app-connectors/*.

Mock Boundary

All connector screens are UI-only:

  • no OAuth
  • no API tokens
  • no provider sync
  • no webhooks
  • no filesystem access
  • no external sends
  • no raw private data reads

Future connector work must start with minimum permission scopes, visible source provenance, disconnect controls, cache deletion, export, and audit trails.

On this page