Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fyzanshaik/file-dropzone
File-Dropzone is a web app for quick and easy file uploads, built with Bun and Express. Upload, manage, and securely store files from any device.
https://github.com/fyzanshaik/file-dropzone
backend bun expressjs file-upload nodejs
Last synced: about 5 hours ago
JSON representation
File-Dropzone is a web app for quick and easy file uploads, built with Bun and Express. Upload, manage, and securely store files from any device.
- Host: GitHub
- URL: https://github.com/fyzanshaik/file-dropzone
- Owner: fyzanshaik
- Created: 2024-02-15T04:04:39.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-09-12T05:05:02.000Z (2 months ago)
- Last Synced: 2024-09-12T14:33:03.368Z (2 months ago)
- Topics: backend, bun, expressjs, file-upload, nodejs
- Language: TypeScript
- Homepage:
- Size: 43.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 File-Dropzone: Simple File Upload Web Application
Welcome to File-Dropzone, a straightforward and efficient file upload web application built with Bun and Express! This application allows you to upload files effortlessly and manage them on your server. Whether you're a developer, student, or professional, you'll find File-Dropzone to be a handy tool for managing your files. 📁
## Features
- **📁 Upload Files**: Easily upload multiple files at once.
- **📋 File Management**: Manage uploaded files on your server.
- **🔒 Secure**: Ensure the security of your files with a server-side storage approach.
- **🌐 Cross-Platform**: Access the upload functionality from any device with a web browser.
## Installing Bun
### Windows:
1. **Install WSL (Windows Subsystem for Linux)**:
If you don't have WSL installed, follow the instructions [here](https://docs.microsoft.com/en-us/windows/wsl/install).
2. **Install Bun**:
Open your WSL terminal and run the following command to install Bun:
```bash
curl -fsSL https://bun.sh/install | bash
```
3. **Verify Installation**:
After the installation is complete, type the following command to verify that Bun is installed:
```bash
bun --version
```
You should see the Bun version printed in the terminal.
### Linux (Ubuntu/Debian):
1. **Open a terminal window**.
2. **Install Bun**:
Run the following command to install Bun:
```bash
curl -fsSL https://bun.sh/install | bash
```
3. **Verify Installation**:
After the installation is complete, verify that Bun is installed by typing the following command in the terminal:
```bash
bun --version
```
You should see the Bun version printed in the terminal.
## Getting Started
To get started with File-Dropzone, follow these steps:
### Prerequisites
Ensure that you have Bun installed on your machine. You can download Bun from [here](https://bun.sh/).
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/your-username/file-dropzone.git
```
2. **Navigate to the project directory:**
```bash
cd file-dropzone
```
3. **Install dependencies:**
```bash
bun install
```
4. **Set up environment variables:**
Create a `.env` file in the root directory, or use the existing file present in your project. Add the following variables:
```bash
PORT=3000
UPLOAD_DIRECTORY="/path/to/your/upload/directory"
```
Replace `/path/to/your/upload/directory` with the directory path where you want to store uploaded files. For example:
```bash
UPLOAD_DIRECTORY="/home/fyzanshaik/Documents/MyUploads"
```
Ensure the path is enclosed in double quotes.
5. **Start the server:**
```bash
bun run start
```
6. **Access the application:**
Open your web browser and go to [http://localhost:3000](http://localhost:3000) to access the application.
## Usage
### Uploading Files
1. Click on the "Choose Files" button.
2. Select one or multiple files from your device.
3. Click on the "Upload" button to upload the selected files.
### Managing Files
- Uploaded files will be stored in the specified directory on your server.
- You can further manage these files directly on your server as per your requirements.
## Accessing from Any Device
To access File-Dropzone from any device on the same network:
1. Ensure that your device is connected to the same network as the server running File-Dropzone.
2. Find your IP address by running `ifconfig` on Linux or `ipconfig` on Windows.
3. Note down the IP address associated with your Wi-Fi connection.
4. In your web browser, navigate to `http://your-ip-address:3000/` (replace `your-ip-address` with the IP address you noted earlier).
```bash
e.g., http://192.168.0.1:3000/
```
5. You should now be able to access File-Dropzone from any device on the same network.
## License
Distributed under the MIT License. See [LICENSE](LICENSE) for more information.
Feel free to explore the features of File-Dropzone and customize it according to your needs. Happy file uploading! 🚀