FuelVantage | Fuel Station Rewards React Native App

FuelVantage is a complete, enterprise-grade turnkey digital fuel loyalty, forecourt attendant mobile POS, and multi-branch franchise management ecosystem. Engineered specifically for gas station networks, oil company franchises, convenience retail chains, and EV charging hubs, FuelVantage unifies a high-converting Customer Loyalty Mobile App, a rugged in-lane Forecourt Staff Attendant Mobile POS, an executive Super Admin Command Center Mobile App, and a real-time Node.js / Express / TypeScript Backend Engine with MongoDB ACID transactions, Socket.io WebSockets, and Firebase Cloud Messaging.

Built with React Native, the latest Expo SDK, and TailwindCSS / NativeWind. Every operational parameter, dynamic fuel grade price (Regular 87, Diesel Ultra, Premium 93, EV kWh), multi-tier VIP multiplier (Bronze 1.0x, Silver 1.25x, Gold 1.5x, Platinum 2.0x), currency symbol placement, loyalty calculation mode (Points, Stamps, or Hybrid), and station dispenser pump bay is 100% dynamically manageable in real-time via the Super Admin portal and WebSocket push with zero app recompilation.

⭐ Key Highlights & Commercial USPs

• 60-Second Dynamic Anti-Fraud QR Member Pass: Rolling AES-256 HMAC cryptographic nonces cycle automatically every 60 seconds with an animated countdown ring, completely eliminating screenshot sharing and loyalty pass fraud.
• ⛽ Rugged In-Lane Forecourt Staff POS App (@staffapp): Handheld mobile POS for forecourt attendants featuring hardware camera QR decoding in under 100ms, dispenser volume calculations, voucher redemption terminal, tender settlement (Cash, Card, Fleet, Points), and end-of-shift Z-Reports.
• ️ $0-Cost Leaflet Forecourt Map (Zero Google Maps Billing): High-performance interactive OpenStreetMap & CartoDB Voyager vector map layer integrated via React Native WebView with branded station pins, GPS distance calculations, and 1-tap Apple/Google Maps deep linking — saving operators $200+/month in Google Maps API bills.
• Super Admin Command Center App (@adminapp): Franchise executives manage multi-branch station locations, configure dispenser pump bays (Pumps #1 to #16+), update live fuel prices across branches with WebSocket push, view interactive trend charts powered by react-native-gifted-charts, manage attendant shifts, and execute customer loyalty adjustments with mandatory audit remarks.
• High-Converting Customer Loyalty App (@customerapp): Frictionless passwordless 6-digit OTP onboarding, categorized rewards catalog, digital thermal voucher wallet with vector barcodes, viral Refer & Earn growth loop, and itemized PDF fueling receipt export via expo-print and expo-sharing.

• ⚡ Real-Time WebSocket Synchronization (Socket.io): Instant fuel price board broadcasts across all mobile screens, live forecourt transaction feeds for administrators, and sub-second push notifications when points are earned at the dispenser pump.
• ️ MongoDB Multi-Document ACID Transactions: All wallet balance updates, points accruals, and voucher redemptions utilize atomic session.withTransaction() write locks to prevent race conditions and double-spending.
• ✉️ Dynamic Database-Driven Nodemailer SMTP: Live SMTP credentials and dynamic HTML email templates stored directly in MongoDB with automated token interpolation ({{userName}}, {{otpCode}}, {{points}}, {{liters}}, {{fuelType}}) and support for Gmail 16-Digit App Passwords, Brevo, SendGrid, and cPanel webmail.