{"id":29141180,"url":"https://github.com/blackshadowsoftwareltd/fuel_cost","last_synced_at":"2025-09-14T19:58:15.596Z","repository":{"id":298786141,"uuid":"1000157355","full_name":"blackshadowsoftwareltd/fuel_cost","owner":"blackshadowsoftwareltd","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-20T09:27:17.000Z","size":6310,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-20T10:40:43.356Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blackshadowsoftwareltd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T10:55:45.000Z","updated_at":"2025-06-20T09:27:21.000Z","dependencies_parsed_at":"2025-06-12T23:32:58.532Z","dependency_job_id":"57afc2da-69d3-43fa-b17c-5a7c276f4551","html_url":"https://github.com/blackshadowsoftwareltd/fuel_cost","commit_stats":null,"previous_names":["blackshadowsoftwareltd/fuel_cost"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blackshadowsoftwareltd/fuel_cost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackshadowsoftwareltd%2Ffuel_cost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackshadowsoftwareltd%2Ffuel_cost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackshadowsoftwareltd%2Ffuel_cost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackshadowsoftwareltd%2Ffuel_cost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackshadowsoftwareltd","download_url":"https://codeload.github.com/blackshadowsoftwareltd/fuel_cost/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackshadowsoftwareltd%2Ffuel_cost/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262825646,"owners_count":23370419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-30T18:05:34.634Z","updated_at":"2025-06-30T18:05:36.178Z","avatar_url":"https://github.com/blackshadowsoftwareltd.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fuel Cost Tracker\n\nA beautiful Flutter app for tracking your fuel consumption and costs with a modern, professional interface.\n\n## Screenshots\n\n\u003cdiv style=\"display: flex; flex-direction: column; gap: 10px; align-items: center;\"\u003e\n  \u003cimg src=\"screenshots/Screenshot_1.png\" alt=\"Home Screen\" style=\"width: 300px; height: auto;\"\u003e\n  \u003cimg src=\"screenshots/Screenshot_2.png\" alt=\"Add Fuel Entry\" style=\"width: 300px; height: auto;\"\u003e\n  \u003cimg src=\"screenshots/Screenshot_3.png\" alt=\"Fuel History\" style=\"width: 300px; height: auto;\"\u003e\n\u003c/div\u003e\n\n## Features\n\n- **Smart Dashboard** - Real-time statistics and beautiful data visualization\n- **Easy Entry** - Quick fuel entry with automatic cost calculation\n- **Mileage Tracking** - Calculate fuel efficiency when odometer data is provided\n- **Modern UI** - Material 3 design with gradients and smooth animations\n- **Responsive** - Works perfectly on all screen sizes\n- **Dark Mode** - Automatic light/dark theme support\n- **Data Management** - Comprehensive settings for data control\n\n## Getting Started\n\n### Prerequisites\n\n- Flutter 3.32.1 or higher\n- Dart SDK\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone \u003crepository-url\u003e\ncd fuel_cost\n```\n\n2. Install dependencies:\n```bash\nflutter pub get\n```\n\n3. Run the app:\n```bash\nflutter run\n```\n\n### Build for Production\n\n#### Web\n```bash\nflutter build web --release\n```\n\n#### Mobile\n```bash\n# Android\nflutter build apk --release\n\n# iOS\nflutter build ios --release\n```\n\n## Key Features\n\n### Dashboard\n- Total fuel cost tracking\n- Fuel consumption monitoring\n- Average price per liter\n- Entry count statistics\n\n### Fuel Entry\n- Intuitive form with validation\n- Real-time cost preview\n- Mileage calculation\n- Odometer reading support\n\n### History \u0026 Analysis\n- Beautiful entry cards\n- Detailed fuel history\n- Pull-to-refresh support\n- Smart delete functionality\n\n### Settings\n- Clear specific data types\n- Reset options\n- Data management tools\n\n## Technical Details\n\n- **Framework:** Flutter 3.32.1\n- **Language:** Dart\n- **Design:** Material 3\n- **Storage:** SharedPreferences\n- **Platforms:** Web, iOS, Android, macOS\n\n## Project Structure\n\n```\nlib/\n├── main.dart                    # App entry point\n├── models/fuel_entry.dart       # Data models\n├── screens/                     # UI screens\n│   ├── add_fuel_screen.dart\n│   ├── fuel_history_screen.dart\n│   └── settings_screen.dart\n└── services/                    # Business logic\n    └── fuel_storage_service.dart\n```\n\n## Design Highlights\n\n- Material 3 design system\n- Gradient backgrounds for visual appeal\n- Smooth animations and transitions\n- Consistent theming across all screens\n- Professional color palette\n- Responsive layout design\n\n## License\n\nMIT\n\n## Platform Support\n\nWeb, iOS, Android, macOS","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackshadowsoftwareltd%2Ffuel_cost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackshadowsoftwareltd%2Ffuel_cost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackshadowsoftwareltd%2Ffuel_cost/lists"}