Fuel Price Watch Android App with Petrol Pump Finder and Price-Drop Alerts

Fuel Price Watch is an Android app that shows the daily petrol and diesel prices for a chosen city, finds the nearest petrol pumps, and alerts the driver when a price falls to a target level. Petrol and diesel prices in India are revised every morning at 6:00 AM, and the price of the same fuel can differ by several rupees per litre between pumps only a few kilometres apart. Most drivers fill up at the nearest pump out of habit and never learn a cheaper pump was a short detour away, or that a waited-for price drop happened yesterday. The app closes that gap: it presents the revised price for the morning, ranks nearby pumps by distance and price, and watches the driver's own target prices so a drop is never missed. For a student, the build covers the full Android stack — data refresh, local storage, location handling and notifications — around a problem every vehicle owner understands.

Fuel Price Watch works as a short daily loop: price data in, comparison and alert checks, then a notification or a ranked list out. Each morning the app pulls the revised petrol and diesel prices for the saved cities and stores them locally, so the board is readable offline for the rest of the day. When the driver opens the app, it takes the phone's location, measures the distance to each pump in the saved pump list, and ranks the pumps by distance or by price as the driver chooses. At the same time the alert engine compares the new prices against every saved target price; when a target is met it raises a local notification naming the pump and the price. The 14-day history chart is drawn from the same stored daily prices, so the trend the driver sees always matches the alert decisions.

1. The app fetches the morning price revision for each saved city and stores the petrol and diesel prices in the local database with the revision date.
2. On launch, the app reads the phone's last known location and computes the distance to every pump in the saved pump list.
3. The pump list is ranked by distance by default, or re-sorted by cheapest petrol when the driver taps the price sort.
4. The alert engine compares the new prices against every saved target price and price-rise step for that city and fuel.
5. When a target is met, a local notification is raised naming the fuel, the pump and the price that triggered it.
6. The history chart renders from the stored daily prices, so the 14-day trend always matches the values the alert engine checked.

Tech stack:

• Kotlin
• Jetpack Compose · Material 3
• Room database · DataStore
• WorkManager · AlarmManager scheduling
• Retrofit · REST price feed
• Fused Location Provider
• Compose Canvas charts
• JUnit · Espresso testing

Fuel Price Watch is built around four capabilities that work together: a city price board, a nearest-pump finder, a 14-day price history chart, and per-fuel price-drop alerts. The price board shows the morning-revised petrol and diesel prices for the selected city with the change since yesterday, so the driver sees today's position at a glance. The pump finder lists nearby pumps with distance, brand and both fuel prices, sortable by distance or by cheapest petrol, so the cheapest nearby option is one tap away. The history chart plots the last 14 days of prices per fuel, making it easy to judge whether today is a good day to fill up. The alert engine watches the driver's target prices and notifies them the morning a target is hit, turning a passive price list into a tool that saves money on every tank.

• [City price board] Morning-revised petrol and diesel prices for each saved city, with the change since yesterday shown next to each price, so today's position is visible at a glance.
• [Nearest pump finder] Pumps listed with distance, brand, petrol price and diesel price, sortable by distance or by cheapest petrol, with a cheapest-pump highlight on every list.
• [14-day price history chart] A per-fuel trend chart drawn from the stored daily prices, so the driver can see whether today's price is high, low or ordinary for the last two weeks.
• [Price-drop alerts] Per-fuel, per-city target prices set by the driver; the app checks each morning revision and raises a local notification naming the pump and the price when a target is met.
• [Price-rise warnings] An optional warning when any saved fuel rises by more than a driver-set step (default step: ₹0.50 per litre), so a hike never comes as a surprise at the pump.
• [Saved cities and offline reading] Saved cities, pumps and alert history live in a local database, so yesterday's board and the full 14-day history stay readable without a connection.
• [Weekly refuel summary — optional extension] A Monday-morning summary naming the cheapest day of the past week per city; clearly optional, it can be dropped without affecting the core app.
• [Route-aware pump suggestions — future scope] Suggesting pumps along a planned route is documented as future scope only; it is not implemented in the shipped build.

• Complete Android app source code (Kotlin + Jetpack Compose)
• Working demo build with 4 cities, 6 pumps and 14-day history data
• Project report PDF (background, architecture, data flow, alert logic, testing)
• PPT presentation for final review
• Viva Q&A preparation document (Android components, WorkManager, Room, notifications)
• Setup and build guide for Android Studio
• Abstract PDF matching this page