# Play Store listing copy

Source-of-truth copy for the Google Play store listing. Update here, then
paste into Play Console.

## App name (max 30 chars)

```
Yorvana — Vehicle Service Log
```
(29 chars)

## Short description (max 80 chars)

```
Private, local-first service log. Track repairs and maintenance for your vehicle.
```
(80 chars)

Alternates:
```
Vehicle service book that stays on your device. No accounts, no tracking.
```
(73 chars)

```
A private maintenance log for your car. Records stay on your device.
```
(68 chars)

## Full description (max 4000 chars)

```
Yorvana is a private, local-first service book for your car, motorcycle, or any vehicle you want to keep maintenance history for.

Every record — oil changes, brake jobs, tyre swaps, MOTs, repairs, mileage — stays on your device, in a folder you choose, as plain JSON files you can read, back up, or move anywhere. No cloud account. No sign-in. No analytics. No ads.


WHY YORVANA

• Your data, your files. The vault lives in a folder on your device (or external SD card, USB drive, or any location Android lets you pick). Uninstall the app and your records stay.

• Human-readable format. Every vehicle and every service record is a small JSON file. Open them in any text editor. Back them up with any tool you already use.

• Quiet by design. No ads, no analytics, no behavioural tracking. Crash reporting and feedback submission are strictly opt-in.

• Built for the long term. Records are designed to outlive the app. If Yorvana ever disappears, your data does not.


WHAT YOU CAN TRACK

• Multiple vehicles (with Premium) — cars, bikes, vans, anything with an odometer
• Service and repair records with date, mileage, category, cost, and free-form notes
• Photo attachments — receipts, before/after, parts boxes
• Custom service categories you define yourself
• Per-vehicle totals: last service date, record count, lifetime spend


PRIVACY

• Vault data never leaves your device. Yorvana has no servers and stores nothing about you.
• Crash reporting (via Sentry) is opt-in and can be disabled at any time in Settings.
• Feedback you send from the in-app form is the only data we ever receive — and only when you explicitly tap submit.
• Full privacy policy: https://yorvana.app/privacy-policy/


FREE vs PREMIUM

• Free: one vehicle, unlimited service records, full feature access, no time limit.
• Premium (one-time purchase): unlimited vehicles.

There is no subscription. Buy once, keep forever.


REQUIREMENTS

• Android 8.0 (API 26) or newer
• A folder on your device (internal storage or external) to store the vault


OPEN, PORTABLE, YOURS

Yorvana treats your maintenance history the way you would treat a paper service book — something that belongs to you and the vehicle, not to whoever happens to run an app store this year. Pick a folder, log a service, and your records are there. That's it.
```
(approx 2200 chars — well under the 4000 limit)

## Tags (up to 5, picked from Play's curated list)

Best candidates in Play Console's tag picker:
- Vehicles / Cars
- Maintenance
- Service records / Service log
- Tracker / Personal tracker
- Mileage / Odometer

## App category

- **Auto & Vehicles**

## Contact details

- Support email: yorvana.app@gmail.com
- Website: https://yorvana.app/
- Privacy policy: https://yorvana.app/privacy-policy/

## Graphic asset checklist

All assets are uploaded in Play Console → Main store listing. Play caches
aggressively; allow up to 24h for changes to appear on the listing page.

### App icon — required

- **Size**: 512 × 512 px
- **Format**: 32-bit PNG with alpha
- **Max file size**: 1024 KB
- **Content**: keep the visual within the central ~80% so adaptive icon
  cropping (circle, squircle, teardrop) doesn't clip anything important.
  Match the in-app launcher (vector source in
  `app/src/main/res/drawable/ic_launcher_foreground.xml` over
  `ic_launcher_background.xml`).
- **Filename suggestion**: `play-icon-512.png`

### Feature graphic — required

- **Size**: 1024 × 500 px
- **Format**: 24-bit PNG (no alpha) or JPEG
- **Max file size**: 15 MB
- **Content**: shown at the top of the Play listing. Avoid putting critical
  text near the edges or center — Play crops it for different placements.
  Don't recreate the app icon at huge size; convey the app's character
  (a clean illustration of a vehicle service entry, or the wordmark on a
  branded background).
- **Filename suggestion**: `play-feature-1024x500.png`

### Phone screenshots — required (min 2, max 8)

- **Size**: between 320 px and 3840 px on either side; aspect ratio between
  16:9 and 9:16. Recommended: **1080 × 1920** or **1080 × 2400** PNG.
- **Format**: 24-bit PNG (no alpha) or JPEG
- **Max file size**: 8 MB each

Suggested screen order (each captures a different value prop):

1. **Vehicle list** showing one vehicle with last-service date and record
   count — frames the "service book" concept.
2. **Vehicle detail** with several records of different categories —
   shows the core feature.
3. **Add/edit record** form — proves how fast a log entry is.
4. **Categories settings** — shows the customisation angle.
5. **Settings → privacy** card (crash reporting toggle) — reinforces the
   privacy-first message.
6. **Paywall / upgrade dialog** — sets expectations honestly before install.

Generate the checked-in screenshots with the store screenshot task below.

### 7-inch tablet screenshots — optional but recommended

- **Size**: between 320 px and 3840 px on either side. Recommended:
  **1200 × 1920** PNG.
- **Format**: 24-bit PNG (no alpha) or JPEG
- **Count**: up to 8

### 10-inch tablet screenshots — optional

- **Size**: recommended **1920 × 1200** or **2560 × 1600** PNG.
- **Format**: 24-bit PNG (no alpha) or JPEG
- **Count**: up to 8

Tablet screenshots are generated by the same task as phone screenshots.

### Promo video — optional

- **Source**: YouTube URL (not a file upload)
- **Length**: 30 sec to 2 min recommended
- Skip for the first release.

## Asset storage

Keep the final exported PNGs in `distribution/store-assets/` (gitignored if
sources contain large layered files; commit only the export-ready PNGs):

```
distribution/
  store-assets/
    play-icon-512.png
    play-feature-1024x500.png
    screenshots/
      phone/
        screen_01_vehicle_list.png
        screen_02_vehicle_detail.png
        screen_03_add_record.png
        screen_04_categories.png
        screen_05_settings_privacy.png
        screen_06_paywall_dialog.png
      tablet-7/
        screen_01_vehicle_list.png
        ...
      tablet-10/
        screen_01_vehicle_list.png
        ...
```

## Generating screenshots

Run:

```bash
./gradlew generateStoreScreenshots -PscreenshotBuild
```

> [!IMPORTANT]
> Always use the `-PscreenshotBuild` flag for final marketing assets. It pivots
> the environment to the `release` build type, ensuring developer-only UI
> (like the debug settings panel) is excluded and high-fidelity rendering is
> used.

The task runs the instrumented store screenshot suite on Pixel 6, Nexus 7, and
Pixel Tablet Gradle Managed Devices, then copies 18 PNGs into
`distribution/store-assets/screenshots/{phone,tablet-7,tablet-10}/`.

The first run may take about 15 minutes while Android downloads and prepares
system images. Warm runs are typically around 5 minutes on a machine with KVM
available.