# bikramprasad/fileshare architecture

> Architecture diagram of the GitHub repository bikramprasad/fileshare, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bikramprasad/fileshare
- Repository: https://github.com/bikramprasad/fileshare

## Overview

SwiftDrop is an Express file-sharing application. Users upload a file, which is validated, stored in S3, and recorded in MongoDB; they can then request a share email, whose dispatch is followed by an email-log record. Separate routes render a file page and handle downloads. The README also describes the email-template and SNS/Lambda notification capabilities. Some subsystem links are based on README statements because their implementation details were not excerpted; unsampled relationships are omitted where evidence is unavailable.

Main entry points: [`server.js`](https://github.com/bikramprasad/fileshare/blob/master/server.js) (Express Server), [`controller/uploadFileController.js`](https://github.com/bikramprasad/fileshare/blob/master/controller/uploadFileController.js) (Upload Handler), [`controller/sendEmailController.js`](https://github.com/bikramprasad/fileshare/blob/master/controller/sendEmailController.js) (Email Handler), [`Repository/fileRepo.js`](https://github.com/bikramprasad/fileshare/blob/master/Repository/fileRepo.js) (File Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and Routing"]
  node_server["Express Server<br/>[server.js]"]
  node_upload_routes["Upload Routes"]
  node_download_routes["File Routes"]
  node_download_view["Download Page<br/>[download.ejs]"]
  node_index_view["Upload Page<br/>[index.ejs]"]
  node_logger_middleware["Request Logger"]
end

subgraph group_files["File Sharing"]
  node_upload_middleware["Upload Middleware"]
  node_upload_controller["Upload Handler"]
  node_file_validation["File Validation<br/>[utils.js]"]
  node_mime_types["Allowed Types<br/>[mimeType.js]"]
  node_file_size["Size Limit<br/>[fileSize.js]"]
  node_s3_upload["S3 Upload<br/>[uploadToS3.js]"]
  node_get_file["Share Page Handler"]
  node_download_file["Download Handler"]
  node_s3[("AWS S3")]
end

subgraph group_email["Email Notifications"]
  node_send_controller["Email Handler"]
  node_email_validation["Email Validation<br/>[utils.js]"]
  node_email_publisher["SNS Publisher"]
  node_email_service["Email Service<br/>[emailService.js]"]
  node_email_template["Email Template<br/>[emailTemplate.js]"]
  node_sns_lambda["SNS/Lambda Consumer"]
end

subgraph group_persistence["Persistence and Logging"]
  node_file_repo["File Repository<br/>[fileRepo.js]"]
  node_file_model["File Model<br/>[file.js]"]
  node_file_db[("MongoDB<br/>[db.js]")]
  node_email_repo["Email Repository<br/>[emailRepo.js]"]
  node_email_model["Email Model<br/>[email.js]"]
  node_logger["Application Logger<br/>[logger.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_server
node_server -->|"mounts"| node_upload_routes
node_server -->|"mounts"| node_download_routes
node_server -->|"installs"| node_logger_middleware
node_logger_middleware -->|"uses"| node_logger
node_upload_routes -->|"runs"| node_upload_middleware
node_upload_routes -->|"dispatches"| node_upload_controller
node_upload_routes -->|"dispatches"| node_send_controller
node_download_routes -->|"dispatches"| node_get_file
node_download_routes -->|"dispatches"| node_download_file
node_upload_controller -->|"validates"| node_file_validation
node_file_validation -->|"checks types"| node_mime_types
node_upload_controller -->|"checks size"| node_file_size
node_upload_controller -->|"uploads"| node_s3_upload
node_upload_controller -->|"saves metadata"| node_file_repo
node_s3_upload -->|"stores file"| node_s3
node_file_repo -->|"queries"| node_file_model
node_server -->|"initializes"| node_file_db
node_get_file -->|"looks up file"| node_file_repo
node_download_file -->|"looks up file"| node_file_repo
node_get_file -->|"renders"| node_download_view
node_download_file -->|"renders errors"| node_download_view
node_send_controller -->|"validates addresses"| node_email_validation
node_send_controller -->|"checks file"| node_file_repo
node_send_controller -->|"checks and records"| node_email_repo
node_send_controller -->|"dispatches email"| node_email_publisher
node_email_repo -->|"queries"| node_email_model
node_email_publisher -->|"publishes notification"| node_sns_lambda
node_user -->|"opens form"| node_index_view
node_email_template -.->|"formats notification"| node_sns_lambda

click node_server "https://github.com/bikramprasad/fileshare/blob/master/server.js"
click node_upload_routes "https://github.com/bikramprasad/fileshare/blob/master/routes/uploadFileandSendEmailRoutes.js"
click node_download_routes "https://github.com/bikramprasad/fileshare/blob/master/routes/downloadandViewRoutes.js"
click node_upload_middleware "https://github.com/bikramprasad/fileshare/blob/master/middlewares/uploadMiddleware.js"
click node_upload_controller "https://github.com/bikramprasad/fileshare/blob/master/controller/uploadFileController.js"
click node_file_validation "https://github.com/bikramprasad/fileshare/blob/master/utils/utils.js"
click node_mime_types "https://github.com/bikramprasad/fileshare/blob/master/utils/mimeType.js"
click node_file_size "https://github.com/bikramprasad/fileshare/blob/master/utils/fileSize.js"
click node_s3_upload "https://github.com/bikramprasad/fileshare/blob/master/utils/uploadToS3.js"
click node_file_repo "https://github.com/bikramprasad/fileshare/blob/master/Repository/fileRepo.js"
click node_file_model "https://github.com/bikramprasad/fileshare/blob/master/models/file.js"
click node_file_db "https://github.com/bikramprasad/fileshare/blob/master/config/db.js"
click node_get_file "https://github.com/bikramprasad/fileshare/blob/master/controller/getFileController.js"
click node_download_file "https://github.com/bikramprasad/fileshare/blob/master/controller/downloadController.js"
click node_download_view "https://github.com/bikramprasad/fileshare/blob/master/views/download.ejs"
click node_index_view "https://github.com/bikramprasad/fileshare/blob/master/views/index.ejs"
click node_send_controller "https://github.com/bikramprasad/fileshare/blob/master/controller/sendEmailController.js"
click node_email_validation "https://github.com/bikramprasad/fileshare/blob/master/utils/utils.js"
click node_email_publisher "https://github.com/bikramprasad/fileshare/blob/master/utils/sendEmailPublisher.js"
click node_email_service "https://github.com/bikramprasad/fileshare/blob/master/service/emailService.js"
click node_email_template "https://github.com/bikramprasad/fileshare/blob/master/service/emailTemplate.js"
click node_email_repo "https://github.com/bikramprasad/fileshare/blob/master/Repository/emailRepo.js"
click node_email_model "https://github.com/bikramprasad/fileshare/blob/master/models/email.js"
click node_logger_middleware "https://github.com/bikramprasad/fileshare/blob/master/middlewares/loggerMiddleware.js"
click node_logger "https://github.com/bikramprasad/fileshare/blob/master/utils/logger.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_upload_routes,node_download_routes,node_download_view,node_index_view,node_logger_middleware,node_user toneBlue
class node_upload_middleware,node_upload_controller,node_file_validation,node_mime_types,node_file_size,node_s3_upload,node_get_file,node_download_file,node_s3 toneAmber
class node_send_controller,node_email_validation,node_email_publisher,node_email_service,node_email_template,node_sns_lambda toneMint
class node_file_repo,node_file_model,node_file_db,node_email_repo,node_email_model,node_logger toneRose
```

## Components

### Web and Routing

- [Express Server](https://github.com/bikramprasad/fileshare/blob/master/server.js): `server.js`
- [Upload Routes](https://github.com/bikramprasad/fileshare/blob/master/routes/uploadFileandSendEmailRoutes.js): `routes/uploadFileandSendEmailRoutes.js`
- [File Routes](https://github.com/bikramprasad/fileshare/blob/master/routes/downloadandViewRoutes.js): `routes/downloadandViewRoutes.js`
- [Download Page](https://github.com/bikramprasad/fileshare/blob/master/views/download.ejs): `views/download.ejs`
- [Upload Page](https://github.com/bikramprasad/fileshare/blob/master/views/index.ejs): `views/index.ejs`
- [Request Logger](https://github.com/bikramprasad/fileshare/blob/master/middlewares/loggerMiddleware.js): `middlewares/loggerMiddleware.js`

### File Sharing

- [Upload Middleware](https://github.com/bikramprasad/fileshare/blob/master/middlewares/uploadMiddleware.js): `middlewares/uploadMiddleware.js`
- [Upload Handler](https://github.com/bikramprasad/fileshare/blob/master/controller/uploadFileController.js): `controller/uploadFileController.js`
- [File Validation](https://github.com/bikramprasad/fileshare/blob/master/utils/utils.js): `utils/utils.js`
- [Allowed Types](https://github.com/bikramprasad/fileshare/blob/master/utils/mimeType.js): `utils/mimeType.js`
- [Size Limit](https://github.com/bikramprasad/fileshare/blob/master/utils/fileSize.js): `utils/fileSize.js`
- [S3 Upload](https://github.com/bikramprasad/fileshare/blob/master/utils/uploadToS3.js): `utils/uploadToS3.js`
- [Share Page Handler](https://github.com/bikramprasad/fileshare/blob/master/controller/getFileController.js): `controller/getFileController.js`
- [Download Handler](https://github.com/bikramprasad/fileshare/blob/master/controller/downloadController.js): `controller/downloadController.js`
- **AWS S3**

### Email Notifications

- [Email Handler](https://github.com/bikramprasad/fileshare/blob/master/controller/sendEmailController.js): `controller/sendEmailController.js`
- [Email Validation](https://github.com/bikramprasad/fileshare/blob/master/utils/utils.js): `utils/utils.js`
- [SNS Publisher](https://github.com/bikramprasad/fileshare/blob/master/utils/sendEmailPublisher.js): `utils/sendEmailPublisher.js`
- [Email Service](https://github.com/bikramprasad/fileshare/blob/master/service/emailService.js): `service/emailService.js`
- [Email Template](https://github.com/bikramprasad/fileshare/blob/master/service/emailTemplate.js): `service/emailTemplate.js`
- **SNS/Lambda Consumer**

### Persistence and Logging

- [File Repository](https://github.com/bikramprasad/fileshare/blob/master/Repository/fileRepo.js): `Repository/fileRepo.js`
- [File Model](https://github.com/bikramprasad/fileshare/blob/master/models/file.js): `models/file.js`
- [MongoDB](https://github.com/bikramprasad/fileshare/blob/master/config/db.js): `config/db.js`
- [Email Repository](https://github.com/bikramprasad/fileshare/blob/master/Repository/emailRepo.js): `Repository/emailRepo.js`
- [Email Model](https://github.com/bikramprasad/fileshare/blob/master/models/email.js): `models/email.js`
- [Application Logger](https://github.com/bikramprasad/fileshare/blob/master/utils/logger.js): `utils/logger.js`

### Other components

- **User**

## Connections

- User → Express Server: uses (evidence: `README.md`)
- Express Server → Upload Routes: mounts (evidence: `server.js`)
- Express Server → File Routes: mounts (evidence: `server.js`)
- Express Server → Request Logger: installs (evidence: `server.js`)
- Request Logger → Application Logger: uses (evidence: `middlewares/loggerMiddleware.js`)
- Upload Routes → Upload Middleware: runs (evidence: `routes/uploadFileandSendEmailRoutes.js`)
- Upload Routes → Upload Handler: dispatches (evidence: `routes/uploadFileandSendEmailRoutes.js`)
- Upload Routes → Email Handler: dispatches (evidence: `routes/uploadFileandSendEmailRoutes.js`)
- File Routes → Share Page Handler: dispatches (evidence: `routes/downloadandViewRoutes.js`)
- File Routes → Download Handler: dispatches (evidence: `routes/downloadandViewRoutes.js`)
- Upload Handler → File Validation: validates (evidence: `controller/uploadFileController.js`)
- File Validation → Allowed Types: checks types (evidence: `utils/utils.js`)
- Upload Handler → Size Limit: checks size (evidence: `controller/uploadFileController.js`)
- Upload Handler → S3 Upload: uploads (evidence: `controller/uploadFileController.js`)
- Upload Handler → File Repository: saves metadata (evidence: `controller/uploadFileController.js`)
- S3 Upload → AWS S3: stores file (evidence: `README.md`)
- File Repository → File Model: queries (evidence: `Repository/fileRepo.js`)
- Express Server → MongoDB: initializes (evidence: `server.js`)
- Share Page Handler → File Repository: looks up file (evidence: `controller/getFileController.js`)
- Download Handler → File Repository: looks up file (evidence: `controller/downloadController.js`)
- Share Page Handler → Download Page: renders (evidence: `controller/getFileController.js`)
- Download Handler → Download Page: renders errors (evidence: `controller/downloadController.js`)
- Email Handler → Email Validation: validates addresses (evidence: `controller/sendEmailController.js`)
- Email Handler → File Repository: checks file (evidence: `controller/sendEmailController.js`)
- Email Handler → Email Repository: checks and records (evidence: `controller/sendEmailController.js`)
- Email Handler → SNS Publisher: dispatches email (evidence: `controller/sendEmailController.js`)
- Email Repository → Email Model: queries (evidence: `Repository/emailRepo.js`)
- SNS Publisher → SNS/Lambda Consumer: publishes notification (evidence: `README.md`)
- User → Upload Page: opens form (evidence: `README.md`)
- Email Template → SNS/Lambda Consumer: formats notification
