---

🧠 Overview

ChargeGo is a full-stack powerbank-sharing platform that lets users find nearby charging stations, rent a powerbank with a single QR scan, use it on the go, and return it at any station — all billed through an in-app wallet.

No more low-battery anxiety while commuting, traveling, or exploring.

---

🎯 Problem Statement

❌ Problem	✅ ChargeGo Solution
Phone dies while traveling	Rent a powerbank at any nearby station
No charger or outlet nearby	Return at any location, not just where you rented
Complicated rental flows	Scan → Rent → Go — done in seconds
Cash-only systems	Seamless in-app wallet payments

---

🔄 User Flow

┌─────────────────────────────────────────────────────────┐
│                                                         │
│   Sign Up / Login                                       │
│        ↓                                                │
│   Browse Map  →  Find Nearest Station                   │
│        ↓                                                │
│   Scan QR Code  →  Confirm Rental                       │
│        ↓                                                │
│   Use Powerbank Anywhere  🔋                            │
│        ↓                                                │
│   Return at Any Station                                 │
│        ↓                                                │
│   Auto Billed via Wallet  💳                            │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

✨ Features

#	Feature	Description
🔐	Authentication	Secure login & signup with JWT
📍	Station Finder	Interactive map showing nearby stations
🔋	QR Rental	Scan to rent a powerbank instantly
💳	Wallet System	In-app balance for seamless payments
📊	Dashboard	Track rentals, activity & history
📱	Responsive UI	Optimized for mobile & desktop

---

🏗️ Architecture

┌────────────────┐      HTTP/REST      ┌────────────────┐      Mongoose      ┌────────────────┐
│                │  ─────────────────► │                │  ────────────────► │                │
│  React + Vite  │                     │ Node + Express │                     │    MongoDB     │
│   (Frontend)   │  ◄───────────────── │   (Backend)    │  ◄──────────────── │   (Database)   │
│                │      JSON Data      │                │      Documents      │                │
└────────────────┘                     └────────────────┘                     └────────────────┘
      │                                       │
  Netlify                                  Render
 (Deployed)                              (Deployed)

---

📂 Project Structure

charge_go/
│
├── 📁 frontend/
│   ├── public/
│   └── src/
│       ├── 🧩 components/       # Reusable UI components
│       ├── 📄 pages/            # Route-level pages
│       ├── 🔗 context/          # Global state (Context API)
│       ├── 🌐 services/         # API service calls
│       └── 🎨 assets/           # Images, icons, styles
│
├── 📁 backend/
│   ├── ⚙️  config/              # DB & env configuration
│   ├── 🎮 controllers/         # Business logic
│   ├── 🛣️  routes/              # API route definitions
│   ├── 🗃️  models/              # Mongoose schemas
│   ├── 🔒 middleware/           # Auth & error handlers
│   └── 🚀 server.js            # App entry point
│
└── 📄 README.md

---

🛠️ Tech Stack

Frontend

Technology	Role
React	Component-based UI framework
Vite	Lightning-fast build tool
React Router	Client-side routing
Context API	Global state management

Backend

Technology	Role
Node.js	JavaScript runtime
Express.js	REST API framework
JWT	Secure authentication tokens
Mongoose	MongoDB ODM

Infrastructure

Service	Purpose
MongoDB Atlas	Cloud database
Netlify	Frontend deployment
Render	Backend hosting

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/ShahArpanPratikkumar/charge_go.git
cd charge_go

2. Frontend Setup

cd frontend
npm install
npm run dev

3. Backend Setup

cd backend
npm install
npm start

Frontend runs on http://localhost:5173 · Backend runs on http://localhost:5000

---

🔐 Environment Variables

Create a .env file inside the backend/ directory:

# Database
MONGO_URI=your_mongodb_connection_string

# Auth
JWT_SECRET=your_super_secret_key

# CORS
CLIENT_URL=http://localhost:5173

---

📡 API Reference

Auth Routes

Method	Endpoint	Description
POST	/api/auth/register	Create a new user account
POST	/api/auth/login	Login and receive JWT token

User Routes

Method	Endpoint	Description
GET	/api/user/profile	Get current user profile

Rental Routes

Method	Endpoint	Description
POST	/api/rental/start	Start a powerbank rental
POST	/api/rental/end	End rental & process payment

---

🔮 Roadmap

• 🗺️ Real-time station availability tracking
• 💰 Razorpay / Stripe payment gateway
• 🛡️ Admin dashboard for station management
• 📲 Push notifications for rental status
• 🌐 Multi-language support
• 📱 React Native mobile app

---

👨‍💻 Author

Shah Arpan Pratikkumar

---

_{⚡ Built with passion by Shah Arpan Pratikkumar · ChargeGo © 2025}

• Added system improvement phase #1 on May 02, 2026

• Added system improvement phase #2 on May 02, 2026

• Added system improvement phase #3 on May 02, 2026

• Added system improvement phase #4 on May 02, 2026

• Added system improvement phase #5 on May 02, 2026

• Added system improvement phase #6 on May 02, 2026

• Added system improvement phase #7 on May 02, 2026

• Added system improvement phase #8 on May 02, 2026

• Added system improvement phase #1 on May 02, 2026

• Added system improvement phase #2 on May 02, 2026

• Added system improvement phase #3 on May 02, 2026

• Added system improvement phase #4 on May 02, 2026

• Added system improvement phase #5 on May 02, 2026

• Added system improvement phase #6 on May 02, 2026

• Added system improvement phase #7 on May 02, 2026

• Added system improvement phase #8 on May 02, 2026