# GitHub Release v3.1.0 — Draft Notes

> **Status:** Ready for GitHub Release  
> **Tag:** `v3.1.0`  
> **Distribution:** Sideload via signed APK on GitHub Releases  
> **Product contract:** [user-business-logic.md](docs-user-business-logic.md) · **Privacy:** [privacy-policy.md](docs-privacy-policy.md) · **Build:** [release-build.md](docs-release-build.md)

Copy the block below into the GitHub Release description when publishing `v3.1.0`.

---

## Release title

```
ANP Fuel Prices v3.1.0 — Carousel, share, and navigation polish
```

---

## Release body (paste into GitHub)

<!-- begin:release-body -->

### ANP Fuel Prices v3.1.0

UI polish and contributor features: swipe between vehicles on Home, share the app, use GPS in the location picker, and back navigation on all secondary screens.

#### Highlights

- **Vehicle carousel on Home** — horizontal swipe between registered vehicles; tank cost card updates with selection
- **Use current location** — resolve municipality from device GPS in the location picker
- **Share app** — Settings share sheet with direct APK download link
- **Back navigation** — consistent back button on History, Prices, Search, Stations, Settings, and Location picker
- **Stale price warning** — banner when the latest ANP survey week may be outdated
- **Fixes** — first-launch sync reliability, system locale detection, vehicle station picker layout, Home scroll preservation

#### Install (sideload)

1. Download **`app-release.apk`** from the assets below.
2. **Upgrading from v3.0.0:** install over existing app — local data is preserved.

#### Full changelog

See [CHANGELOG.md](https://github.com/AlexandreZanata/brazil-fuel-prices/blob/08a54dc49c2e43a85aba56a7b56ae96d692cec61/CHANGELOG.md#310---2026-06-23) for the complete list of changes.

<!-- end:release-body -->

---

## Assets checklist

| Asset | File |
|-------|------|
| Release APK | `app/build/outputs/apk/release/app-release.apk` |
| Release AAB | `app/build/outputs/bundle/release/app-release.aab` |

## Publish steps

1. `./gradlew validateRepoBaseline test validateReleaseBuild`
2. Tag: `git tag -a v3.1.0 -m "ANP Fuel Prices v3.1.0 — Carousel, share, and navigation polish"`
3. Push when ready: `git push origin main && git push origin v3.1.0`