Skip to content

docs assets app tutorial README

AlexandreZanata edited this page Nov 21, 2026 · 1 revision

Android app tutorial captures

Step-by-step screenshots of every Abastevo Android feature, taken on an emulator for the public tutorials (/como-usar/, guides and tools pages on landing/). Each folder is one feature; files are numbered in tutorial order (NN-step-slug.png).

File Purpose
manifest.json Machine-readable contract: capture conditions, every step with caption, the string resources and Compose sources that draw it, SHA-256 and landing pages
CAPTURE_CONTRACT.md The rules and the step-by-step procedure to recapture a screen when the app changes and to update the site page or field that shows it
FABLE_LANDING_POLISH_PROMPT.md Self-contained prompt for the landing update that uses these captures
<feature>/NN-*.png Lossless captures, opaque RGB, 1080 × 1920

Capture conditions (summary)

Debug build of the commit in manifest.json (capture.appSourceCommit), talking to https://abastevo.com.br, on a dedicated API 36 emulator (google_apis x86_64, Pixel 7 profile): system and app locale pt-BR, time zone America/Sao_Paulo, light theme, System UI demo mode (10:00, full battery, Wi-Fi only), wm size 1080x1920 at 420 dpi, on-screen keyboard disabled. Cities: São Paulo, SP and Sorriso, MT (map and route use Sorriso, where stations are spread out). Full list and the reproduction commands: CAPTURE_CONTRACT.md.

Privacy and data

  • Prices, station names and addresses are public ANP records for the survey week 8–14 Nov 2026 (plus three earlier weeks downloaded in the app).
  • Locations are synthetic emulator fixes on public city-centre points; no contributor GPS appears.
  • Signed-in steps used a throwaway username-only account that was deleted through the app at the end. Nothing was submitted to the community, forum or corrections queue: comment, topic and price screens are unsent drafts.
  • Screens protected with FLAG_SECURE (account key, account management, company mode, private quality reports) are never captured; their steps are described in text below.
  • contribute-price/05 and 06 show the emulator's built-in camera test scene, not a price board. These images are not OCR training data and must never be used as such.

Landing derivatives

The site must not hot-link these masters. Generate WebP derivatives that keep the stem, e.g. forum/05-write-comment.png → forum-05-write-comment-720w.webp, so tutorial_contract.py stale can find every page that shows a step (see the contract, rule C3).

Steps

Generated from manifest.json by python3 scripts/app_tutorial/tutorial_contract.py render-readme --write; do not edit this section by hand.

First open: terms and welcome

Accept the Terms of Use and Privacy Policy, read the welcome pages and choose how to find the city.

Landing pages: /como-usar/, /como-usar/conta-e-privacidade/, /termos/, /privacidade/

Step Image Caption
01 first-open/01-terms-gate.png On first open the app shows the Terms of Use and Privacy Policy before anything else.
02 first-open/02-accept-terms.png Tick the acceptance box; "Aceitar e continuar" only works after a real tick.
03 first-open/03-welcome.png Welcome page: the app shows the weekly ANP survey prices.
04 first-open/04-works-offline.png After the first sync the averages work without internet.
05 first-open/05-community-rules.png Contribution rules: photograph only public price boards and never invent prices.
06 first-open/06-choose-survey-week.png Choose which ANP survey week to download now, or skip and sync later.
07 first-open/07-find-city.png Find the city once with the device location, or choose it manually.

Choose the city

Pick a state and a municipality; the choice drives prices, stations and the map.

Landing pages: /como-usar/escolher-cidade/

Step Image Caption
01 choose-city/01-state-list.png The location picker lists the states; "Usar localização atual" detects the city instead. (sao-paulo-sp)
02 choose-city/02-search-state.png Type part of the state name to filter the list. (sao-paulo-sp)
03 choose-city/03-municipality-list.png After choosing the state, the municipalities appear in alphabetical sections. (sao-paulo-sp)
04 choose-city/04-search-municipality.png Search the municipality by name and tap it. (sao-paulo-sp)
05 choose-city/05-home-with-city.png The home screen now shows the city and the active survey week at the top. (sao-paulo-sp)

Fuel prices in the city

Read the ANP weekly average per fuel, sort the cards and switch to community prices.

Landing pages: /como-usar/precos-anp/, /guias/

Step Image Caption
01 fuel-prices/01-anp-average-cards.png Each card shows the ANP weekly average for a fuel, the number of surveyed stations and the source badge. (sao-paulo-sp)
02 fuel-prices/02-more-fuels.png Scroll for diesel S500/S10, GNV and GLP (13 kg). (sao-paulo-sp)
03 fuel-prices/03-home-shortcuts.png Shortcuts at the end of the list open the map, location, history, stations, vehicles and settings. (sao-paulo-sp)
04 fuel-prices/04-sort-prices.png "Filtros" lets you order prices by average, lowest or highest. (sao-paulo-sp)
05 fuel-prices/05-lowest-price.png With "Menor preço" each card shows the lowest surveyed price for that fuel. (sao-paulo-sp)
06 fuel-prices/06-community-prices.png The "Comunidade" toggle shows recent prices sent by drivers, kept apart from ANP data. (sorriso-mt)

Stations, station page and route

List surveyed stations for a fuel, search by name, open the station page, check ANP and community prices and start a route.

Landing pages: /como-usar/postos/, /como-usar/perfil-do-posto/, /como-usar/precos-do-posto/

Step Image Caption
01 stations/01-stations-for-fuel.png Tapping a fuel card opens the surveyed stations for that fuel, cheapest first. (sao-paulo-sp)
02 stations/02-station-cards.png Each station card shows the price, the brand, the public ANP address and the collection date. (sao-paulo-sp)
03 stations/03-choose-fuel.png Change the fuel from the selector at the top of the list. (sao-paulo-sp)
04 stations/04-search-by-name.png Type part of a station name to filter the list. (sao-paulo-sp)
05 stations/05-station-profile.png The station page shows the name, brand, address and the main actions. (sao-paulo-sp)
06 stations/06-community-and-anp-prices.png Choose a fuel chip; community prices (beta) and the ANP reference appear in separate cards. (sao-paulo-sp)
07 stations/07-anp-reference-price.png The ANP reference price always shows the collection date and the survey week. (sao-paulo-sp)
08 stations/08-fuel-quality.png "Consultar análises de qualidade" lists ANP quality sampling for the station, with its limits. (sao-paulo-sp)
09 stations/09-allow-location-for-route.png "Rota e ir" asks for the device location the first time (Android system dialog). (sao-paulo-sp; Android system screen)
10 stations/10-driver-experience.png Ratings and comments live in "Experiência dos motoristas"; this build shows the verification notice because station feedback is behind a feature flag. (sorriso-mt; signed in)
11 stations/11-suggest-correction.png "Sugerir correção" sends a name, address or permanent-closure correction for review. (sorriso-mt; signed in)
12 stations/12-represent-your-station.png "Entender como funciona" explains how a business can represent its station; it is not available in the beta. (sorriso-mt; signed in)

Offline map download

Download the offline map of the region so the map and routes work without internet.

Landing pages: /como-usar/offline-e-recuperacao/

Step Image Caption
01 map-offline/01-download-suggestion.png Opening the map of a city without a pack offers "Baixar mapa de Mato Grosso"; tap "Baixar". (sorriso-mt)
02 map-offline/02-download-progress.png Downloads shows the total progress and each package (region, world base map, coastlines); Wi-Fi only by default. (sorriso-mt)
03 map-offline/03-offline-pack-active.png When it finishes, the region pack is listed as active. (sorriso-mt)
04 map-offline/04-offline-map-ready.png Back on the map, streets and stations render from the offline pack. (sorriso-mt)

Map, station sheet and navigation

Explore stations on the map, filter by source and service, open a station, save it and navigate with turn-by-turn guidance.

Landing pages: /como-usar/postos/, /como-usar/offline-e-recuperacao/

Step Image Caption
01 map/01-stations-on-map.png The map shows fuel stations (orange) and EV chargers (teal) of the chosen city. (sorriso-mt)
02 map/02-map-filters.png "Filtros" chooses the city, the price source (ANP or community), the service (fuel or charging) and the product. (sorriso-mt)
03 map/03-station-sheet.png Tap a station to see its price with source, survey week and collection date. (sorriso-mt)
04 map/04-save-favorite.png "Salvar nos favoritos" keeps the station on this device. (sorriso-mt)
05 map/05-route-preview.png "Rota e ir" draws the route from the current position with time and distance. (sorriso-mt)
06 map/06-route-maneuvers.png "Manobras" lists every turn before you leave. (sorriso-mt)
07 map/07-turn-by-turn-navigation.png "Iniciar navegação" starts offline turn-by-turn guidance with voice, zoom and recentre controls. (sorriso-mt)
08 map/08-ev-charger-sheet.png EV chargers come from open sources; the sheet says ANP has no electricity tariffs. (sorriso-mt)

ANP survey weeks offline

Download earlier ANP survey weeks to read them offline and switch the active week.

Landing pages: /como-usar/semanas-anp/

Step Image Caption
01 survey-weeks/01-open-week-picker.png Tap the week chip at the top to open "Semana de pesquisa". (sorriso-mt)
02 survey-weeks/02-week-list.png Each week shows when it was updated and whether it is downloaded; "Baixar" saves it offline. (sorriso-mt)
03 survey-weeks/03-downloading-week.png The download imports the ANP data in place and can be cancelled. (sorriso-mt)
04 survey-weeks/04-week-downloaded.png Downloaded weeks are marked "Baixada". (sorriso-mt)
05 survey-weeks/05-older-week-active.png Tapping a downloaded week makes it active: the chip and the ANP reference line change. (sorriso-mt)

Price history

Compare the ANP average of a fuel across the downloaded weeks.

Landing pages: /como-usar/historico/

Step Image Caption
01 history/01-weekly-history.png "Histórico" charts the city average for each downloaded week, newest first. (sorriso-mt)
02 history/02-choose-fuel.png Change the fuel from the selector. (sorriso-mt)
03 history/03-diesel-s10-trend.png Diesel S10 history for the same weeks. (sorriso-mt)
04 history/04-tap-a-week.png Tap a bar to read that week's value. (sorriso-mt)

Vehicles, tank-fill cost and fuel log

Register up to three vehicles, see the cost to fill the tank, turn on price-drop alerts and log fill-ups.

Landing pages: /como-usar/veiculos/, /ferramentas/

Step Image Caption
01 vehicles/01-no-vehicles.png "Veículos" starts empty; the + button adds a vehicle. (sorriso-mt)
02 vehicles/02-name-and-tank.png Give the vehicle a name, choose the propulsion and type the tank capacity in litres. (sorriso-mt)
03 vehicles/03-fuel-and-price-alert.png Choose the fuel and the price reference, and switch on "Avisar quando o preço cair" for a local price-drop alert. (sorriso-mt)
04 vehicles/04-vehicle-saved.png The saved vehicle lists its fuel, tank size and price reference. (sorriso-mt)
05 vehicles/05-tank-fill-cost.png The home screen shows the cost to fill the tank at the cheapest surveyed station and a shortcut to go there. (sorriso-mt)
06 vehicles/06-fuel-log.png "Lançamentos" keeps the vehicle's fill-ups and expenses on the device. (sorriso-mt)
07 vehicles/07-add-fill-up.png Record litres, full or partial tank, total paid and odometer. (sorriso-mt)
08 vehicles/08-fuel-log-entry.png The entry appears in the log, stored locally. (sorriso-mt)

Settings

Sync, automatic downloads, language, search distance, data retention, storage and account links.

Landing pages: /como-usar/configuracoes/

Step Image Caption
01 settings/01-sync-and-preferences.png Sync now, change the survey week and choose background sync and Wi-Fi-only rules. (sorriso-mt)
02 settings/02-language-and-search-distance.png Pick the app language and the radius of "Mais barato perto de mim". (sorriso-mt)
03 settings/03-data-retention-and-city-directory.png Choose how many weeks of station data to keep and whether to keep the city's public directory offline. (sorriso-mt)
04 settings/04-storage-account-and-about.png See storage use, clear caches, open account and privacy, share the app and the official ANP page. (sorriso-mt)

Profile and tools

The Profile tab groups account, tools, references, Premium status and project contributors.

Landing pages: /como-usar/conta-e-privacidade/, /contribuidores/

Step Image Caption
01 profile-and-tools/01-tools-list.png "Ferramentas e referências": games, company mode, vehicles, settings and contributions. (sorriso-mt)
02 profile-and-tools/02-more-tools.png More tools: ANP history, surveyed stations, survey week, help and privacy. (sorriso-mt)
03 profile-and-tools/03-premium-status.png Premium shows the plan status; paid purchase is disabled in this version and never affects trust. (sorriso-mt; signed in)
04 profile-and-tools/04-project-contributors.png "Contribuidores do projeto" lists approved contributor profiles. (sorriso-mt; signed in)

Not captured (after step 04): "Modo empresa", "Entrar em uma empresa" and "Meus relatos privados" are FLAG_SECURE screens and are not captured.

Help, rules and privacy

Community rules, reporting and appeals, privacy summary and the terms accepted on this device.

Landing pages: /como-usar/ajuda-e-regras/, /como-usar/conta-e-privacidade/, /privacidade/, /termos/

Step Image Caption
01 help-and-privacy/01-help-and-community-rules.png "Ajuda e regras da comunidade": how to contribute well, community rules, reports and appeals. (sorriso-mt)
02 help-and-privacy/02-privacy-and-terms.png "Privacidade": full policy, web account deletion and the terms version accepted on this device. (sorriso-mt)

Free account: create and delete

Create a free account with only a username, see the signed-in profile and delete the account.

Landing pages: /como-usar/conta-e-privacidade/, /excluir-conta/

Step Image Caption
01 account/01-guest-profile.png As a guest, Profile offers "Entrar ou criar conta gratuita"; browsing never needs an account. (sorriso-mt)
02 account/02-signed-in-profile.png After creating the account (username only, no email or password) Profile shows "Conectado". (sorriso-mt; signed in)
03 account/03-after-account-deletion.png After "Gerenciar conta → Excluir minha conta → Sim, excluir" the app returns to guest mode. (sorriso-mt)

Not captured (after step 01): Type a username (3–20 letters and numbers, starting with a letter) and tap "Criar conta". The account screens are protected with FLAG_SECURE so the account key never appears in screenshots.

Not captured (after step 02): To delete: Profile → "Gerenciar conta" → "Excluir minha conta" → "Sim, excluir". This screen is FLAG_SECURE; the web path is /excluir-conta/.

Driver hub

Quick fuel and charging expenses, shifts and earnings for app drivers.

Landing pages: /como-usar/veiculos/

Step Image Caption
01 driver-hub/01-driver-hub.png "Central do motorista" shows the vehicle in use, quick expense entries and work tracking (Premium gate shown). (sorriso-mt; signed in)
02 driver-hub/02-shift-and-earnings.png "Turno e ganhos": start a shift with the odometer and record the day's net earnings. (sorriso-mt; signed in) Known issue: Shift and earnings labels are hard-coded Portuguese in DriverWorkScreen.kt (not string resources).

Community tab

Entry point for contributing prices, the forum and the community price feed.

Landing pages: /como-usar/comunidade/

Step Image Caption
01 community/01-community-tab.png "Comunidade" opens the price contribution, the Abastevo forum and the community price feed. (sorriso-mt; signed in)
02 community/02-community-prices-empty.png The feed filters by order and fuel; with no recent community price it invites a contribution. (sorriso-mt; signed in)

Forum: read, comment, post and block

Read editorial posts, filter by category, react and comment, write a topic and manage blocked users.

Landing pages: /como-usar/comunidade/, /como-usar/denunciar-abuso/

Step Image Caption
01 forum/01-forum-feed.png "Fórum Abastevo" lists posts with author, category and time; the pencil starts a new topic. (sorriso-mt; signed in)
02 forum/02-filter-by-category.png Category tabs filter the feed (fuels, e-mobility, traffic law…). (sorriso-mt; signed in)
03 forum/03-read-article.png Open a post to read it in full. (sorriso-mt; signed in)
04 forum/04-reactions-and-comments.png At the end: comment, like, dislike, share and the live comment list. (sorriso-mt; signed in)
05 forum/05-write-comment.png Write a comment of up to 280 characters and tap "Publicar" (new comments go through moderation). (sorriso-mt; draft, not submitted; signed in)
06 forum/06-new-topic-draft.png "Novo tópico": title, category and content. (sorriso-mt; draft, not submitted; signed in) Known issue: Category chips show internal codes (FUELS, ELECTRIC, TRAFFIC_RULES) instead of translated labels.
07 forum/07-new-topic-options.png Optional state, IBGE municipality, fuel and public name, then "Publicar tópico". (sorriso-mt; draft, not submitted; signed in) Known issue: Fuel chips show internal codes (GASOLINE_REGULAR, GASOLINE_PREMIUM).
08 forum/08-blocked-users.png "Gerenciar conta → Usuários bloqueados" lists blocked people; they are not notified and can be unblocked any time. (sorriso-mt; signed in)

Not captured (after step 07): On a topic or comment written by someone else, the ⋮ menu offers "Denunciar tópico", "Denunciar comentário", "Denunciar usuário" and "Bloquear usuário". Staging had only official editorial posts, which do not show the menu, so these dialogs were not captured.

Contribute a price with a photo

Choose the station, photograph the price board, review the reading or type the price, and send it to the community queue.

Landing pages: /como-usar/fotografar-preco/, /como-usar/minhas-contribuicoes/

Step Image Caption
01 contribute-price/01-choose-station.png "Colaborar com preço" first asks which station the price belongs to. (sorriso-mt; signed in)
02 contribute-price/02-search-station.png Search the station by name. (sorriso-mt; signed in)
03 contribute-price/03-station-selected.png With the station selected, tap "Fotografar preço". (sorriso-mt; signed in)
04 contribute-price/04-allow-camera.png Android asks for camera permission the first time. (sorriso-mt; Android system screen; signed in)
05 contribute-price/05-phone-camera.png The phone camera opens; photograph only the price board. (Emulator test scene — not a price board.) (sorriso-mt; Android system screen; emulator test scene; signed in)
06 contribute-price/06-photo-attached.png The photo is attached; crop to the frame or read it again. With no readable board the app asks you to type the prices. (sorriso-mt; emulator test scene; signed in)
07 contribute-price/07-type-price-and-send.png Add the fuel, type the price (R$ 6,25) and tap "Enviar"; blank fuels are not sent. (sorriso-mt; draft, not submitted; signed in) Known issue: Send button reads "Enviar 1 preços" (plural not handled).
08 contribute-price/08-my-contributions.png "Minhas contribuições" tracks sends, queue and cancellations on this device only. (sorriso-mt; signed in)

Offline games

Two offline mini-games with local records only.

Step Image Caption
01 games/01-games-hub.png "Games": play offline, even without an account; records stay on the device. (sorriso-mt)
02 games/02-second-game.png Fuel Run and accessibility options: mute, reduce motion, save battery. (sorriso-mt)
03 games/03-how-to-play.png Each game explains how to play before "Começar". (sorriso-mt)
04 games/04-match-over.png End of a match with the score and the local record. (sorriso-mt)

Fuel prices wiki

Source: AlexandreZanata/Abastevo @ e4a67580fc368a59bc1c0f1e0466fc011313f330

Clone this wiki locally