Streamlining employee transportation with real-time tracking, scheduling, and analytics
🎨 Figma Design | 🌐 Live Project | 📄 Postman Documentation | 🖥️ Backend Link | 🎥 YouTube Demo
Commuting to large corporate hubs, IT parks, and business campuses is often a stressful and inefficient experience for employees. Public transport can be unreliable, and private vehicle use contributes to traffic congestion and environmental impact. Corporate shuttles often lack real-time tracking, transparent booking systems, and efficient route management, leading to wasted time and poor employee satisfaction.
UrbanMove provides a comprehensive, tech-enabled corporate shuttle platform that bridges the gap between employees and reliable transportation. By offering real-time tracking, instant booking, and an intuitive dashboard for both users and admins, UrbanMove ensures a seamless commute. Features like GPS-integrated route optimization and multi-role management make it a robust solution for modern corporate needs.
- 👥 Multi-Role System: Admin, Driver, and Passenger roles
- 📅 Real-time Booking: Schedule and book rides instantly
- 🗺️ Live Tracking: Real-time GPS tracking of shuttles
- 💳 Payment Integration: Multiple payment methods and wallet system
- 📊 Analytics Dashboard: Comprehensive ride and user analytics
- 🔔 Smart Notifications: Real-time alerts and updates
- 📱 Responsive Design: Mobile-first approach with Material UI
- 🌙 Dark Mode: Toggle between light and dark themes
- 🎭 Smooth Animations: Framer Motion and Lottie animations
- 🗣️ Multi-language Support: Internationalization ready
- ♿ Accessibility: WCAG compliant design
- 🔐 JWT Authentication: Secure token-based authentication
- 🛡️ Rate Limiting: API protection against abuse
- 📧 Email Verification: Secure user onboarding
- 🔄 Real-time Updates: Socket.io for live data
- ☁️ Cloud Storage: Cloudinary for file uploads
- 📈 Performance: Optimized with React and Vite
React 18.2.0 ⚛️ UI Library
React Router 6.21.1 🛣️ Routing
Material UI 5.15.3 🎨 Component Library
Tailwind CSS 3.4.0 🎭 Styling
Framer Motion 10.16.16 🎬 Animations
Redux Toolkit 2.0.1 🔄 State Management
Axios 1.6.2 🌐 HTTP Client
Socket.io Client 4.6.1 🔌 Real-time
Node.js 🟢 Runtime
Express 4.18.2 🚀 Framework
MongoDB 8.0.3 🍃 Database
Mongoose 8.0.3 🔗 ODM
JWT 9.0.2 🔐 Authentication
Socket.io 4.6.1 🔌 Real-time
Cloudinary 1.41.0 ☁️ Cloud Storage
Nodemailer 6.9.7 📧 Email Service
Vite 5.0.8 ⚡ Build Tool
ESLint 8.55.0 🔍 Linting
Prettier 3.1.1 💅 Code Formatting
Nodemon 3.0.2 🔄 Auto-restart
UrbanMove/
├── 📁 client/ # React Frontend
│ ├── 📁 public/
│ ├── 📁 src/
│ │ ├── 📁 components/ # Reusable Components
│ │ ├── 📁 context/ # React Context
│ │ ├── 📁 pages/ # Page Components
│ │ ├── 📁 routes/ # Route Definitions
│ │ ├── 📁 hooks/ # Custom Hooks
│ │ ├── 📁 utils/ # Utility Functions
│ │ └── 📁 styles/ # CSS/Styles
│ ├── 📄 package.json
│ └── 📄 vite.config.js
├── 📁 server/ # Node.js Backend
│ ├── 📁 controllers/ # Route Controllers
│ ├── 📁 models/ # Database Models
│ ├── 📁 routes/ # API Routes
│ ├── 📁 middleware/ # Custom Middleware
│ ├── 📁 utils/ # Utility Functions
│ └── 📄 package.json
├── 📄 README.md
└── 📄 .gitignore
Landing Page - Modern & Responsive Corporate Shuttle Interface
Admin Dashboard - Real-time Analytics and Route Tracking
Secure Login - Unified Access for Employees and Drivers
- 🚀 Features
- 🛠️ Tech Stack
- 🏗️ Proper Folder Structure
- 📱 Project Screenshots/Images
- 🚦 Routes
- ⚙️ Installation
- 🚀 Getting Started
- 🤝 Contributing
- 📄 License
| Route | Component | Description |
|---|---|---|
/ |
Landing | 🏠 Main landing page |
/home |
Home | 🏡 Home page |
/login |
Login | 🔐 User authentication |
/register |
Register | 📝 User registration |
/forgot-password |
ForgotPassword | 🔑 Password recovery |
/email-verification |
EmailVerification | ✉️ Email verification |
/about |
About | ℹ️ About us |
/contact |
Contact | 📞 Contact page |
/faq |
FAQ | ❓ Frequently asked questions |
/help |
Help | 💡 Help center |
/terms |
Terms | 📄 Terms of service |
/privacy |
Privacy | 🔒 Privacy policy |
| Route | Component | Description |
|---|---|---|
/dashboard |
Dashboard | 📊 User dashboard |
/profile |
Profile | 👤 User profile |
/settings |
Settings | ⚙️ Account settings |
/change-password |
ChangePassword | 🔐 Password change |
/book |
Booking | 📅 Book a ride |
/rides |
Rides | 🚗 My rides |
/ride-history |
RideHistory | 📜 Ride history |
/ride-details/:id |
RideDetails | 📋 Ride details |
/find-ride |
FindRide | 🔍 Find available rides |
/schedule-ride |
ScheduleRide | ⏰ Schedule ride |
/ride-tracking/:id |
RideTracking | 📍 Track ride |
/payment-methods |
PaymentMethods | 💳 Payment methods |
/payment-history |
PaymentHistory | 💰 Payment history |
/wallet |
Wallet | 👛 Digital wallet |
/billing |
Billing | 🧾 Billing info |
/notifications |
Notifications | 🔔 Notifications |
/messages |
Messages | 💬 Messages |
/map-view |
MapView | 🗺️ Map view |
| Route | Component | Description |
|---|---|---|
/driver-dashboard |
DriverDashboard | 🚗 Driver dashboard |
| Route | Component | Description |
|---|---|---|
/admin-dashboard |
AdminDashboard | 🛡️ Admin dashboard |
/user-management |
UserManagement | 👥 Manage users |
/ride-management |
RideManagement | 🚗 Manage rides |
/analytics |
Analytics | 📊 System analytics |
/reports |
Reports | 📈 Generate reports |
- Node.js 18.x or higher
- npm or yarn package manager
- MongoDB database
- Git
- 🍴 Clone the repository
git clone https://github.com/yourusername/UrbanMove.git
cd UrbanMove- 📦 Install dependencies
# Install client dependencies
cd client
npm install
# Install server dependencies
cd ../server
npm install- 🔧 Environment Setup
# Create .env file in server directory
cd server
cp .env.example .env
# Edit .env with your configuration- 🗄️ Database Setup
# Start MongoDB service
# Create database and collections as needed- 🚀 Run the application
# Start server (in server directory)
npm run dev
# Start client (in client directory)
npm run dev# Database
MONGODB_URI=mongodb://localhost:27017/urbanmove
PORT=5000
# JWT
JWT_SECRET=your_jwt_secret_key
JWT_EXPIRE=7d
# Email
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_app_password
# Cloudinary
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
# Other
NODE_ENV=development
FRONTEND_URL=http://localhost:5173npm run dev # Start development server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Run ESLintnpm start # Start production server
npm run dev # Start development server with nodemonPOST /api/auth/register- Register new userPOST /api/auth/login- User loginPOST /api/auth/forgot-password- Forgot passwordPOST /api/auth/reset-password- Reset password
GET /api/users/profile- Get user profilePUT /api/users/profile- Update profileGET /api/users/rides- Get user rides
POST /api/rides/book- Book a rideGET /api/rides/available- Get available ridesGET /api/rides/:id- Get ride detailsPUT /api/rides/:id/status- Update ride status
POST /api/payments/process- Process paymentGET /api/payments/history- Payment historyPOST /api/payments/wallet- Wallet operations
- 🎭 LottieLoader - Animated loading components
- 🗺️ GoogleMapComponent - Interactive maps
- 📊 DataGrid - Material UI data tables
- 🔔 NotificationSystem - Toast notifications
- 🎨 ThemeToggle - Dark/light mode switcher
- 📱 ResponsiveLayout - Mobile-friendly layouts
- 🔐 useAuth - Authentication state management
- 📍 useGeolocation - GPS location tracking
- 💳 usePayments - Payment processing
- 🔔 useNotifications - Real-time notifications
- 👤 Passenger: Book rides, track shuttles, manage payments
- 🚗 Driver: Accept rides, update status, navigate routes
- 🛡️ Admin: Manage users, analytics, system settings
- ⚡ Instant Booking: Book available rides immediately
- ⏰ Scheduled Booking: Plan rides in advance
- 🔄 Recurring Rides: Set up daily/weekly commutes
- 📍 Route Planning: Optimize pickup and dropoff points
- 💳 Multiple Methods: Credit cards, debit cards, digital wallets
- 👛 Digital Wallet: Store funds for quick payments
- 🧾 Auto-billing: Automatic payment processing
- 📊 Transaction History: Complete payment records
- 📈 Ride Statistics: Usage patterns and trends
- 👥 User Analytics: Active users and engagement
- 💰 Revenue Tracking: Financial performance metrics
- 📍 Route Analytics: Popular routes and efficiency
We welcome contributions! Please follow these steps:
- 🍴 Fork the repository
- 🌿 Create a feature branch
git checkout -b feature/AmazingFeature- 💾 Commit your changes
git commit -m 'Add some AmazingFeature'- 📤 Push to the branch
git push origin feature/AmazingFeature- 🔀 Open a Pull Request
- Follow ESLint and Prettier configurations
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed
Found a bug? Please report it by:
- Creating an issue on GitHub
- Providing detailed description
- Including steps to reproduce
- Adding screenshots if applicable
This project is licensed under the MIT License - see the LICENSE file for details.
- React Team - For the amazing UI library
- Material UI - For the beautiful component library
- MongoDB - For the flexible database solution
- Google Maps API - For mapping and geolocation services
- 👤 Author: Your Name
- 📧 Email: your.email@example.com
- 🔗 LinkedIn: [Your LinkedIn Profile]
- 🐦 Twitter: [@yourusername]
If you find this project helpful, please give it a ⭐ on GitHub!
Made with ❤️ and ☕ by the UrbanMove Team
© 2026 UrbanMove. All rights reserved.