How minemap-nl/nexoshare works
Nexo Share is a self-hosted file-sharing application. Its principal workflow is an authenticated user uploading files, creating a protected share, and a recipient downloading it; reverse-share links let guests upload back without accounts. The graph also preserves the documented security, identity, administration, and preview capabilities. The backend entry point is shown as the server-side orchestrator; several frontend pages and backend subsystems are unsampled, so uncertain page-to-API links are dashed rather than asserted.
Main entry points: index.ts API and workflows · App.tsx App routing · Dashboard.tsx Dashboard and admin · GuestUploadPage.tsx Guest drop-off
Components 19
Web application
- App routing
frontend/src/App.tsx - Login and session
frontend/src/hooks/useAuth.ts - Dashboard and admin
frontend/src/pages/Dashboard.tsx - File previews
frontend/src/components/preview/FilePreviewModal.tsx
Sharing workflows
- File upload
frontend/src/pages/UploadView.tsx - Share download
frontend/src/pages/DownloadPage.tsx - Guest drop-off
frontend/src/pages/GuestUploadPage.tsx - Reverse shares
frontend/src/pages/ReverseView.tsx
Backend services
- API and workflows
backend/src/index.ts - PostgreSQL
- Prebuilt ZIP cache
backend/src/lib/sharePrezip.ts - Email rendering
backend/src/lib/emailTemplate.ts
Security and identity
- Upload validation
backend/src/lib/uploadValidation.ts - Storage path policy
backend/src/lib/uploadPathPolicy.ts - ClamAV scanning
backend/src/lib/clamScan.ts - SSO group mapping
backend/src/lib/ssoGroups.ts - Blocked extensions
backend/src/lib/blockedExtensions.ts
Other components
- Account user
- Guest recipient
Connections 26
- Account user → App routing: uses
frontend/src/App.tsx - Guest recipient → App routing: opens link
frontend/src/App.tsx - App routing → Login and session: checks session
frontend/src/App.tsx - App routing → Dashboard and admin: routes authenticated
frontend/src/App.tsx - App routing → Share download: routes share link
frontend/src/App.tsx - App routing → Guest drop-off: routes drop-off link
frontend/src/App.tsx - Account user → File upload: selects files
- Account user → Dashboard and admin: manages account
- Guest recipient → Guest drop-off: uploads files
README.md - Dashboard and admin → Reverse shares: manages links
- File upload → API and workflows: uploads files
- Share download → API and workflows: requests share
- Guest drop-off → API and workflows: submits files
- Reverse shares → API and workflows: manages shares
- API and workflows → PostgreSQL: reads and writes
README.md - API and workflows → Upload validation: validates uploads
backend/src/index.ts - Upload validation → Blocked extensions: checks extensions
backend/src/lib/uploadValidation.ts - API and workflows → Storage path policy: checks storage paths
backend/src/index.ts - API and workflows → ClamAV scanning: scans uploaded files
backend/src/index.ts - API and workflows → Prebuilt ZIP cache: invalidates ZIP cache
backend/src/index.ts - API and workflows → Email rendering: renders email
backend/src/index.ts - API and workflows → SSO group mapping: resolves OIDC groups
backend/src/index.ts - API and workflows → File previews: serves file content
- Account user → File previews: previews files
- API and workflows → ClamAV scanning: scans reverse uploads
README.md - API and workflows → SSO group mapping: supports OIDC SSO
README.md