Skip to content

docs: store listing assets and texts ready for Google Play - #341

Merged
nofuturekid merged 3 commits into
mainfrom
docs/google-play-listing-assets
Nov 13, 2026
Merged

nofuturekid merged 3 commits into
mainfrom
docs/google-play-listing-assets

Conversation

@nofuturekid

@nofuturekid nofuturekid commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

What changed

Preparation of the Google Play listing for NOVA (decision in #328). No app code, build file or workflow changes; the only code touched is the screenshot render size in the test StoreScreenshots.

  • Screenshots. Google Play rejects phone screenshots whose longer side is more than twice the shorter one; the old 1078x2399 set (ratio 2.23) broke that. Now rendered at 1080x1920 (432x768 dp at 400 dpi, 9:16, the shape Google recommends for featuring). 1080x2160 would pass at exactly 2:1 with no margin. F-Droid has no size limit, so one size serves both. All six were re-rendered from current origin/main with the repository's Docker image (./scripts/store-screenshots.sh); site/index.html and docs/local-build.md follow the new size.
  • Icon. icon.png was RGB; it is now a 512x512 32-bit PNG with alpha, rendered from the new icon.svg (the launcher mark, full-bleed).
  • Feature graphic. New featureGraphic.png (1024x500, 24-bit, no alpha) and its source featureGraphic.svg: launcher mark, the website's colours and Geist font (SIL OFL), two app screenshots, NOVA for Unraid® and the short Lime attribution. No Unraid logo, stock image or other third-party mark. scripts/render-store-graphics.sh renders both PNGs reproducibly (rsvg-convert, magick, private fontconfig for Geist; two runs give identical bytes).
  • Texts. Play title, short and full description in docs/store/play-listing/, separate from F-Droid's fastlane texts (fdroiddata takes the listing from there, so Play-only wording cannot go there). Lime Technology's attribution is copied verbatim from the policy, short form at the top, long form at the end. Lengths: 16 / 74 / 1747 characters.
  • Declarations in docs/store/: Data safety (derived from the store flavor, with file:line), content rating, target audience and ads, and the App-access text with a clearly marked placeholder until the in-app demo mode exists.
  • ADR-0049 "Google Play as a third distribution channel" (store flavor is the Play build; existing release key given to Play App Signing before any open-testing or production rollout, separate upload key; demo mode for reviewers). ADR-0040 gets a dated amendment line; its text is not rewritten.

Odd things in the regenerated screenshots

  • Overview: the page ends in the middle of the Network card, and the Temperature card is below the fold; the layout has no Container and VM count cards in the visible part. With the shorter 9:16 frame fewer cards fit than before.
  • Container detail and Notifications: the sheet covers the tab bar (as on a device); notification cards have empty space below the text.
  • No clipped text, no empty states, dark theme everywhere.

Left out on purpose

  • App bundle build, signing, the demo mode, version bump (not in scope).
  • The in-app, README and policy attribution wording still differs from Lime's long form ("... endorsed by, or supported by Lime Technology"); docs/privacy/POLICY.md still mentions Play in the future tense. Both are separate changes (the in-app one is an APK change).
  • No CHANGELOG entry: nothing user-facing in the app changes.
  • Screenshots were re-rendered from origin/main of 2026-11-13 (includes the container search; the fixture describes a healthy server, so no needs-attention card). They still need a refresh if more screen changes land before the listing goes live.
  • featureGraphic.png now also appears in F-Droid's image folder, so F-Droid will show it. The two .svg sources sit next to it; F-Droid tooling was not available here to confirm that it ignores them.
  • The 4000-character limit for the full description is Play Console's own and is not printed on the Google pages read; 30 and 80 characters are.

Checks: ./scripts/local-ci.sh passed (generateApolloSources, lintDirectDebug, assembleDirectDebug, assembleRelease, testDirectDebugUnitTest).

Refs #328

🤖 Generated with Claude Code

@nofuturekid
nofuturekid force-pushed the docs/google-play-listing-assets branch from 39a6fde to 16a5742 Compare November 13, 2026 17:13
nofuturekid and others added 3 commits November 13, 2026 18:14
Screenshots: render at 1078x1918 (9:16). Google Play rejects a longer side of
more than twice the shorter one, which the old 1078x2399 size broke; F-Droid
has no such limit, so one size serves both. All six re-rendered from the
current origin/main; site/index.html gets the new image height.

Graphics: icon.png is now a 32-bit PNG with alpha, rendered from icon.svg;
featureGraphic.png (1024x500, no alpha) is new, drawn from featureGraphic.svg
with the launcher mark, the website's colours and its Geist font (SIL OFL) and
two app screenshots. scripts/render-store-graphics.sh renders both.

Texts and declarations under docs/store/: Play title, short and full
description (Lime Technology attribution verbatim, kept apart from F-Droid's
fastlane texts), Data safety answers derived from the store flavor with
file:line evidence, content rating, target audience and ads, and the App
access text with a marked placeholder until the in-app demo mode exists.

ADR-0047 records Google Play as a third channel (store flavor, existing
release key via Play App Signing with a separate upload key, demo mode for
reviewers); ADR-0040 gets a dated amendment.

Refs #328

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Render the store screenshots at 1080x1920 (432x768 dp at 400 dpi), the
size Google's listing assets page gives as the minimum for
screenshot-based promotion formats, from the rebased tree. Cite the
4000-character full description limit from Google's page and word the
data-safety encryption row as it appears in Google's help text.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Numbers 0047 and 0048 are reserved for other pull requests in flight.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@nofuturekid
nofuturekid force-pushed the docs/google-play-listing-assets branch from 16a5742 to 3fb7acf Compare November 13, 2026 17:15
@nofuturekid
nofuturekid merged commit 3fb7acf into main Nov 13, 2026
12 checks passed
@nofuturekid
nofuturekid deleted the docs/google-play-listing-assets branch November 13, 2026 17:23

This branch was successfully deployed

1 active deployment
github-pages — 3fb7acf7 Deployed Nov 13, 2026 by nofuturekid via deploy #12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant