Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time




Based on GitHub Release downloads and DockerHub pulls.


This was made as the coursework for my COMP3006 university module. The requirements were to develop a responsive and interactive web application that uses web sockets, Node.js, and PouchDB or MongoDB as its server-side database. This project got 89/100.

What is FileDrop?

FileDrop is an application that allows for encrypted file sharing between two users through the use of web sockets.

How does it work?

You download the application for the operating system you use from the Releases section, and run the app. Once you can see the IP and port of the server, it means it's working. You can then use any device on the same network to navigate to that IP and port. From there, you can choose a username and log in. Devices that are logged in would be able to see each other. At this point, you can ask for another client's permission to send them a file, or manually whitelist a client so they can send you a file whenever they wish.

How can I host the server without using the Electron app?

Electron apps are big, no arguments there. You can simply download the source code (or from the Releases section), open a terminal in the same directory as the package.json file, run npm install followed by npm start. Alternatively, you can use the Docker image (further instructions can be found in the README on DockerHub).

How does the encryption work?

First and foremost, all encryption is done on the client-side so that the server doesn't need to be trusted. This also increases performance as encryption is a resource-intensive task, and by distributing the workload between clients, the server can transfer files as fast as possible. When the page first loads, an RSA public/private key pair is generated and stored in the browser's local storage. The public key is then broadcasted to other clients. When the user chooses a file and clicks on the upload button, the file is split into chunks of 256KB. A 256-bit AES key is then generated, and the public RSA key of the client the user is sending the file to is used to encrypt the AES key. The AES key is then used to symmetrically encrypt each chunk before sending it to the server. The encrypted AES key is sent with the encrypted chunk data as well. The other client then uses their private key to decrypt the AES key, which they can use to decrypt the chunk data. Once all the chunks have been received, they're put together to form the original file, which is then downloaded to the client's device.

What does the app look like?

Login Page


Application Page



Resource URL
Mockup Devices Device Shots
Login Background BG Jar
Main Background SVG Backgrounds
Font Awesome Font Awesome
Jest NPM
Express NPM
Jest NPM
Nodemon NPM
Socket.IO NPM
Socket.IO Client NPM
SuperTest NPM
CryptoJS NPM
Forge NPM
Puppeteer NPM
Electron NPM
Electron Builder NPM
Electron Local Shortcut NPM