PitStop Frontend

Next-Generation On-Demand Roadside Assistance App > Fuel Delivery • Emergency Support • EV Charging • Smart Navigation

---

Overview

PitStop is a modern Flutter-based mobile application designed to provide instant on-road assistance for drivers — whether you’re out of fuel, have a flat tire, or need emergency medical help. The app delivers real-time location services, quick service booking, and a Zomato-style UI built with Apple-inspired design principles and Hick’s Law–optimized interactions.

This repository contains the complete frontend source code for the PitStop app.

---

Features

• Real-Time Map View

  • Google Maps integration with dynamic location tracking
  • Apple-style smooth floating navigation button
  • Intelligent bottom-sheet layout (Hick’s Law inspired)

• ️ Modular Service System

  • Fuel delivery, towing, battery replacement, puncture repair
  • EV charging stations, hospitals, pharmacies & oil services

• Beautiful Apple-Style UI

  • Clean glassmorphism effects and curved bottom sheets
  • Light & Dark mode auto-detection
  • Soft shadows, motion-based transitions, and icon animations

• Smart Navigation

  • Floating navigation button always visible
  • Re-center to current location anytime

• Optimized for Speed & UX

  • Lightweight animations
  • Efficient state updates with minimal rebuilds
  • Follows Flutter’s performance best practices

---

️ Folder Structure

pitstop_frontend/
│
├── android/                  # Android native build files
├── ios/                      # iOS native build files
├── assets/                   # App assets (images, icons, logos)
│   ├── icons/
│   └── screens/
│       └── ailment-preview.png
│
├── lib/
│   ├── main.dart             # Entry point
│   ├── theme/
│   │   └── theme.dart        # App-wide color & style definitions
│   ├── screens/
│   │   ├── explore_page.dart # Google Maps + Quick Services UI
│   │   ├── home_page.dart
│   │   ├── orders_page.dart
│   │   └── profile_page.dart
│   ├── widgets/              # Reusable components
│   └── utils/                # Helpers and constants
│
├── pubspec.yaml              # Dependencies and assets registration
├── README.md
└── LICENSE

---

Tech Stack

Layer	Technology	Description
Framework	Flutter 3.x	Cross-platform mobile development
Language	Dart	High-performance and type-safe
Maps	Google Maps Flutter SDK	Real-time map visualization
Location	Flutter Location Plugin	Device geolocation tracking
UI/UX	Apple-style glassmorphism + Material 3	Clean, modern design
State Mgmt	Stateful Widgets	Simple and reactive architecture

---

Design Philosophy

The PitStop UI follows:

• Apple-grade minimalism for visual calmness
• Hick’s Law to reduce cognitive load by grouping related actions
• Zomato-style contrast for visual clarity and service discoverability
• Tesla-style animation fluidity for premium feel

---

App Preview

Explore Page	Dark Mode	Quick Services

---

Screen Showcase

A glimpse into the core app flow, from authentication to managing your profile.

Login Screen	Explore (Home)	My Orders	User Profile

---

Getting Started

1️⃣ Prerequisites

• Flutter SDK 3.x+
• Android Studio / Xcode
• Google Maps API Key

2️⃣ Clone Repository

git clone https://github.com/srivilliamsai/pitstop_frontend.git
cd pitstop_frontend

3️⃣ Configure Google Maps

Create a .env or local configuration file to insert your Google Maps API keys for both platforms:

• android/app/src/main/AndroidManifest.xml
• ios/Runner/AppDelegate.swift

4️⃣ Install Dependencies

flutter pub get

5️⃣ Run App

flutter run

---

Main Screen — ExplorePage

• Displays Google Map + Quick Service Panel
• Interactive draggable bottom sheet
• Always-visible floating navigation FAB
• Auto camera re-center on tap
• Clean dark/light adaptive UI

---

Dependencies

dependencies:
  flutter:
    sdk: flutter
  google_maps_flutter: ^2.5.0
  location: ^6.0.0
  cupertino_icons: ^1.0.8

---

Future Enhancements

• Real-time mechanic tracking
• Integrated payment gateway
• ‍ Mechanic-side dashboard (Flutter Web)
• Analytics & notifications panel
• Firebase Auth for secure sign-in

---

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

‍ Author

Sri Villiam Sai Software Developer | Flutter • Spring Boot • OCI Cloud Chennai, India LinkedIn GitHub

---

Acknowledgements

• Google Maps Flutter Team
• Material Design 3 Community
• Apple Human Interface Guidelines
• Flutter Dev Community

“Empowering safe journeys, one tap at a time.” — PitStop Team