How gurian43/share-your-thing works
Share Your Thing is a full-stack file-sharing application. Users register and authenticate, upload files, manage sharing and access settings, and browse or download shared files; administrators manage site settings, users’ files, and reports. The frontend routes these experiences, while Express routes dispatch API requests to controllers that use MongoDB models and file encryption. The README also documents email notifications and Cloudflare Turnstile. Connections reflect the sampled source and index; unsampled page and controller internals are represented only where their roles are supported by the tree or documentation.
Main entry points: App.jsx Page routing · file.controller.js File workflows · user.controller.js User workflows · admin.controller.js Admin workflows
Components 26
Web application
- Page routing
frontend/src/App.jsx - Authentication state
frontend/src/context/AuthContext.jsx - Registration
frontend/src/pages/RegisterPage.jsx - File dashboard
frontend/src/pages/DashboardPage.jsx - Upload interface
frontend/src/components/dashboard/UploadDialog.jsx - Public browsing
frontend/src/pages/BrowsePage.jsx - Shared file page
frontend/src/pages/FilePage.jsx - User profiles
frontend/src/pages/ProfilePage.jsx - Account management
frontend/src/pages/AccountPage.jsx - Admin console
frontend/src/pages/AdminPage.jsx
API and workflows
- HTTP server
backend/server.js - User workflows
backend/controllers/user.controller.js - File workflows
backend/controllers/file.controller.js - Report handling
backend/controllers/report.controller.js - Admin workflows
backend/controllers/admin.controller.js
Persistence and files
- MongoDB
backend/config/db.js - File records
backend/models/file.model.js - User records
backend/models/user.model.js - Site settings
backend/models/siteSetting.model.js - File storage
backend/controllers/file.controller.js - File encryption
backend/services/encryptionService.js
External services
- Email delivery
backend/services/emailService.js - Bot verification
backend/services/turnstile.js - SMTP provider
- Cloudflare Turnstile
Other components
- Visitor or user
Connections 27
- Visitor or user → Page routing: uses
frontend/src/App.jsx - Page routing → Registration: routes to
frontend/src/App.jsx - Page routing → File dashboard: routes to
frontend/src/App.jsx - Page routing → Public browsing: routes to
frontend/src/App.jsx - Page routing → Shared file page: routes to
frontend/src/App.jsx - Page routing → User profiles: routes to
frontend/src/App.jsx - Page routing → Account management: routes to
frontend/src/App.jsx - Page routing → Admin console: routes to
frontend/src/App.jsx - File dashboard → Upload interface: uses
frontend/src/components/dashboard/UploadDialog.jsx - Authentication state → User workflows: requests identity
frontend/src/context/AuthContext.jsx - HTTP server → User workflows: routes requests
backend/server.js - HTTP server → File workflows: routes requests
backend/server.js - HTTP server → Admin workflows: routes requests
backend/server.js - User workflows → User records: reads and writes
backend/controllers/user.controller.js - User workflows → Email delivery: sends tokens
backend/controllers/user.controller.js - User workflows → Bot verification: verifies signup
backend/controllers/user.controller.js - File workflows → File records: reads and writes
backend/controllers/file.controller.js - File workflows → User records: reads
backend/controllers/file.controller.js - File workflows → Site settings: reads
backend/controllers/file.controller.js - File workflows → File encryption: encrypts and decrypts
backend/controllers/file.controller.js - File workflows → File storage: reads and writes
backend/controllers/file.controller.js - Report handling → File records: reads
backend/controllers/report.controller.js - Admin workflows → File records: manages
backend/controllers/admin.controller.js - Admin workflows → User records: reads
backend/controllers/admin.controller.js - Admin workflows → Site settings: reads and writes
backend/controllers/admin.controller.js - Email delivery → SMTP provider: sends mail
backend/services/emailService.js - Bot verification → Cloudflare Turnstile: verifies token