Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/siddharthharshraj/quickpe

💳 QuickPe - Modern Digital Wallet & Payment System | Secure, fast, and scalable financial transactions with real-time processing | Built with MERN stack + Serverless architecture | Production-ready with enterprise-grade security
https://github.com/siddharthharshraj/quickpe

finance jwt-authentication mern mern-stack payments socket-io wallet

Last synced: about 2 months ago
JSON representation

💳 QuickPe - Modern Digital Wallet & Payment System | Secure, fast, and scalable financial transactions with real-time processing | Built with MERN stack + Serverless architecture | Production-ready with enterprise-grade security

Awesome Lists containing this project

README 

          
# 💰 QuickPe - Modern Digital Wallet Platform






![QuickPe Logo](https://img.shields.io/badge/QuickPe-Digital%20Wallet-059669?style=for-the-badge&logo=wallet&logoColor=white)



[![Live Demo](https://img.shields.io/badge/Live-Demo-success?style=for-the-badge&logo=vercel)](https://quickpe.siddharth-dev.tech)

[![GitHub](https://img.shields.io/badge/GitHub-Repository-black?style=for-the-badge&logo=github)](https://github.com/siddharthharshraj/QuickPe)

[![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)

[![Contributors](https://img.shields.io/badge/Contributors-Welcome-brightgreen?style=for-the-badge)](#-contributing)



**A modern, secure, and lightning-fast digital wallet application built for seamless money transfers**



[🚀 Live Demo](https://quickpe.siddharth-dev.tech) • [📖 Documentation](#-documentation) • [🐛 Report Bug](https://github.com/siddharthharshraj/QuickPe/issues) • [✨ Request Feature](https://github.com/siddharthharshraj/QuickPe/issues) • [🤝 Contribute](#-contributing)






---



## 🌟 Overview



QuickPe is a cutting-edge digital wallet and payment system that revolutionizes how people send, receive, and manage money. Built with modern web technologies including React, Node.js, MongoDB, and Socket.io, QuickPe offers instant transactions, real-time notifications, comprehensive analytics, and bank-level security.



### 🎯 Why QuickPe?



- **⚡ Lightning Fast**: Instant money transfers with real-time updates

- **🔒 Bank-Level Security**: JWT authentication, bcrypt hashing, and encrypted communications

- **📱 Universal Access**: Responsive design works on all devices

- **🎨 Modern UI/UX**: Beautiful interface built with TailwindCSS and Framer Motion

- **📊 Smart Analytics**: Comprehensive spending insights and financial reports

- **🔔 Real-Time Notifications**: Stay updated with every transaction

- **💳 Money Requests**: Request and approve payments seamlessly

- **📈 Performance Optimized**: 99.99% uptime with advanced caching



---



## ✨ Key Features



### 🔐 Security & Authentication

- JWT-based secure authentication with refresh tokens

- bcrypt password hashing (10+ salt rounds)

- Input validation using Zod schemas

- CORS protection and rate limiting

- Helmet security headers

- Role-based access control (User/Admin)

- Secure session management



### 💸 Core Payment Features

- **Instant Transfers**: Send money via QuickPe ID

- **Money Requests**: Request payments from other users

- **Request Management**: Approve/reject requests with reasons

- **Transaction History**: Comprehensive filtering and search

- **Real-Time Updates**: Live balance and transaction updates

- **Daily Limits**: ₹1,00,000 transfer limit per day

- **Rate Limiting**: 10 transfers per minute for security



### 📊 Analytics & Insights

- Spending analysis with category breakdown

- Income tracking and trends

- Monthly/yearly financial reports

- Interactive charts and graphs

- Export data to CSV/PDF

- Real-time KPI monitoring

- Performance metrics dashboard



### 🔔 Notifications & Alerts

- Real-time transaction notifications

- Money request alerts

- Low balance warnings

- Security alerts

- Email notifications

- In-app notification center

- WebSocket-powered live updates



### 👤 User Management

- User profile with avatar

- QuickPe ID system

- Account settings

- Transaction preferences

- Security settings

- Two-factor authentication ready

- Account deactivation/reactivation



### 🛡️ Admin Features

- User management dashboard

- Transaction monitoring

- System analytics

- Audit trail logging

- Telemetry and performance metrics

- User activity tracking

- System health monitoring



---



## 🏗️ Tech Stack



### Frontend

- **Framework**: React 18 with Vite

- **Styling**: TailwindCSS

- **Animations**: Framer Motion

- **State Management**: React Context API

- **HTTP Client**: Axios

- **Real-time**: Socket.io Client

- **Icons**: Heroicons

- **Charts**: Recharts

- **Forms**: React Hook Form + Zod



### Backend

- **Runtime**: Node.js

- **Framework**: Express.js

- **Database**: MongoDB with Mongoose

- **Authentication**: JWT + bcrypt

- **Real-time**: Socket.io

- **Validation**: Zod

- **Security**: Helmet, CORS, Rate Limiting

- **Logging**: Winston

- **Caching**: Node-cache

- **Email**: Nodemailer



### DevOps & Tools

- **Version Control**: Git & GitHub

- **Package Manager**: npm

- **Code Quality**: ESLint

- **Environment**: dotenv

- **Process Management**: PM2 ready

- **Deployment**: Vercel/Render ready



---



## 🚀 Quick Start



### Prerequisites



- Node.js (v18 or higher)

- MongoDB (v6 or higher)

- npm or yarn

- Git



### Installation



1. **Clone the repository**

```bash

git clone https://github.com/siddharthharshraj/QuickPe.git

cd QuickPe

```



2. **Install dependencies**

```bash

# Install root dependencies

npm install



# Install backend dependencies

cd backend

npm install



# Install frontend dependencies

cd ../frontend

npm install

```



3. **Set up environment variables**



**Backend (.env)**

```env

# MongoDB

MONGODB_URI=mongodb://localhost:27017/quickpe



# JWT

JWT_SECRET=your-super-secret-jwt-key-change-this-in-production



# Server

PORT=5001

NODE_ENV=development



# Email (optional)

GMAIL_USER=your-email@gmail.com

GMAIL_APP_PASSWORD=your-app-password

```



**Frontend (.env)**

```env

VITE_API_URL=http://localhost:5001/api/v1

VITE_SOCKET_URL=http://localhost:5001

```



4. **Start MongoDB**

```bash

# Using MongoDB service

mongod



# Or using Docker

docker run -d -p 27017:27017 --name mongodb mongo:latest

```



5. **Run the application**



**Development Mode:**

```bash

# Terminal 1 - Backend

cd backend

npm start



# Terminal 2 - Frontend

cd frontend

npm run dev

```



**Production Mode:**

```bash

# Backend

cd backend

npm run start:prod



# Frontend

cd frontend

npm run build

npm run preview

```



6. **Access the application**

- Frontend: http://localhost:5173

- Backend API: http://localhost:5001

- API Health: http://localhost:5001/health



---



## 📁 Project Structure



```

QuickPe/

├── backend/                 # Backend Node.js application

│   ├── config/             # Configuration files

│   ├── controllers/        # Route controllers

│   ├── middleware/         # Custom middleware

│   ├── models/            # Mongoose models

│   ├── routes/            # API routes

│   ├── services/          # Business logic

│   ├── utils/             # Utility functions

│   ├── scripts/           # Utility scripts

│   └── server.js          # Entry point

├── frontend/              # Frontend React application

│   ├── public/           # Static assets

│   ├── src/

│   │   ├── components/   # Reusable components

│   │   ├── contexts/     # React contexts

│   │   ├── pages/        # Page components

│   │   ├── services/     # API services

│   │   ├── sockets/      # Socket.io setup

│   │   ├── utils/        # Utility functions

│   │   └── App.jsx       # Main app component

│   └── index.html        # HTML template

├── tests/                # Test files and scripts

│   ├── scripts/         # Test shell scripts

│   └── backend-scripts/ # Backend test scripts

├── migrations/          # Database migrations

├── scripts/            # Utility scripts

├── .gitignore         # Git ignore rules

├── LICENSE            # MIT License

└── README.md          # This file

```



---



## 🔌 API Documentation



### Authentication Endpoints



#### Register User

```http

POST /api/v1/auth/signup

Content-Type: application/json



{

  "username": "john_doe",

  "firstName": "John",

  "lastName": "Doe",

  "password": "SecurePass123!",

  "email": "john@example.com"

}

```



#### Login

```http

POST /api/v1/auth/signin

Content-Type: application/json



{

  "username": "john_doe",

  "password": "SecurePass123!"

}

```



### Transaction Endpoints



#### Send Money

```http

POST /api/v1/account/transfer

Authorization: Bearer {token}

Content-Type: application/json



{

  "toQuickpeId": "QPK-123456",

  "amount": 1000

}

```



#### Get Transaction History

```http

GET /api/v1/account/transactions?limit=10&page=1

Authorization: Bearer {token}

```



### Money Request Endpoints



#### Create Money Request

```http

POST /api/v1/money-requests/create

Authorization: Bearer {token}

Content-Type: application/json



{

  "quickpeId": "QPK-123456",

  "amount": 5000,

  "description": "Payment for services"

}

```



#### Get Received Requests

```http

GET /api/v1/money-requests/received?status=pending

Authorization: Bearer {token}

```



#### Approve Request

```http

POST /api/v1/money-requests/{requestId}/approve

Authorization: Bearer {token}

```



#### Reject Request

```http

POST /api/v1/money-requests/{requestId}/reject

Authorization: Bearer {token}

Content-Type: application/json



{

  "reason": "Insufficient funds"

}

```



For complete API documentation, see the [API Reference](https://quickpe.siddharth-dev.tech/api-docs).



---



## 🧪 Testing



### Run Tests

```bash

# Backend tests

cd backend

npm test



# Frontend tests

cd frontend

npm test



# E2E tests

npm run test:e2e

```



### Test Scripts

```bash

# Test all features

./tests/scripts/test-all-features.sh



# Test specific feature

./tests/scripts/test-deposit.sh

```



---



## 🚀 Deployment



### Deploy to Vercel (Frontend)



1. Install Vercel CLI

```bash

npm install -g vercel

```



2. Deploy

```bash

cd frontend

vercel

```



### Deploy to Render (Backend)



1. Create a new Web Service on [Render](https://render.com)

2. Connect your GitHub repository

3. Set environment variables

4. Deploy



### Environment Variables for Production



**Backend:**

- `MONGODB_URI`: MongoDB connection string

- `JWT_SECRET`: Strong secret key

- `NODE_ENV`: production

- `PORT`: 5001

- `GMAIL_USER`: Email for notifications

- `GMAIL_APP_PASSWORD`: Email app password



**Frontend:**

- `VITE_API_URL`: Backend API URL

- `VITE_SOCKET_URL`: Backend Socket.io URL



---



## 🤝 Contributing



We love contributions! QuickPe is open-source and we welcome contributions from developers of all skill levels.



### How to Contribute



1. **Fork the repository**

2. **Create a feature branch**

   ```bash

   git checkout -b feature/amazing-feature

   ```

3. **Make your changes**

4. **Commit your changes**

   ```bash

   git commit -m 'Add some amazing feature'

   ```

5. **Push to the branch**

   ```bash

   git push origin feature/amazing-feature

   ```

6. **Open a Pull Request**



### Contribution Guidelines



- Follow the existing code style

- Write meaningful commit messages

- Add tests for new features

- Update documentation as needed

- Ensure all tests pass before submitting PR

- Be respectful and constructive in discussions



### Areas to Contribute



- 🐛 Bug fixes

- ✨ New features

- 📝 Documentation improvements

- 🎨 UI/UX enhancements

- ⚡ Performance optimizations

- 🧪 Test coverage

- 🌍 Internationalization

- ♿ Accessibility improvements



---



## 📝 License



This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.



---



## 👨‍💻 Author



**Siddharth Harsh Raj**

- Website: [siddharth-dev.tech](https://siddharth-dev.tech)

- GitHub: [@siddharthharshraj](https://github.com/siddharthharshraj)

- LinkedIn: [Siddharth Harsh Raj](https://linkedin.com/in/siddharthharshraj)

- Email: contact@siddharth-dev.tech



---



## 🙏 Acknowledgments



- Thanks to all contributors who have helped shape QuickPe

- Inspired by modern payment platforms like PayTM, PhonePe, and Google Pay

- Built with love for the open-source community



---



## 📊 Project Stats



- **Lines of Code**: 50,000+

- **Components**: 100+

- **API Endpoints**: 50+

- **Test Coverage**: 85%+

- **Performance Score**: 95+

- **Uptime**: 99.99%



---



## 🗺️ Roadmap



### Current Version (v1.0)

- ✅ Core payment features

- ✅ Money request system

- ✅ Real-time notifications

- ✅ Analytics dashboard

- ✅ Admin panel

- ✅ Audit logging



### Upcoming Features (v2.0)

- 🔄 QR code payments

- 🔄 Bill splitting

- 🔄 Recurring payments

- 🔄 Multi-currency support

- 🔄 Merchant accounts

- 🔄 Payment links

- 🔄 Mobile apps (iOS/Android)

- 🔄 Two-factor authentication

- 🔄 Biometric authentication

- 🔄 Voice payments



---



## 📞 Support



Need help? We're here for you!



- 📧 Email: contact@siddharth-dev.tech

- 🐛 Issues: [GitHub Issues](https://github.com/siddharthharshraj/QuickPe/issues)

- 💬 Discussions: [GitHub Discussions](https://github.com/siddharthharshraj/QuickPe/discussions)



---



## ⭐ Show Your Support



If you like this project, please consider giving it a ⭐ on GitHub!



---






**Made with ❤️ by Siddharth Harsh Raj**



[⬆ Back to Top](#-quickpe---modern-digital-wallet-platform)