https://github.com/blackshadowsoftwareltd/fuel_cost
https://github.com/blackshadowsoftwareltd/fuel_cost
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/blackshadowsoftwareltd/fuel_cost
- Owner: blackshadowsoftwareltd
- Created: 2025-06-11T10:55:45.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-20T09:27:17.000Z (about 1 year ago)
- Last Synced: 2025-06-20T10:40:43.356Z (about 1 year ago)
- Language: Dart
- Size: 6.02 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Fuel Cost Tracker
A beautiful Flutter app for tracking your fuel consumption and costs with a modern, professional interface.
## Screenshots
## Features
- **Smart Dashboard** - Real-time statistics and beautiful data visualization
- **Easy Entry** - Quick fuel entry with automatic cost calculation
- **Mileage Tracking** - Calculate fuel efficiency when odometer data is provided
- **Modern UI** - Material 3 design with gradients and smooth animations
- **Responsive** - Works perfectly on all screen sizes
- **Dark Mode** - Automatic light/dark theme support
- **Data Management** - Comprehensive settings for data control
## Getting Started
### Prerequisites
- Flutter 3.32.1 or higher
- Dart SDK
### Installation
1. Clone the repository:
```bash
git clone
cd fuel_cost
```
2. Install dependencies:
```bash
flutter pub get
```
3. Run the app:
```bash
flutter run
```
### Build for Production
#### Web
```bash
flutter build web --release
```
#### Mobile
```bash
# Android
flutter build apk --release
# iOS
flutter build ios --release
```
## Key Features
### Dashboard
- Total fuel cost tracking
- Fuel consumption monitoring
- Average price per liter
- Entry count statistics
### Fuel Entry
- Intuitive form with validation
- Real-time cost preview
- Mileage calculation
- Odometer reading support
### History & Analysis
- Beautiful entry cards
- Detailed fuel history
- Pull-to-refresh support
- Smart delete functionality
### Settings
- Clear specific data types
- Reset options
- Data management tools
## Technical Details
- **Framework:** Flutter 3.32.1
- **Language:** Dart
- **Design:** Material 3
- **Storage:** SharedPreferences
- **Platforms:** Web, iOS, Android, macOS
## Project Structure
```
lib/
├── main.dart # App entry point
├── models/fuel_entry.dart # Data models
├── screens/ # UI screens
│ ├── add_fuel_screen.dart
│ ├── fuel_history_screen.dart
│ └── settings_screen.dart
└── services/ # Business logic
└── fuel_storage_service.dart
```
## Design Highlights
- Material 3 design system
- Gradient backgrounds for visual appeal
- Smooth animations and transitions
- Consistent theming across all screens
- Professional color palette
- Responsive layout design
## License
MIT
## Platform Support
Web, iOS, Android, macOS