tankste/app

The mobile app of the tankste! project.

tankste! - App

Your open source fuel price app. The mission is to give you one app that you can use in all countries.

Availability

Flag	Country
🇩🇪	Germany
🇮🇸	Iceland

Data sources

The gas station data are hosted by our own backend. The backend gets the data from multiple data sources. We listing them on our website.

Get started

Configuration

All secrets are needs to be defined in config.json. At this moment we maintain an duplicated configuration for every platform. In future this should be auto-generated created by build scripts.

• Flutter: config.json
• Android: android/app/src/main/res/values/config.xml
• iOS: ios/Config.xcconfig

Development

Modules

Name	Description
app	App entry point
station	Station and gas price things
navigation	Routing utils and widgets
sponsor	Sponsor & payment stuff
report	Report wrong station data forms
map	Map utils
settings	User settings page
core	Generic core and util functions

Code quality

The tankste! project is based on a prototype code. The quality of the code has improved since then, but there is still a lot to do. We are on the right track. So please be patient or help us to improve the code.

Special thanks

• Tankerkönig that provides a free API for German gas stations. I would never have started the project without this offer.
• Tim Brückner from Teuer Tanken for your help to implement the MTS-K API.
• Sveinn Flóki Guðmundsson who builds Gasvaktin. That project provides a free API for Iceland gas stations.

License

Important

This license refers to the source code in this repository. The content provided by the app is protected by copyright.

tankste! - Your open source gas station mobile app. Copyright (c) 2023 Fabian Keunecke

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

app's Issues

[Bug]Map scrolling is laggy under iOS

Especially on Pro devices with "ProMotion" display

Sponsor page

Show needed and already spent money in app. Allow spending sponsor by in-app purchases.

Automate releasing

Building binaries and upload to given distribution platforms (github, play store, app store, f-droid, amazon store) should be automated.

Custom Price Alert

As a user I would like to set a specific price of the fuel of my choice in the app to get informed via push message if my price is reached, so that I can fuel up cheaply 😎

Too big price markers on iOS

The price markers are showed too big on certain iOS devices.

Example (iPhone XR):

Report wrong data

Using the data of the MTS-K require that we offer an report form, where users can submit wrong data.

Add report feature to the station details and send them to the backend.

Filter: Station companies

Allow filtering for station company/brand (ex: Shell, Hem, Aral, ...)

Allow location finding without play services

Android users without Google Play Service using this app too. The GPS location should work always here.

Improve prototyping code

Refactore the ugly code in main.dart file and split to multiple files and using a architecture.

Favorites stations

Add favorite list.

Allow mark gas stations as favorite. We should add a favorite filter for map and an separate favorite list.

Apple Maps on iOS platform

Use Apple Maps instead of Google Maps on iOS/iPadOS.

To be discuss: Should we always use Apple Maps or give we iOS users the choice to switch back to Google Maps in the settings?!

Show last price changes date on station details

Multiple users wants to see the latest price changes date on the station details page.

While our current data source Tankerkönig is not give us this data, we need to skip this until we have our own backend.

[Feature request] Add option to open route in Waze

Could be done on iOS and Android with a dedicated settings screen

Integrate mobile payment solution

Bertha had the option to pay right at the pump with your mobile phone.

At PACE, we offer open SDKs and APIs to integrate the same functionality for even more stations and much more payment schemes. The APIs could be used to implement the same user experience that Bertha offered.

Resources:

• API spec: https://developer.pace.cloud/api/fueling?version=2022-1
• Integration dochmentation: https://docs.pace.cloud
• Open source SDKs: https://github.com/pace

Handle multiple currencies

• Show currency given by backend
• Setting to select home currency (default by current language)
• Show also home currency price when other currency price is available

Connect to own backend

Fetch station & price data from our own server and remove the Tankerkönig stuff.

Backend repository: tankste/backend

More countries

Support more countries.

Add countries to PlayStore / AppStore. Data source will handle our backend.

Improve design and look & feel

Needs some discussion and a designer 😜.

• Better markers (rounded corners)
• Choose font(s)
• Define theme colors

Get design away from material design to get more generic (and don't look like an Android app).

Uncouple from Playservices, use Openstreetmap provider

Hello, promising project, nice.

I just tried to use it on LineageOs without installed Playservices. Unfortunately the App does not work without Playservices (no map). It would be really great to uncouple the app from it, e.g. use some Openstreetmapservice.

Release on F-Droid store

This app should also available on the F-Droid store.

Allow usage without GPS

Instead of using only the GPS location we should allow to check prices on other locations too by moving the map to them.

Nice to have: Would be nice if the last map position will restored on app launch.

Map provider option

Allow to change the map provider to available maps.

Rename the navigation-map provider option for a better user understanding.

Map loading hangs up on start sometimes

Many users reporting very slow or not working marker loading on map.

I see the same issue, that sometimes the map is hanging on initial state. The map shows the location and the loading bar is displayed. Nothing other is happening, until the map will moved.

For now, this issue was only seen on iOS.

Station list

Beside the map we should provide a list of stations that is sortable by distance or price.

The filters should apply here too.

Like Bertha (was only iOS) we should use some bottom sheet. For example something like Bar Finder.

Station price history chart / Chart von Preisverlauf

Ist es möglich, die App zu erweitern und einen Chart mit dem Preisverlauf einzubauen?

Filter: Station cards

Add filter for gas cards ("Tankkarte")

Map prices are not refreshing on get app to foreground

While the app is in background and the user bring them back to the active foreground app, the prices are not refreshing. The stations should be fetched again when the users resume the app.

Source badge

Using the data of MTS-K require that we show the data source.

An logo/brand image of the source should be showed on the station details page. On the footer or if we want to show the data mixed, we need to show them on every detail.

Release on Amazon App store

This app should also available on the Amazon app store.

Parsing error on coordinate integers

Like in #44 the API returns integer values when given value is a round one.

This also affect our fields latitude & longitude.

This cause in current versions (1.0.0 - 1.2.1) a parsing exception and no station markers are displayed on the map.

iOS: Location marker covers price badge

Today I saw this slightly bug that in some zoom level the iOS location dot overlaps the price badge so that this price is not readable anymore.

That maybe needs some UX improvement, maybe the price badge with a top arrow or something else.

Compare stations by navigation route

Users want to see a routing function, that compare the stations on the given route. Was implemented in Bertha's iOS app too.

Add (local) logging

• Add logger framework
• Log local
• Option to enable/disable logging (for the first version, a feature flag is enough)
• Disabled by default
• Allow to view the logs in the app
• Allow to share the logs by mail or any other apps

Payment

Allow pay fuels from the app.

This needs a lot of validation and should skip until most other feature will be done.

Dark Mode

Adding dark mode. Maps should be showed in light/dark mode too.

Allow user to change design modes in settings with following options:

• System (automatically depending on system)
• Light
• Dark

Loading progress & Error handling

1. Showing loading progress indicator.
2. Showing error

We should find some way to show errors on map.

Replace OpenStreetMap by MapLibre

Instead of build & using an OpenStreetMap library using the existing MapLibre project for open source behavior. This is already available for our required platforms (Android, iOS & Web)

Developer settings

Adding hidden developer settings.

Enable like Android OS settings, with x clicks on version.

Developer settings should contain a sub-settings page, that allow enable/disable new features.

This will hide new things for normal users, and allow us to test some new stuff in production environment.

now refreh when app is opened (again)

When i open the app again, there is no automatic refresh. i have to hit the "location" icon to let the app get my location and so do an update of the last shown prices.

Onboarding

Adding onboarding pages to setup the app.

1. Choose filters (gas type, ...) to customize app
2. Accept terms & privacy

anything else?

Car Play

Adding car play support.

Generate native configuration files

Generate native configuration files for Android & iOS.

The build scripts should read ./config.json and generate ./android/app/src/main/res/values/config.xml (Android) + ios/Config.xcconfig (iOS) files.

Translations

Add translations to support more languages.

Android Auto

Adding Android auto application. I have already started, but this needs more improvements on the usage flow & UX.

Parsing error on integers

When a gas station has a round integer number (like 3.000€) the API response them as integer (ex: 3) instead of double (ex: 3.0).

This cause in current versions (1.0.0 - 1.2.0) a parsing exception and no station markers are displayed on the map.