FuelMate is a production-ready web application designed to help riders calculate exact fuel requirements and costs. It features real-time data, road condition adjustments, and a vast database of motorcycles.

Website: https://fuelmate.onrender.com

• Smart Calculation: Calculate fuel based on distance, mileage, and Road Conditions (City/Highway/Mixed).
• Massive Bike Database: Pre-loaded with 100+ popular bikes including Royal Enfield, Honda, TVS, Ather (EV), and more.
• Real-Time Prices: Fetches live fuel prices for accurate cost estimation.
• Trip History: Save and track your past trips (requires login).
• Admin Panel: Robust dashboard for managing users, bikes, and suggestions.
• Responsive UI: Beautiful, mobile-first design using Bootstrap 5.

• Python 3.9+
• PostgreSQL (or SQLite for local dev)

git clone https://github.com/sameer-ansari-dev/fuelmate.git
cd fuelmate

pip install -r requirements.txt

Create a .env file in the root directory:

DATABASE_URL=sqlite:///fuelmate.db  # or your PostgreSQL URL
SECRET_KEY=your_secure_secret_key
API_NINJAS_KEY=your_api_key       # Optional
GOOGLE_MAPS_API_KEY=your_api_key  # Optional

flask shell
>>> from models import db
>>> db.create_all()
>>> exit()

Run the helper script to create the default admin account:

python create_admin.py

Default Credentials:

• Username: admin
• Password: password

python app.py

Visit http://localhost:5000 in your browser.

Login at /auth/login with the admin credentials. You can:

• Add/Edit/Delete Bikes
• Manage Users (Block/Delete)
• Review User Suggestions
• Monitor Fuel Price Logs

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

Distributed under the MIT License. See LICENSE for more information.

Developed by Ansari Mohammed Sameer