⛽ YakıtCep

Turkey's Open-Source Fuel Price Tracker
Türkiye'nin Açık Kaynak Akaryakıt Fiyat Takip Uygulaması

📥 Download APK · 🐛 Report Bug · 💡 Request Feature

---

📱 Screenshots

Ana Sayfa	İl Karşılaştırma	Isı Haritası

Yol Maliyeti	Yakıt Defteri	Haberler

---

🚀 Features / Özellikler

💰 Fuel Prices / Yakıt Fiyatları

• Real-time prices from EPDK (Turkey's official Energy Market Regulatory Authority) for all 81 provinces
• Benzin 95, Motorin (Diesel), and LPG/Otogaz prices
• Price history charts — track trends over the past 30 days
• Turkey heat map — instantly see which provinces have the cheapest fuel
• Multi-province comparison — compare up to 4 provinces side by side
• Favorite province pinning

🗺️ Nearby Stations / Yakınımdaki İstasyonlar

• Interactive map showing fuel stations near your current location
• Powered by OpenStreetMap

📊 Analysis & Calculators / Analiz ve Hesaplayıcılar

• Trip cost calculator — enter your route, vehicle consumption, and get exact cost estimates (split per passenger too)
• OTV/KDV tax calculator — see exactly how much of what you pay is tax vs. fuel margin
• Currency & Brent oil impact — live USD/TRY and Brent crude price correlation with pump prices

📓 Fuel Logbook / Yakıt Defteri

• Log every fill-up: date, liters, cost, odometer reading
• Monthly spending reports with comparative charts
• Multi-vehicle support — manage separate profiles for each car

📰 News Feed / Haberler

• Curated fuel & energy news from Turkish sources
• Search and time-based filtering

🔔 Notifications / Bildirimler

• Price change alerts for your favorite provinces
• Weekly fuel spending summary (every Sunday)
• News notifications

🏠 Home Screen Widget

• Android home screen widget showing your favorite province's current prices — always a glance away

🌐 Localization

• Full Turkish 🇹🇷 and English 🇬🇧 support

---

🛠️ Tech Stack

Category	Library
State Management	Riverpod 2.6
Navigation	GoRouter 14
Charts	fl_chart 0.69
Maps	FlutterMap 8
Background Tasks	WorkManager
Notifications	flutter_local_notifications
Local Storage	SharedPreferences
Ads	Google Mobile Ads

---

📡 Data Sources

Source	Usage
EPDK	Official Turkey fuel price data
OpenStreetMap Overpass API	Nearby fuel station locations
OSRM	Route distance calculation
Exchange Rate API	Live USD/TRY rates
Brent Crude API	Oil price tracking

---

📥 Installation

Option 1 — Download APK (Recommended)

1. Go to Releases
2. Download yakitcep-vX.X.X.apk
3. Enable "Install from unknown sources" on your Android device
4. Install and enjoy!

Option 2 — Build from Source

Requirements:

• Flutter SDK ≥ 3.0.0
• Android SDK / Android Studio

# Clone the repo
git clone https://github.com/BeratARPA/fuel_tr.git
cd fuel_tr

# Install dependencies
flutter pub get

# Run in debug mode
flutter run

# Build release APK
flutter build apk --release

---

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

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

---

👨‍💻 Author

Berat — @BeratARPA

---

Made with ❤️ for Turkish drivers dealing with ever-changing fuel prices.

⭐ Star this repo if you find it useful!