https://github.com/jayeshkhandelwal09/echoverse
https://github.com/jayeshkhandelwal09/echoverse
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/jayeshkhandelwal09/echoverse
- Owner: Jayeshkhandelwal09
- Created: 2025-04-28T10:08:00.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-28T11:27:18.000Z (about 1 month ago)
- Last Synced: 2025-04-28T11:45:45.471Z (about 1 month ago)
- Language: JavaScript
- Size: 36.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EchoVerse 🌌 — Your Future Audio Diaries
> A secure, emotional platform where you can record memories today and unlock them tomorrow ✨
> Record your thoughts. Choose a mood. Set a future unlock date. Let your future self listen back in time.
---
## 🚀 Live Demo
- **Frontend**: https://echo-verse-five.vercel.app/
- **Backend**: https://echoverse-backend-dkc8.onrender.com
---
## 📖 Table of Contents
- [About EchoVerse](#about-echoverse)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Screenshots](#screenshots)
- [Setup Instructions](#setup-instructions)
- [Folder Structure](#folder-structure)
- [Deployment Details](#deployment-details)
- [License](#license)
- [Contact](#contact)
---
## 💐 About EchoVerse
EchoVerse is a full-stack web application where users can:
- 🎤 Record short audio diaries
- 🗓️ Assign future unlock dates
- 🎞️ Select moods to capture their emotions
- 📩 Receive cute email notifications when their entries unlock
- 🔒 Keep their memories secure and personal
It’s more than an app — it’s **emotional time-traveling** made real ✨.
---
## ✨ Features
- 🎤 Record and store audio notes
- 🗓️ Set future unlock dates for your entries
- 🖼️ Mood badges for each entry
- 🔒 Fully private and secure entries
- 🌗 Toggle Dark Mode
- 📩 Automatic Email Notification on Unlock
- 🖥️ Fully Responsive for Mobile and Desktop
- 🚀 Fast Deployment with Vercel and Render
- ⚡ Cloudinary integration for audio storage
---
## 🛠️ Tech Stack
### Frontend:
- React.js (Vite + TypeScript)
- Tailwind CSS
- React Router
- Axios
- React-Hot-Toast (for notifications)
### Backend:
- Node.js
- Express.js
- MongoDB Atlas
- Mongoose
- Cloudinary SDK
- Nodemailer (SMTP Email)
### Hosting:
- **Frontend**: Vercel
- **Backend**: Render
---
## 🖼️ Screenshots
---
## 📦 Setup Instructions
### 1. Clone the Repository
```bash
git clone https://github.com/yourusername/echoverse.git
cd echoverse
```
### 2. Backend Setup (`server/`)
```bash
cd server
npm install
npm run dev
```
Create a `.env` file inside `/server/`:
```env
PORT=5000
MONGO_URI=your-mongo-db-connection-string
JWT_SECRET=your-jwt-secret
CLOUDINARY_CLOUD_NAME=your-cloud-name
CLOUDINARY_API_KEY=your-api-key
CLOUDINARY_API_SECRET=your-api-secret
[email protected]
EMAIL_PASS=your-app-password
```
### 3. Frontend Setup (`frontend/`)
```bash
cd ../frontend
npm install
npm run dev
```
Create a `.env` file inside `/frontend/`:
```env
VITE_API_BASE_URL=http://localhost:5000/api
```
---
## 🐂 Folder Structure
```
echoverse/
├── frontend/ # React + Vite + Tailwind frontend
│ ├── src/
│ ├── public/
│ ├── package.json
│ └── vercel.json
├── server/ # Node.js + Express + MongoDB backend
│ ├── models/
│ ├── routes/
│ ├── controllers/
│ ├── utils/
│ ├── package.json
│ └── app.js
├── README.md
```
---
## 🚀 Deployment Details
### Frontend (Vercel)
- Deploy the `/frontend` directory.
- Set environment variable:
- `VITE_API_BASE_URL=https://your-backend-url.onrender.com/api`
- Add `vercel.json` for SPA routing:
```json
{
"rewrites": [
{ "source": "/(.*)", "destination": "/" }
]
}
```
### Backend (Render)
- Deploy the `/server` directory.
- Set all `.env` variables properly.
- Allow CORS for:
- `http://localhost:5173`
- `https://echo-verse-five.vercel.app/`
> Built with ❤️ for everyone who believes memories are precious ✨