🚛 FleetPulse — Real-Time Fleet Monitoring

Monitor your entire fleet in real time — location, speed, alerts and live dashboard.

---

📱 Screenshots

Welcome	Dashboard	Map	Vehicle

---

✨ Features

• 🔴 Live tracking — vehicle data updates every 2 seconds
• 🗺️ Real-time map — colored markers by vehicle status
• 📊 Speed history chart — visual graph per vehicle
• 🚨 Alert system — speed limit detection (>100 km/h)
• 🌙 Dark mode — full dark UI design
• 📱 Cross-platform — works on iOS, Android and Web

---

🏗️ Architecture

FleetPulse/
├── docs/
├── src/
│   ├── @types/
│   ├── assets/
│   ├── components/
│   │   └── AlertBanner/
│   ├── hooks/
│   │   ├── useAuth.ts
│   │   └── useTracking.ts
│   ├── routes/
│   │   └── index.tsx
│   ├── screens/
│   │   ├── Dashboard/
│   │   ├── Login/
│   │   ├── MapLive/
│   │   ├── Profile/
│   │   ├── Vehicle/
│   │   └── Welcome/
│   ├── services/
│   │   └── firebaseConfig.ts
│   ├── store/
│   │   └── useVehicleStore.ts
│   └── theme/
│       └── colors.ts
├── App.tsx
└── README.md

---

## 🚀 Tech Stack

| Technology | Purpose |
|-----------|---------|
| React Native + Expo | Cross-platform mobile app |
| TypeScript | Type safety |
| Firebase Realtime DB | Live data sync |
| Zustand | Global state management |
| TanStack Query | Data fetching & caching |
| React Navigation | Stack + Tab navigation |
| MMKV | Local persistence |
| Zod | Schema validation |

---

## ⚙️ Getting Started

```bash
# Clone the repository
git clone https://github.com/claytonmarcelo/FleetPulse.git

# Install dependencies
cd FleetPulse
npm install

# Start the project
npx expo start

---

📋 Environment Variables

Create a .env file in the root directory:

FIREBASE_API_KEY=your_api_key
FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
FIREBASE_DATABASE_URL=https://your_project.firebaseio.com
FIREBASE_PROJECT_ID=your_project_id

---

👨‍💻 Author

Clayton Marcelo

---

📄 License

MIT License © 2026 Clayton Marcelo.