🎓 Campus Guide

Smart University Navigation App

A production-ready Flutter navigation app for university campuses with real-time GPS tracking, turn-by-turn navigation, and voice guidance.

Features • Screenshots • Tech Stack • Installation • Download

---

� Screenshots

Map View	Building List	Navigation

---

✨ Features

🗺️ Interactive Map

• Satellite imagery with Mapbox SDK
• Color-coded markers by building type
• Zoom-responsive marker scaling
• Real-time GPS location tracking

🧭 Turn-by-Turn Navigation

• Visual route line on map
• Voice-guided instructions (TTS)
• Multiple transport modes (walking, cycling, driving)
• Distance and ETA calculations

🏢 Building Directory

• Search and filter buildings
• Category-based filtering
• Distance badges with walking time
• Pull-to-refresh with haptic feedback

📍 Multi-Campus Support

• Sidi Amar Campus
• Bouni Campus
• Sidi Achor Campus

---

🛠️ Tech Stack

Category	Technology
Framework	Flutter 3.27 / Dart 3.6
Maps	Mapbox Maps Flutter SDK
Routing	Mapbox Directions API / OpenRouteService
Location	Geolocator
Voice	Flutter TTS

---

📥 Download

---

🚀 Installation

Prerequisites

• Flutter SDK 3.27+
• Android Studio / VS Code
• Mapbox Access Token

Setup

git clone https://github.com/blamairia/Campus-Guide.git
cd Campus-Guide

# Copy environment template
cp assets/config/.env.example assets/config/.env
cp android/gradle.properties.example android/gradle.properties

# Add your Mapbox tokens to both files

flutter pub get
flutter run

---

📂 Project Structure

lib/
├── constants/          # Theme, building data
├── screens/            # Map, list, navigation screens
├── services/           # Routing providers (Mapbox/ORS)
├── widgets/            # Reusable components
└── models/             # Data models

---

👤 Author

Billel Lamairia

---

📄 License

MIT License - see LICENSE for details.

---

Made for University Badji Mokhtar Annaba