https://github.com/elyse502/cloud-file-storage
Cloud based file storage system
https://github.com/elyse502/cloud-file-storage
cloud-computing cloudinary-api cloudinary-integration file-system mern-stack-development
Last synced: 5 months ago
JSON representation
Cloud based file storage system
- Host: GitHub
- URL: https://github.com/elyse502/cloud-file-storage
- Owner: elyse502
- License: mit
- Created: 2025-08-05T16:35:07.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-08-05T17:01:25.000Z (6 months ago)
- Last Synced: 2025-08-05T19:05:06.924Z (6 months ago)
- Topics: cloud-computing, cloudinary-api, cloudinary-integration, file-system, mern-stack-development
- Language: JavaScript
- Homepage:
- Size: 79.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ☁️ Cloud-Based File Storage System
A lightweight MERN stack (MongoDB, Express, React, Node.js) application that allows users to register, log in, upload files (including images, PDFs, and docs), and manage them with Cloudinary as the file storage backend.
---
## 📦 Features
- ✅ User registration & login (JWT auth)
- ☁️ File upload & retrieval via Cloudinary
- 🗂 Supports images, PDFs, docs, HTML, etc.
- 🧾 View uploaded files per user
- ❌ Delete files from both DB & Cloudinary
---
## 🚀 Quick Setup Guide
### 📁 1. Clone the Repository
```bash
git clone https://github.com/elyse502/cloud-file-storage.git
cd cloud-file-storage
```
---
## ⚙️ 2. Server Setup
```bash
cd server
npm install
```
### 🔐 Add a `.env` file in the `/server` folder:
```env
PORT=5000
MONGO_URI="your_mongo_connection_string_here"
JWT_SECRET="your_jwt_secret"
CLOUD_NAME="your_cloudinary_cloud_name"
CLOUD_API_KEY="your_cloudinary_api_key"
CLOUD_API_SECRET="your_cloudinary_api_secret"
```
> 🔒 Your Mongo URI should look like:
>
> ```
> mongodb+srv://:@cluster0.mongodb.net/
> ```
### ▶️ Start the server
```bash
npm run dev
```
---
## 🌐 3. Client Setup
```bash
cd ../client
npm install
```
### 🔐 Add a `.env` file in the `/client` folder:
```env
VITE_API_URL="http://localhost:5000/api"
```
### ▶️ Start the client
```bash
npm run dev
```
---
## 🧪 Test It
- Go to: `http://localhost:5173`
- Register a new account or login
- Upload files & manage them on your dashboard
---
## 📝 Tech Stack
- **Frontend:** React + Vite + Tailwind CSS
- **Backend:** Express.js + MongoDB + JWT
- **Storage:** Cloudinary (raw & image types)
---
## 📂 Folder Structure
```
/client → Frontend (React)
/server → Backend API (Express)
/uploads → (optional) Temporary files if needed
```
---
## 📄 License
MIT © [license](https://github.com/elyse502/cloud-file-storage/blob/main/LICENSE)
**Made with ❤️**