How deepnotesapp/deepnotes works
DeepNotes is an end-to-end encrypted infinite-canvas notes product with nested pages and realtime collaboration. Users work in the client; its realtime client handles subscriptions and notifications, while the app server exposes session, user, group and page APIs plus webhook and websocket endpoints. The collaboration server handles shared page updates and snapshots; separate realtime and scheduler services support live data and cleanup. The README documents the product capabilities, but sampled code does not establish every client-to-service connection, so those links are omitted.
Main entry points: router.ts tRPC router · server.ts Fastify server · sockets.ts Collaboration sockets · login.ts Session API
Components 29
Client experience
- Application UI
apps/client/src/App.vue - Client routing
apps/client/src/code/routing.ts - Realtime client
apps/client/src/code/areas/realtime/client.ts - Realtime contexts
apps/client/src/code/areas/realtime/context.ts - Notifications
apps/client/src/code/pages/notifications/notifications.ts - Client utilities
apps/client/src/code/utils/misc.ts - Async resolvable
packages/@stdlib/misc/src/resolvable.ts
Application API
- Fastify server
apps/app-server/src/fastify/server.ts - tRPC router
apps/app-server/src/trpc/router.ts - Session API
apps/app-server/src/trpc/api/sessions/login.ts - Session refresh
apps/app-server/src/trpc/api/sessions/refresh.ts - Demo sessions
apps/app-server/src/trpc/api/sessions/start-demo.ts - Session cookies
apps/app-server/src/utils/cookies.ts - JWT handling
apps/app-server/src/utils/jwt.ts - Group API
apps/app-server/src/trpc/api/groups/index.ts - Page API
apps/app-server/src/trpc/api/pages/index.ts - Page creation
apps/app-server/src/trpc/api/pages/create.ts - Page updates
apps/app-server/src/trpc/api/pages/bump.ts - User API
apps/app-server/src/trpc/api/users/index.ts - Stripe webhook
apps/app-server/src/fastify/stripe-webhook.ts - RevenueCat webhook
apps/app-server/src/fastify/revenuecat-webhook.ts - App Store webhook
apps/app-server/src/fastify/app-store-webhook.ts
Collaboration
- Collaboration sockets
apps/collab-server/src/sockets.ts - Page rooms
apps/collab-server/src - Update buffering
apps/collab-server/src/data/redis/bufferize-page-update.ts - Collab Redis
apps/collab-server/src/data/redis.ts
Background services
- Realtime service
apps/realtime-server/src/sockets.ts - Retention cleanup
apps/scheduler/src/index.ts
Other components
- User
Connections 18
- User → Application UI: uses
- Application UI → Client utilities: uses
apps/client/src/App.vue - Client routing → Client utilities: uses
apps/client/src/code/routing.ts - Realtime client → Realtime contexts: uses
apps/client/src/code/areas/realtime/client.ts - Realtime client → Notifications: loads
apps/client/src/code/areas/realtime/client.ts - Fastify server → tRPC router: registers
apps/app-server/src/fastify/server.ts - Fastify server → Stripe webhook: registers
apps/app-server/src/fastify/server.ts - Fastify server → RevenueCat webhook: registers
apps/app-server/src/fastify/server.ts - tRPC router → Group API: routes
apps/app-server/src/trpc/router.ts - tRPC router → Page API: routes
apps/app-server/src/trpc/router.ts - tRPC router → Session API: routes
apps/app-server/src/trpc/router.ts - tRPC router → User API: routes
apps/app-server/src/trpc/router.ts - Session API → Session refresh: includes
apps/app-server/src/trpc/api/sessions/index.ts - Session API → Demo sessions: includes
apps/app-server/src/trpc/api/sessions/index.ts - Collaboration sockets → Update buffering: buffers updates
apps/collab-server/src/sockets.ts - Collaboration sockets → Collab Redis: uses
apps/collab-server/src/sockets.ts - Collaboration sockets → Page rooms: uses
apps/collab-server/src/sockets.ts - Retention cleanup → Retention cleanup: deletes expired data
apps/scheduler/src/index.ts