{"id":31589374,"url":"https://github.com/siddharthharshraj/quickpe","last_synced_at":"2026-05-03T20:33:46.454Z","repository":{"id":314296125,"uuid":"1054951825","full_name":"siddharthharshraj/QuickPe","owner":"siddharthharshraj","description":"💳 QuickPe - Modern Digital Wallet \u0026 Payment System | Secure, fast, and scalable financial transactions with real-time processing | Built with MERN stack + Serverless architecture | Production-ready with enterprise-grade security","archived":false,"fork":false,"pushed_at":"2025-09-20T21:58:38.000Z","size":879,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-20T23:35:56.530Z","etag":null,"topics":["finance","jwt-authentication","mern","mern-stack","payments","socket-io","wallet"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siddharthharshraj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-11T14:55:39.000Z","updated_at":"2025-09-20T21:58:43.000Z","dependencies_parsed_at":"2025-09-11T18:23:26.555Z","dependency_job_id":"c1117995-9f8e-472e-aa20-fdb5a4fc8841","html_url":"https://github.com/siddharthharshraj/QuickPe","commit_stats":null,"previous_names":["siddharthharshraj/quickpe"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/siddharthharshraj/QuickPe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharthharshraj%2FQuickPe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharthharshraj%2FQuickPe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharthharshraj%2FQuickPe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharthharshraj%2FQuickPe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siddharthharshraj","download_url":"https://codeload.github.com/siddharthharshraj/QuickPe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharthharshraj%2FQuickPe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278551493,"owners_count":26005388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["finance","jwt-authentication","mern","mern-stack","payments","socket-io","wallet"],"created_at":"2025-10-06T02:52:17.990Z","updated_at":"2026-05-03T20:33:46.443Z","avatar_url":"https://github.com/siddharthharshraj.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 QuickPe - Modern Digital Wallet Platform\n\n\u003cdiv align=\"center\"\u003e\n\n![QuickPe Logo](https://img.shields.io/badge/QuickPe-Digital%20Wallet-059669?style=for-the-badge\u0026logo=wallet\u0026logoColor=white)\n\n[![Live Demo](https://img.shields.io/badge/Live-Demo-success?style=for-the-badge\u0026logo=vercel)](https://quickpe.siddharth-dev.tech)\n[![GitHub](https://img.shields.io/badge/GitHub-Repository-black?style=for-the-badge\u0026logo=github)](https://github.com/siddharthharshraj/QuickPe)\n[![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)\n[![Contributors](https://img.shields.io/badge/Contributors-Welcome-brightgreen?style=for-the-badge)](#-contributing)\n\n**A modern, secure, and lightning-fast digital wallet application built for seamless money transfers**\n\n[🚀 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)\n\n\u003c/div\u003e\n\n---\n\n## 🌟 Overview\n\nQuickPe 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.\n\n### 🎯 Why QuickPe?\n\n- **⚡ Lightning Fast**: Instant money transfers with real-time updates\n- **🔒 Bank-Level Security**: JWT authentication, bcrypt hashing, and encrypted communications\n- **📱 Universal Access**: Responsive design works on all devices\n- **🎨 Modern UI/UX**: Beautiful interface built with TailwindCSS and Framer Motion\n- **📊 Smart Analytics**: Comprehensive spending insights and financial reports\n- **🔔 Real-Time Notifications**: Stay updated with every transaction\n- **💳 Money Requests**: Request and approve payments seamlessly\n- **📈 Performance Optimized**: 99.99% uptime with advanced caching\n\n---\n\n## ✨ Key Features\n\n### 🔐 Security \u0026 Authentication\n- JWT-based secure authentication with refresh tokens\n- bcrypt password hashing (10+ salt rounds)\n- Input validation using Zod schemas\n- CORS protection and rate limiting\n- Helmet security headers\n- Role-based access control (User/Admin)\n- Secure session management\n\n### 💸 Core Payment Features\n- **Instant Transfers**: Send money via QuickPe ID\n- **Money Requests**: Request payments from other users\n- **Request Management**: Approve/reject requests with reasons\n- **Transaction History**: Comprehensive filtering and search\n- **Real-Time Updates**: Live balance and transaction updates\n- **Daily Limits**: ₹1,00,000 transfer limit per day\n- **Rate Limiting**: 10 transfers per minute for security\n\n### 📊 Analytics \u0026 Insights\n- Spending analysis with category breakdown\n- Income tracking and trends\n- Monthly/yearly financial reports\n- Interactive charts and graphs\n- Export data to CSV/PDF\n- Real-time KPI monitoring\n- Performance metrics dashboard\n\n### 🔔 Notifications \u0026 Alerts\n- Real-time transaction notifications\n- Money request alerts\n- Low balance warnings\n- Security alerts\n- Email notifications\n- In-app notification center\n- WebSocket-powered live updates\n\n### 👤 User Management\n- User profile with avatar\n- QuickPe ID system\n- Account settings\n- Transaction preferences\n- Security settings\n- Two-factor authentication ready\n- Account deactivation/reactivation\n\n### 🛡️ Admin Features\n- User management dashboard\n- Transaction monitoring\n- System analytics\n- Audit trail logging\n- Telemetry and performance metrics\n- User activity tracking\n- System health monitoring\n\n---\n\n## 🏗️ Tech Stack\n\n### Frontend\n- **Framework**: React 18 with Vite\n- **Styling**: TailwindCSS\n- **Animations**: Framer Motion\n- **State Management**: React Context API\n- **HTTP Client**: Axios\n- **Real-time**: Socket.io Client\n- **Icons**: Heroicons\n- **Charts**: Recharts\n- **Forms**: React Hook Form + Zod\n\n### Backend\n- **Runtime**: Node.js\n- **Framework**: Express.js\n- **Database**: MongoDB with Mongoose\n- **Authentication**: JWT + bcrypt\n- **Real-time**: Socket.io\n- **Validation**: Zod\n- **Security**: Helmet, CORS, Rate Limiting\n- **Logging**: Winston\n- **Caching**: Node-cache\n- **Email**: Nodemailer\n\n### DevOps \u0026 Tools\n- **Version Control**: Git \u0026 GitHub\n- **Package Manager**: npm\n- **Code Quality**: ESLint\n- **Environment**: dotenv\n- **Process Management**: PM2 ready\n- **Deployment**: Vercel/Render ready\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js (v18 or higher)\n- MongoDB (v6 or higher)\n- npm or yarn\n- Git\n\n### Installation\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/siddharthharshraj/QuickPe.git\ncd QuickPe\n```\n\n2. **Install dependencies**\n```bash\n# Install root dependencies\nnpm install\n\n# Install backend dependencies\ncd backend\nnpm install\n\n# Install frontend dependencies\ncd ../frontend\nnpm install\n```\n\n3. **Set up environment variables**\n\n**Backend (.env)**\n```env\n# MongoDB\nMONGODB_URI=mongodb://localhost:27017/quickpe\n\n# JWT\nJWT_SECRET=your-super-secret-jwt-key-change-this-in-production\n\n# Server\nPORT=5001\nNODE_ENV=development\n\n# Email (optional)\nGMAIL_USER=your-email@gmail.com\nGMAIL_APP_PASSWORD=your-app-password\n```\n\n**Frontend (.env)**\n```env\nVITE_API_URL=http://localhost:5001/api/v1\nVITE_SOCKET_URL=http://localhost:5001\n```\n\n4. **Start MongoDB**\n```bash\n# Using MongoDB service\nmongod\n\n# Or using Docker\ndocker run -d -p 27017:27017 --name mongodb mongo:latest\n```\n\n5. **Run the application**\n\n**Development Mode:**\n```bash\n# Terminal 1 - Backend\ncd backend\nnpm start\n\n# Terminal 2 - Frontend\ncd frontend\nnpm run dev\n```\n\n**Production Mode:**\n```bash\n# Backend\ncd backend\nnpm run start:prod\n\n# Frontend\ncd frontend\nnpm run build\nnpm run preview\n```\n\n6. **Access the application**\n- Frontend: http://localhost:5173\n- Backend API: http://localhost:5001\n- API Health: http://localhost:5001/health\n\n---\n\n## 📁 Project Structure\n\n```\nQuickPe/\n├── backend/                 # Backend Node.js application\n│   ├── config/             # Configuration files\n│   ├── controllers/        # Route controllers\n│   ├── middleware/         # Custom middleware\n│   ├── models/            # Mongoose models\n│   ├── routes/            # API routes\n│   ├── services/          # Business logic\n│   ├── utils/             # Utility functions\n│   ├── scripts/           # Utility scripts\n│   └── server.js          # Entry point\n├── frontend/              # Frontend React application\n│   ├── public/           # Static assets\n│   ├── src/\n│   │   ├── components/   # Reusable components\n│   │   ├── contexts/     # React contexts\n│   │   ├── pages/        # Page components\n│   │   ├── services/     # API services\n│   │   ├── sockets/      # Socket.io setup\n│   │   ├── utils/        # Utility functions\n│   │   └── App.jsx       # Main app component\n│   └── index.html        # HTML template\n├── tests/                # Test files and scripts\n│   ├── scripts/         # Test shell scripts\n│   └── backend-scripts/ # Backend test scripts\n├── migrations/          # Database migrations\n├── scripts/            # Utility scripts\n├── .gitignore         # Git ignore rules\n├── LICENSE            # MIT License\n└── README.md          # This file\n```\n\n---\n\n## 🔌 API Documentation\n\n### Authentication Endpoints\n\n#### Register User\n```http\nPOST /api/v1/auth/signup\nContent-Type: application/json\n\n{\n  \"username\": \"john_doe\",\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"password\": \"SecurePass123!\",\n  \"email\": \"john@example.com\"\n}\n```\n\n#### Login\n```http\nPOST /api/v1/auth/signin\nContent-Type: application/json\n\n{\n  \"username\": \"john_doe\",\n  \"password\": \"SecurePass123!\"\n}\n```\n\n### Transaction Endpoints\n\n#### Send Money\n```http\nPOST /api/v1/account/transfer\nAuthorization: Bearer {token}\nContent-Type: application/json\n\n{\n  \"toQuickpeId\": \"QPK-123456\",\n  \"amount\": 1000\n}\n```\n\n#### Get Transaction History\n```http\nGET /api/v1/account/transactions?limit=10\u0026page=1\nAuthorization: Bearer {token}\n```\n\n### Money Request Endpoints\n\n#### Create Money Request\n```http\nPOST /api/v1/money-requests/create\nAuthorization: Bearer {token}\nContent-Type: application/json\n\n{\n  \"quickpeId\": \"QPK-123456\",\n  \"amount\": 5000,\n  \"description\": \"Payment for services\"\n}\n```\n\n#### Get Received Requests\n```http\nGET /api/v1/money-requests/received?status=pending\nAuthorization: Bearer {token}\n```\n\n#### Approve Request\n```http\nPOST /api/v1/money-requests/{requestId}/approve\nAuthorization: Bearer {token}\n```\n\n#### Reject Request\n```http\nPOST /api/v1/money-requests/{requestId}/reject\nAuthorization: Bearer {token}\nContent-Type: application/json\n\n{\n  \"reason\": \"Insufficient funds\"\n}\n```\n\nFor complete API documentation, see the [API Reference](https://quickpe.siddharth-dev.tech/api-docs).\n\n---\n\n## 🧪 Testing\n\n### Run Tests\n```bash\n# Backend tests\ncd backend\nnpm test\n\n# Frontend tests\ncd frontend\nnpm test\n\n# E2E tests\nnpm run test:e2e\n```\n\n### Test Scripts\n```bash\n# Test all features\n./tests/scripts/test-all-features.sh\n\n# Test specific feature\n./tests/scripts/test-deposit.sh\n```\n\n---\n\n## 🚀 Deployment\n\n### Deploy to Vercel (Frontend)\n\n1. Install Vercel CLI\n```bash\nnpm install -g vercel\n```\n\n2. Deploy\n```bash\ncd frontend\nvercel\n```\n\n### Deploy to Render (Backend)\n\n1. Create a new Web Service on [Render](https://render.com)\n2. Connect your GitHub repository\n3. Set environment variables\n4. Deploy\n\n### Environment Variables for Production\n\n**Backend:**\n- `MONGODB_URI`: MongoDB connection string\n- `JWT_SECRET`: Strong secret key\n- `NODE_ENV`: production\n- `PORT`: 5001\n- `GMAIL_USER`: Email for notifications\n- `GMAIL_APP_PASSWORD`: Email app password\n\n**Frontend:**\n- `VITE_API_URL`: Backend API URL\n- `VITE_SOCKET_URL`: Backend Socket.io URL\n\n---\n\n## 🤝 Contributing\n\nWe love contributions! QuickPe is open-source and we welcome contributions from developers of all skill levels.\n\n### How to Contribute\n\n1. **Fork the repository**\n2. **Create a feature branch**\n   ```bash\n   git checkout -b feature/amazing-feature\n   ```\n3. **Make your changes**\n4. **Commit your changes**\n   ```bash\n   git commit -m 'Add some amazing feature'\n   ```\n5. **Push to the branch**\n   ```bash\n   git push origin feature/amazing-feature\n   ```\n6. **Open a Pull Request**\n\n### Contribution Guidelines\n\n- Follow the existing code style\n- Write meaningful commit messages\n- Add tests for new features\n- Update documentation as needed\n- Ensure all tests pass before submitting PR\n- Be respectful and constructive in discussions\n\n### Areas to Contribute\n\n- 🐛 Bug fixes\n- ✨ New features\n- 📝 Documentation improvements\n- 🎨 UI/UX enhancements\n- ⚡ Performance optimizations\n- 🧪 Test coverage\n- 🌍 Internationalization\n- ♿ Accessibility improvements\n\n---\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 👨‍💻 Author\n\n**Siddharth Harsh Raj**\n- Website: [siddharth-dev.tech](https://siddharth-dev.tech)\n- GitHub: [@siddharthharshraj](https://github.com/siddharthharshraj)\n- LinkedIn: [Siddharth Harsh Raj](https://linkedin.com/in/siddharthharshraj)\n- Email: contact@siddharth-dev.tech\n\n---\n\n## 🙏 Acknowledgments\n\n- Thanks to all contributors who have helped shape QuickPe\n- Inspired by modern payment platforms like PayTM, PhonePe, and Google Pay\n- Built with love for the open-source community\n\n---\n\n## 📊 Project Stats\n\n- **Lines of Code**: 50,000+\n- **Components**: 100+\n- **API Endpoints**: 50+\n- **Test Coverage**: 85%+\n- **Performance Score**: 95+\n- **Uptime**: 99.99%\n\n---\n\n## 🗺️ Roadmap\n\n### Current Version (v1.0)\n- ✅ Core payment features\n- ✅ Money request system\n- ✅ Real-time notifications\n- ✅ Analytics dashboard\n- ✅ Admin panel\n- ✅ Audit logging\n\n### Upcoming Features (v2.0)\n- 🔄 QR code payments\n- 🔄 Bill splitting\n- 🔄 Recurring payments\n- 🔄 Multi-currency support\n- 🔄 Merchant accounts\n- 🔄 Payment links\n- 🔄 Mobile apps (iOS/Android)\n- 🔄 Two-factor authentication\n- 🔄 Biometric authentication\n- 🔄 Voice payments\n\n---\n\n## 📞 Support\n\nNeed help? We're here for you!\n\n- 📧 Email: contact@siddharth-dev.tech\n- 🐛 Issues: [GitHub Issues](https://github.com/siddharthharshraj/QuickPe/issues)\n- 💬 Discussions: [GitHub Discussions](https://github.com/siddharthharshraj/QuickPe/discussions)\n\n---\n\n## ⭐ Show Your Support\n\nIf you like this project, please consider giving it a ⭐ on GitHub!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by Siddharth Harsh Raj**\n\n[⬆ Back to Top](#-quickpe---modern-digital-wallet-platform)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharthharshraj%2Fquickpe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddharthharshraj%2Fquickpe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharthharshraj%2Fquickpe/lists"}