How enzofrnt/myownnotion works
MyOwnNotion is a self-hosted personal knowledge workspace for hierarchical pages, block editing, linked knowledge graphs, tasks, and databases, used from web and desktop clients. The main flow is an owner editing and organizing workspace content; client services provide local content and synchronization, while the API handles page operations and persistence. Distinct product branches include databases, search, protected files and security, backup/restore, Notion import, and MCP access. The README establishes the product capabilities; sampled source and the source index support only the specific internal links shown below.
Main entry points: local-content.ts Local content · page-operation-service.ts Page operations · app.ts API application · client.ts PostgreSQL store
Components 21
Workspace clients
- Web workspace
apps/web/src/app.tsx - Desktop client
apps/desktop/src/main.ts
Content and sync
- Local content
apps/web/src/services/local-content.ts - Block editor
apps/web/src/features/editor/editor-engine.ts - Page operations
apps/api/src/page-state/page-operation-service.ts - Page history
apps/api/src/page-state/page-history-service.ts - Realtime sync
apps/api/src/realtime/page-sync-hub.ts - Block tree model
packages/page-state/src/block-tree.ts - Content contracts
packages/contracts/src/content-api.ts
API capabilities
- Database queries
apps/api/src/databases/database-query-service.ts - Workspace search
apps/api/src/search/search-service.ts - Knowledge graph
packages/graph/src/project.ts - Notion import
apps/api/src/imports/notion/apply.ts - MCP access
apps/api/src/mcp/access-service.ts - API application
apps/api/src/app.ts
Security and continuity
- Protected files
apps/api/src/files/protected-file-service.ts - Protected content
apps/api/src/security/protected-content.ts - Canonical payloads
apps/api/src/security/canonical-payloads.ts - Backup and restore
apps/api/src/backup/full/service.ts
Canonical persistence
- PostgreSQL store
packages/database/src/client.ts
Other components
- Workspace owner
Connections 26
- Workspace owner → Web workspace: uses
- Workspace owner → Desktop client: uses
- Web workspace → Local content: uses
- Local content → Block editor: serves
apps/web/src/features/editor/editor-engine.ts - Local content → Page operations: uses API
apps/web/src/services/local-content.ts - Local content → Content contracts: uses
apps/web/src/services/local-content.ts - Local content → Database queries: uses local query
- Page operations → Page history: uses
apps/api/src/page-state/page-operation-service.ts - Page operations → Protected content: uses
apps/api/src/page-state/page-operation-service.ts - Page operations → Workspace search: updates
apps/api/src/page-state/page-operation-service.ts - Page operations → PostgreSQL store: persists via
apps/api/src/page-state/page-operation-service.ts - Page operations → Block tree model: uses
apps/api/src/page-state/page-operation-service.ts - Local content → Realtime sync: transports sync
apps/web/src/services/local-content.ts - Database queries → Protected content: resolves content
apps/api/src/databases/database-query-service.ts - Database queries → PostgreSQL store: reads projections
apps/api/src/databases/database-query-service.ts - Workspace search → PostgreSQL store: reads sources
apps/api/src/search/search-service.ts - Protected files → Protected content: protects payloads
apps/api/src/files/protected-file-service.ts - Protected files → PostgreSQL store: uses repositories
apps/api/src/files/protected-file-service.ts - Protected content → Canonical payloads: seals payloads
apps/api/src/security/protected-content.ts - API application → Backup and restore: configures
apps/api/src/app.ts - API application → MCP access: configures
apps/api/src/app.ts - API application → PostgreSQL store: uses
apps/api/src/app.ts - API application → Protected files: configures
apps/api/src/app.ts - API application → Notion import: configures
- Local content → Knowledge graph: uses graph
apps/web/src/services/local-content.ts - Desktop client → Local content: uses workspace