How lewan24/nodexmesh works
NodexMesh is a self-hosted collaborative visual workspace for creating and sharing multi-board projects built from typed canvas blocks. The primary workflow is a user editing a board in the React canvas, saving project changes through the workspace adapter and API, and persisting them in PostgreSQL. The backend also provides authentication, project permissions, collaboration, public sharing, media storage, administration, and audit capabilities. The README documents the product-level links; sampled source confirms workspace recovery/sync, board mutation, database modeling, and audit behavior, but does not expose every route-to-service call.
Main entry points: AppDbContext.cs EF data model · Program.cs Minimal API · BoardPage.tsx Board editor · workspaceController.ts Workspace sync
Components 23
Workspace frontend
- React application
Frontend/src/app/App.tsx - Board editor
Frontend/src/features/board/pages/BoardPage.tsx - Canvas interaction
Frontend/src/features/canvas/components/Canvas.tsx - Typed blocks
Frontend/src/features/blocks/BlockRenderer.tsx - Project workflow
Frontend/src/features/projects/hooks/useProjects.ts - Workspace sync
Frontend/src/features/projects/services/workspaceController.ts - Recovery drafts
Frontend/src/features/projects/services/recoveryDrafts.ts - HTTP workspace adapter
Frontend/src/features/projects/services/httpWorkspace.ts - Account and admin UI
Frontend/src/features/auth/pages/LoginPage.tsx - Media library UI
Frontend/src/features/library/LibraryDialog.tsx
API and domain
- Minimal API
Backend/src/NodexMeshApi/Program.cs - Board endpoints
Backend/src/NodexMeshApi/Endpoints/BoardEndpoints.cs - Board mutations
Backend/src/NodexMeshApi/Services/BoardMutationService.cs - Authentication endpoints
Backend/src/NodexMeshApi/Endpoints/AuthEndpoints.cs
Persistence and files
- Media storage
Backend/src/NodexMeshApi/Services/LibraryStorage.cs - EF data model
Backend/src/NodexMeshApi/Data/AppDbContext.cs
Sharing and collaboration
- Project sharing
Backend/src/NodexMeshApi/Services/ShareLinkService.cs - Live collaboration
Backend/src/NodexMeshApi/Services/CollaborationHub.cs
Administration and audit
- Audit capture and writing
Backend/src/NodexMeshApi/Auditing/AuditCapture.cs - Audit maintenance
Backend/src/NodexMeshApi/Auditing/AuditMaintenanceService.cs - Administration endpoints
Backend/src/NodexMeshApi/Endpoints/AdminEndpoints.cs
Other components
- Workspace user
- PostgreSQL
Connections 26
- Workspace user → React application: uses
README.md - React application → Board editor: opens editor
README.md - Board editor → Canvas interaction: edits boards
README.md - Canvas interaction → Typed blocks: renders items
README.md - Board editor → Project workflow: manages projects
README.md - Project workflow → Workspace sync: coordinates sync
Frontend/src/features/projects/hooks/useProjects.ts - Workspace sync → Recovery drafts: stores drafts
Frontend/src/features/projects/services/workspaceController.ts - Workspace sync → HTTP workspace adapter: uses adapter
- HTTP workspace adapter → Minimal API: sends requests
README.md - Minimal API → Board endpoints: routes board calls
README.md - Board endpoints → Board mutations: applies mutations
README.md - Board mutations → EF data model: reads and writes
Backend/src/NodexMeshApi/Services/BoardMutationService.cs - EF data model → PostgreSQL: persists data
README.md - Workspace user → Account and admin UI: manages account
README.md - Account and admin UI → Authentication endpoints: authenticates
README.md - Workspace user → Media library UI: manages media
README.md - Media library UI → Media storage: uploads media
README.md - Workspace user → Project sharing: shares projects
README.md - Project sharing → EF data model: stores share links
Backend/src/NodexMeshApi/Services/ShareLinkService.cs - Workspace user → Live collaboration: collaborates live
README.md - Minimal API → Live collaboration: exposes collaboration
README.md - Minimal API → Audit capture and writing: captures events
Backend/src/NodexMeshApi/Endpoints/AuthEndpoints.cs - Audit capture and writing → EF data model: writes audit events
Backend/src/NodexMeshApi/Auditing/AuditCapture.cs - Audit maintenance → EF data model: detects and retains
Backend/src/NodexMeshApi/Auditing/AuditMaintenanceService.cs - Workspace user → Administration endpoints: administers system
README.md - Administration endpoints → EF data model: manages records