Eve library

Veritas News — Google Play Store Submission Preparation

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Task 23.16.2.2 | Comprehensive guide for submitting Veritas News to the Google Play Store.


Table of Contents#

  1. Executive Summary
  2. App Bundle Preparation
  3. Store Listing Metadata
  4. Store Listing Assets
  5. Data Safety Section
  6. Content Rating (IARC)
  7. News and Magazine Declaration
  8. In-App Billing and Subscriptions
  9. TWA Configuration
  10. Digital Asset Links
  11. Privacy and Account Deletion
  12. Review Preparation
  13. Pre-Submission Checklist
  14. Post-Submission Monitoring
  15. Appendices

1. Executive Summary#

Application Overview#

Field Value
App Name Veritas News
Package Name news.veritas.app
Platform Android (Phone + Tablet + Chromebook)
Technology Next.js PWA via Trusted Web Activity (TWA)
Min SDK Android 8.0 (API 26)
Target SDK Android 15 (API 35)
Category News & Magazines
Content Rating Teen (IARC)
Pricing Free with In-App Purchases (auto-renewable subscriptions)
Languages English, Twi, Ewe, Ga, Hausa, Dagbani

Submission Strategy#

Veritas News is a Next.js Progressive Web App that will be published to Google Play using Trusted Web Activity (TWA). TWA wraps the PWA in a thin Android shell that launches the website in Chrome without a browser toolbar, providing a native-like experience. This approach is preferred over a Capacitor/Cordova wrapper because:

  • Smaller app size (TWA shell is ~2 MB vs 15-30 MB for Capacitor)
  • Automatic content updates (no release needed for web changes)
  • Shares Chrome cookies/storage (seamless web-to-app transition)
  • OAuth requests work natively (unlike WebView)
  • Full web platform API access (push notifications, service workers)

For iOS, a Capacitor wrapper is used instead (TWA is Android-only). See ios-app-store-submission.md for iOS details.

Critical Deadlines#

Deadline Requirement
August 31, 2025 New apps/updates must target API 35 (Android 15)
August 31, 2025 All apps must use Billing Library 7.0.0+
August 2025 Billing Library 8.0 mandatory for new apps
February 2026 Billing Library 8.0 mandatory for all existing apps
Ongoing News/magazine declaration required for all news apps
Rolling through 2026 Developer identity verification required globally

2. App Bundle Preparation#

2.1 TWA vs Native Wrapping Decision#

Criteria TWA Capacitor/Cordova
App Size ~2 MB ~15-30 MB
Content Updates Automatic (web deploys) Requires app update release
OAuth Support Full (Chrome context) Limited (WebView blocks some)
Offline Support Service Worker based Capacitor plugins + SW
Native API Access Web APIs only Full native access
Push Notifications Web Push API FCM + native
Play Store Compliance Excellent Good
Chrome Required Yes (v72+) No (embedded WebView)

Decision: TWA — The Veritas PWA already has service workers, web push, and offline caching. TWA provides the best user experience with minimal overhead.

2.2 TWA Build Tools#

Bubblewrap (Google's official CLI tool) generates the Android project:

bash
# Install Bubblewrap
npm install -g @anthropic-ai/bubblewrap

# Initialize TWA project
bubblewrap init --manifest=https://veritas.news/manifest.json

# Build AAB (Android App Bundle)
bubblewrap build

Alternative: PWABuilder (Microsoft) — Web-based tool at https://pwabuilder.com that generates the Android Studio project from a PWA URL.

2.3 Android App Bundle (AAB)#

All apps submitted to Google Play must use the AAB format (not APK). AABs allow Google Play to generate optimized APKs for each device configuration.

Build Output:

text
apps/veritas/android/
├── app/
│   ├── build.gradle
│   ├── src/
│   │   └── main/
│   │       ├── AndroidManifest.xml
│   │       └── res/
│   │           ├── values/
│   │           │   ├── strings.xml
│   │           │   └── colors.xml
│   │           ├── mipmap-xxxhdpi/
│   │           │   └── ic_launcher.png
│   │           └── drawable/
│   │               └── splash.xml
│   └── release/
│       └── app-release.aab    # Signed app bundle
├── build.gradle
├── settings.gradle
└── gradle.properties

2.4 Play App Signing#

Google Play App Signing is mandatory when using AAB format:

Key Type Purpose Managed By
Upload Key Signs the AAB before uploading Developer
App Signing Key Signs the final APKs delivered to users Google

Setup Steps:

  1. Enroll in Play App Signing in Play Console (Setup > App signing)
  2. Generate an upload key locally: keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  3. Sign the AAB with the upload key
  4. Upload the signed AAB to Play Console
  5. Google re-signs with the app signing key for distribution

Important: The SHA-256 fingerprint from Play Console (not from your local keystore) must be used in the Digital Asset Links file.

2.5 Target SDK Requirements#

Setting Value
minSdkVersion 26 (Android 8.0)
targetSdkVersion 35 (Android 15)
compileSdkVersion 35

2.6 Nx Integration#

json
{
  "targets": {
    "build:android": {
      "executor": "nx:run-commands",
      "options": {
        "commands": [
          "bubblewrap build --skipPwaValidation",
          "cp app-release-signed.aab dist/"
        ],
        "cwd": "apps/veritas/android"
      }
    }
  }
}

3. Store Listing Metadata#

3.1 App Identity#

Field Value Limit
App Name Veritas News 30 chars
Package Name news.veritas.app —
Developer Name Veritas News Ltd —

3.2 Short Description#

text
AI-powered news from Ghana with fact-checking, bias scoring, and six languages.

Character count: 78 (within 80 limit)

3.3 Long Description#

text
Veritas News is Ghana's leading AI-powered news agency delivering breaking
news, fact-checking, and multimedia content across six Ghanaian languages.

★ TRUSTED NEWS FROM GHANA'S TOP SOURCES
Browse breaking news from GhanaWeb, Joy Online, Citi Newsroom, Daily Graphic,
and 3News. Our AI-powered curation ensures you see the stories that matter
most, verified for accuracy and presented without bias.

★ FACT-CHECKING AT YOUR FINGERTIPS
Every article is analyzed for factual accuracy using advanced NLP and AI. See
claim verification scores, source reliability ratings, and detailed
fact-check breakdowns. Know what's true before you share.

★ BIAS TRANSPARENCY
Our proprietary bias analysis scores every article on a political spectrum,
helping you understand media perspectives. See source-level bias ratings,
ownership transparency reports, and multi-dimensional analysis covering NPP,
NDC, and independent perspectives.

★ AI-POWERED SUMMARIES
Get concise, AI-generated summaries of complex stories. Perfect for staying
informed on the go. Available in all six supported languages.

★ SIX GHANAIAN LANGUAGES
Read the news in your preferred language:
• English — Full coverage
• Twi (Akan) — Ashanti and Eastern regions
• Ewe — Volta region
• Ga — Greater Accra
• Hausa — Northern Ghana
• Dagbani — Northern Ghana

★ MULTIMEDIA CONTENT
Watch AI-generated news videos, listen to text-to-speech narrations in local
languages, and explore interactive data visualizations.

★ PERSONALIZED FEED
Customize your news feed by topics, sources, and preferred language. Set
custom alerts for breaking news in categories you care about: Politics,
Business, Sports, Entertainment, Technology, and Health.

★ PREMIUM FEATURES
Upgrade for unlimited reading, ad-free browsing, advanced search, offline
reading, article exports, developer API access, and priority support.

★ SUBSCRIPTION OPTIONS
• Free — 10 articles/day, basic fact-checking, reading statistics
• Premium — GH₵49.99/month — Unlimited everything, 14-day free trial
• Student — GH₵24.99/month — 50% off with student verification
• Family — GH₵74.99/month — Share with up to 6 family members

★ PRIVACY FIRST
Built in compliance with Ghana's Data Protection Act (Act 843). Your data is
protected with AES-256 encryption. Full data export and account deletion
available at any time.

★ REGULATORY COMPLIANCE
Adheres to the National Media Commission (NMC) Act 449, Ghana Journalists
Association (GJA) Code of Ethics, and Ghana Electoral Commission coverage
guidelines. All AI-generated content is clearly disclosed.

Download Veritas News and join Ghanaians who demand truth in their news.

Character count: ~2,040 (within 4,000 limit, in the optimal 1,000-2,500 range)

3.4 Contact Details#

Field Value
Email support@veritas.news
Phone +233-XXX-XXX-XXXX
Website https://veritas.news
Privacy Policy https://veritas.news/privacy

3.5 App Category#

Field Value
Category News & Magazines
Content Rating Teen
Target Audience 13+
Contains Ads Yes
In-App Purchases Yes

3.6 Availability#

Field Value
Countries All countries (or Ghana priority)
Primary Market Ghana
Price Free
Managed Publishing Enabled (manual release control)

4. Store Listing Assets#

4.1 App Icon#

Asset Dimensions Format Notes
App Icon 512 x 512 px 32-bit PNG With alpha channel

Design Requirements:

  • Must be 512x512 exactly
  • 32-bit PNG with alpha channel
  • Must not duplicate the feature graphic
  • Should be recognizable at small sizes
  • Must represent the app accurately

Current Assets:

  • public/icon-512.png (512x512) — Can be used directly

4.2 Feature Graphic#

Asset Dimensions Format Notes
Feature Graphic 1024 x 500 px JPG or 24-bit PNG No transparency

Design Requirements:

  • Exactly 1024 x 500 pixels
  • No alpha channel (no transparency)
  • Maximum file size: 1 MB
  • Center key visuals (brand, tagline) to avoid cutoff
  • Avoid fine text details
  • Must not include performance claims, awards, or CTAs
  • Localize for different markets

Content Restrictions — Do NOT Include:

  • Rankings or performance metrics ("Best," "#1," "Top")
  • Accolades or awards
  • User testimonials
  • Price or promotional info ("Discount," "Free," "Sale")
  • Call-to-actions ("Download now," "Install now")
  • Store performance stats ("Million Downloads")

Recommended Design:

  • Veritas brand colors: Primary blue (#2563eb), Ghana flag accents
  • Tagline: "Ghana's AI-Powered Truth Agency"
  • Visual showing news headlines with fact-check indicators
  • Dark/light theme variants if localizing

Required Action: Create a 1024x500 feature graphic.

4.3 Screenshots — Phone#

Dimensions: 1080 x 1920 px (portrait) or 1440 x 2560 px Quantity: Minimum 2, maximum 8 Format: 24-bit PNG or JPEG, no alpha

Recommended Screenshot Set:

# Screen Caption
1 Home Feed "Breaking news from Ghana's trusted sources"
2 Article with Fact Check "AI fact-checking for every article"
3 Bias Analysis "Transparent bias scoring across the spectrum"
4 Language Switcher "Read news in six Ghanaian languages"
5 AI Summary "AI-powered summaries for news on the go"
6 Dark Mode "Comfortable reading in dark mode"
7 Subscription Plans "Choose your Veritas experience"
8 Search Results "Find any story with advanced search"

Note: The first 2 screenshots appear in search results — they are the most critical for conversion. Lead with the home feed and fact-checking feature.

Device Dimensions Quantity
7" Tablet 1200 x 1920 px 4 minimum
10" Tablet 1800 x 2560 px 4 minimum

Google requires at least 4 tablet screenshots to classify the app as "tablet-optimized." This improves discoverability on tablets and Chromebooks.

Specification Value
Source YouTube video URL
Duration 30 seconds to 2 minutes
Content Actual in-app footage

A YouTube video demonstrating the app experience. Show: home feed, article reading, fact-check scores, language switching, AI summaries, and dark mode.

4.6 Current Asset Inventory#

Asset Status
App Icon 512x512 Available (public/icon-512.png)
Feature Graphic NEEDED (1024x500)
Phone Screenshots NEEDED (1080x1920 or 1440x2560, min 2)
Tablet Screenshots NEEDED (1200x1920 / 1800x2560, min 4 each)
Video Preview NEEDED (YouTube URL)

5. Data Safety Section#

5.1 Overview#

The Data Safety section in Google Play Console requires disclosure of all data collection, use, and sharing practices. This declaration must cover the app's own code AND all third-party SDKs/libraries.

5.2 Security Practices#

Question Answer
Is data encrypted in transit? Yes
Can users request data deletion? Yes
Data deletion URL https://veritas.news/account/delete
Does the app follow Google Play's Families policy? No (not targeting children)

5.3 Data Types Collected#

Location#

Data Type Collected Shared Purpose Optional
Approximate location No No — —
Precise location No No — —

Personal Info#

Data Type Collected Shared Purpose Optional
Name Yes No Account management No
Email address Yes No Account, authentication No
Phone number Yes Yes* Payment (mobile money) Yes
User IDs Yes No Account management No
Address No No — —
Race/ethnicity No No — —
Political/religious beliefs No No — —
Sexual orientation No No — —

*Phone number shared with payment providers (MTN MoMo, Vodafone Cash, AirtelTigo) for transaction processing.

Financial Info#

Data Type Collected Shared Purpose Optional
Payment info Yes Yes* Subscription billing Yes
Purchase history Yes No Subscription mgmt No
Credit score No No — —

*Payment info shared with Stripe and mobile money providers for billing.

App Activity#

Data Type Collected Shared Purpose Optional
App interactions Yes No Analytics, personalization No
In-app search Yes No Personalization No
Other user content Yes No Tips/feedback Yes

App interactions detail: Article reads, fact check views, bias analysis views, AI summary requests, article exports — tracked daily per user for subscription usage enforcement and content personalization.

Web Browsing#

Data Type Collected Shared Purpose Optional
Web browsing history No No — —

App Info and Performance#

Data Type Collected Shared Purpose Optional
Crash logs Yes No App stability No
Diagnostics Yes No Performance No
Other performance data Yes No Monitoring No

Device or Other IDs#

Data Type Collected Shared Purpose Optional
Device or other IDs No No — —

Note: As of April 10, 2025, Android ID is no longer regarded as a persistent device identifier. Veritas does not collect GAID (Google Advertising ID) or any device identifiers.

5.4 Data Purposes#

For each collected data type, the following purposes apply:

Purpose Applicable Data Types
App functionality Name, email, phone, payment, user ID
Analytics App interactions, diagnostics, crash logs
Personalization App interactions, in-app search
Account management Name, email, user ID, purchase history
Fraud prevention/security/compliance Email, user ID

5.5 Third-Party Data Sharing Summary#

Third Party Data Shared Purpose
Stripe Email, payment method Subscription billing
MTN MoMo Phone number, amount Mobile payment
Vodafone Cash Phone number, amount Mobile payment
AirtelTigo Phone number, amount Mobile payment
Google Play Subscription status IAP management

No data shared with:

  • Third-party analytics (self-hosted)
  • Advertising networks (self-served ads)
  • Data brokers
  • Social media platforms

6. Content Rating (IARC)#

6.1 Questionnaire Category#

App Category: News / Information

6.2 Questionnaire Responses#

Violence#

Question Answer
Does the app contain depictions of violence? Yes
Is the violence realistic? Yes
Frequency of realistic violence? Infrequent
Is there blood or gore? No
Is violence against identifiable characters? No
Is violence rewarded or shown in a positive light? No

Justification: News articles may contain descriptions or photographs of real-world violence (crime reports, conflict coverage, accident reports). This is journalistic reporting, not entertainment. Veritas adds content warnings for sensitive articles.

Sexuality / Nudity#

Question Answer
Does the app contain sexual content or nudity? No
Does the app contain suggestive content? No

Language#

Question Answer
Does the app contain profane language? Infrequent
Is the language used in a harmful/derogatory context? No

Justification: Quoted speech in news articles may occasionally contain profane language. This is reproduced as part of factual reporting.

Substances#

Question Answer
Does the app reference or depict alcohol, tobacco, drugs? Infrequent
Is substance use shown in a positive light? No

Justification: News reporting may reference substance-related events (drug seizures, alcohol-related incidents). This is factual reporting.

Gambling#

Question Answer
Does the app contain gambling? No
Does the app contain simulated gambling? No

User-Generated Content#

Question Answer
Does the app allow users to create/share content with others? No
Does the app support user-to-user communication? No

Note: The tips/feedback feature allows one-way anonymous submissions to the editorial team. It does not constitute user-generated content distribution or user-to-user communication.

Fear / Horror#

Question Answer
Does the app contain fear-inducing content? Infrequent

Justification: News coverage of natural disasters, accidents, or crime may include disturbing imagery. Content warnings are provided.

Advertising#

Question Answer
Does the app contain advertising? Yes
Are ads age-appropriate? Yes

6.3 Expected IARC Rating#

Rating Authority Expected Rating
IARC Generic Teen (13+)
ESRB Teen
PEGI PEGI 12
USK USK 12
ACB PG
ClassInd 12
GRAC 12

7. News and Magazine Declaration#

7.1 Overview#

Google Play requires all news and magazine apps to complete a mandatory declaration. Non-compliance blocks app updates and can lead to removal.

7.2 Declaration Fields#

Entity Type#

Field Value
Entity Type Commercial / Private

Veritas News Ltd is a private commercial entity, not a state/public or community/not-for-profit organization.

Editorial Guidelines#

Field Value
Editorial Standards https://veritas.news/ethics
Content Source Aggregated from licensed Ghanaian publishers + AI enrichment
Fact-Checking Policy https://veritas.news/fact-check-policy
Corrections Policy https://veritas.news/corrections

Editorial Standards Summary:

Veritas News adheres to:

  • National Media Commission (NMC) Act 449 — 14 content principles
  • Ghana Journalists Association (GJA) Code of Ethics — 24 articles
  • Ghana Electoral Commission election coverage guidelines
  • AI content disclosure 4-level framework (Generated/Assisted/Enhanced/Curated)
  • Source attribution for all aggregated articles
  • Automated NMC compliance checking with violation detection
  • Source reliability grading (A-F scale)

Awards and Recognition#

Field Value
Awards N/A (new publication)

Content Ownership#

Field Value
Original Content AI-generated summaries, fact-checks, bias analyses
Aggregated Content News articles from Ghanaian publishers via RSS
Attribution Full source attribution with links to originals

Contact Information#

Field Value
Contact URL https://veritas.news/contact
In-App Contact Settings > Contact Us
Email editorial@veritas.news
Phone +233-XXX-XXX-XXXX

Important: The contact information must be discoverable within the app AND match the Play Console declaration.

7.3 Article Requirements#

All articles displayed in the app must have:

  • Clear publication date
  • Source attribution (original publisher or author)
  • Category classification

Veritas articles include all of these plus:

  • Fact-check score
  • Bias analysis score
  • AI disclosure level
  • NMC compliance status

8. In-App Billing and Subscriptions#

8.1 Billing Library Version#

Requirement Value
Current Required Billing Library 7.0.0+
New Apps (Aug 2025) Billing Library 8.0
All Apps (Feb 2026) Billing Library 8.0

8.2 Subscription Configuration#

Subscription Name: Veritas News Access

Each subscription has multiple base plans (monthly and yearly) with optional offers (free trials, introductory pricing).

8.2.1 Premium Subscription#

Base Plan Period Price (GHS) Price (USD) Price (EUR) Price (GBP) Trial
Monthly 1 Month GH₵49.99 $9.99 €8.99 £7.99 14 days
Yearly 1 Year GH₵499.99 $99.99 €89.99 £79.99 14 days

Features: Unlimited reading, ad-free, AI summaries, offline access, advanced search, article exports, API access, priority support, custom alerts, unlimited bookmarks, early access.

8.2.2 Student Subscription#

Base Plan Period Price (GHS) Price (USD) Price (EUR) Price (GBP) Trial
Monthly 1 Month GH₵24.99 $4.99 €4.49 £3.99 14 days
Yearly 1 Year GH₵249.99 $49.99 €44.99 £39.99 14 days

Features: Same as Premium. Requires student verification (educational email or SheerID).

8.2.3 Family Subscription#

Base Plan Period Price (GHS) Price (USD) Price (EUR) Price (GBP) Trial
Monthly 1 Month GH₵74.99 $14.99 €13.49 £11.99 14 days
Yearly 1 Year GH₵749.99 $149.99 €134.99 £119.99 14 days

Features: Same as Premium. Up to 6 family members with individual profiles.

8.3 Google Play Commission#

Scenario Commission
Auto-renewable subscriptions (all) 15%
First $1M annual (reduced-fee tier) 15%
Above $1M annual 30%

Note: Google charges only 15% on all auto-renewable subscriptions from day 1, compared to Apple's 30% for the first year. This is a significant cost advantage.

Revenue Comparison (Google vs Apple):

Plan Monthly Price Google Cut (15%) Apple Cut (30%) Google Net Apple Net
Premium (GHS) GH₵49.99 GH₵7.50 GH₵15.00 GH₵42.49 GH₵34.99
Premium (USD) $9.99 $1.50 $3.00 $8.49 $6.99
Student (GHS) GH₵24.99 GH₵3.75 GH₵7.50 GH₵21.24 GH₵17.49
Family (GHS) GH₵74.99 GH₵11.25 GH₵22.50 GH₵63.74 GH₵52.49

8.4 Alternative Billing (US Market)#

As of October 29, 2025, Google no longer requires Google Play Billing for apps distributed in the US. Developers can:

  • Use alternative in-app payment methods
  • Communicate with users about alternatives
  • Set prices independently

Deadline: January 28, 2026 — developers using alternative billing must enroll in Google's program. Google intends to assess a service fee in the future.

8.5 Subscription Implementation for TWA#

For TWA-based apps, subscriptions can be handled via:

  1. Google Play Billing (recommended): Requires a thin Kotlin/Java layer to bridge the web app to the Billing Library. The TWA shell exposes a JavaScript interface to the billing API.
  2. Web-based billing: Handle subscriptions entirely through the web app using Stripe and mobile money providers. This avoids Google's commission but may reduce trust (users expect Play Store billing).
  3. Hybrid: Google Play Billing for Google Play distribution, web billing for direct installs or web access.

Recommended approach: Use Google Play Billing for subscriptions within the Android app. Use web billing (Stripe + mobile money) for subscriptions initiated on the web. Sync subscription status between both systems via the Veritas API.


9. TWA Configuration#

9.1 Bubblewrap Configuration#

When running bubblewrap init, it reads the PWA manifest and generates configuration. Key values to set:

text
? Domain: veritas.news
? Launch URL: /
? App name: Veritas News
? Short name: Veritas
? App version name: 1.0.0
? App version code: 1
? Package ID: news.veritas.app
? Display mode: standalone
? Status bar color: #2563eb
? Navigation bar color: #ffffff
? Background color: #ffffff
? Theme color: #2563eb
? Splash screen fade-out duration: 300
? Enable notifications: Yes
? Min SDK: 26
? Signing key alias: upload
? Signing key full name: Veritas News Ltd
? Signing key organization: Veritas News
? Signing key country: GH

9.2 AndroidManifest.xml Key Entries#

xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="news.veritas.app">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

    <application
        android:label="Veritas News"
        android:icon="@mipmap/ic_launcher"
        android:theme="@style/AppTheme"
        android:allowBackup="false"
        android:networkSecurityConfig="@xml/network_security_config">

        <activity
            android:name="com.nicholasgcoles.veritas.LauncherActivity"
            android:exported="true"
            android:launchMode="singleTask">

            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>

            <!-- Deep links -->
            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="https"
                      android:host="veritas.news" />
            </intent-filter>
        </activity>
    </application>
</manifest>

9.3 TWA Offline Behavior#

When offline, the TWA displays whatever the service worker provides. The Veritas PWA service worker should:

  1. Cache the app shell (HTML, CSS, JS) for instant offline loading
  2. Cache previously viewed articles for offline reading
  3. Show an offline banner with cached article list
  4. Queue actions (bookmarks, preferences) for sync when online

9.4 Chrome Requirement#

TWA requires Chrome 72+ on the device. Fallback behavior:

  • If Chrome is not installed or is too old, the app opens in a CustomTabsIntent (Chrome Custom Tab) which shows a minimal browser toolbar
  • This is acceptable but slightly less native-feeling
  • Over 95% of Android devices in Ghana have Chrome 72+ installed

10.1 Overview#

Digital Asset Links establish a verified connection between the Veritas website and the Android app. This is critical for TWA — without it, Chrome shows a browser toolbar instead of fullscreen mode.

10.2 assetlinks.json#

Host this file at https://veritas.news/.well-known/assetlinks.json:

json
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "news.veritas.app",
      "sha256_cert_fingerprints": ["PLAY_CONSOLE_SHA256_FINGERPRINT_HERE"]
    }
  }
]

10.3 Setup Steps#

  1. Get SHA-256 fingerprint from Play Console:

    • Navigate to: Play Console > Setup > App signing
    • Copy the SHA-256 fingerprint from the "App signing key certificate"
    • Do NOT use your upload key fingerprint
  2. Deploy the file:

    • Must be served at the exact path: /.well-known/assetlinks.json
    • Must use Content-Type: application/json
    • Must be accessible without redirects
    • Must be publicly accessible (no authentication)
    • Must use HTTPS
  3. Validate the file:

    • Use Google's validation tool: https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://veritas.news&relation=delegate_permission/common.handle_all_urls
    • Or use Android Studio's App Links Assistant

10.4 Next.js Configuration#

Add a rewrite in next.config.mjs to serve the assetlinks.json:

javascript
async rewrites() {
  return [
    {
      source: '/.well-known/assetlinks.json',
      destination: '/api/assetlinks',
    },
  ];
}

Or serve as a static file at public/.well-known/assetlinks.json.

10.5 Common Issues#

Issue Solution
Browser toolbar showing Wrong SHA-256 fingerprint (use Play Console)
404 on assetlinks.json Check file path and hosting
Redirect on assetlinks.json Must be served without redirects
Wrong Content-Type Must be application/json
Using upload key fingerprint Use app signing key from Play Console

11. Privacy and Account Deletion#

11.1 Privacy Policy Requirements#

Requirement Status
Privacy policy URL in Play Console https://veritas.news/privacy
Privacy policy accessible in-app Settings > Privacy Policy
Publicly accessible URL Yes (no auth required)
Non-geofenced Yes
Not a PDF Yes (HTML page)
Non-editable format Yes (not a wiki)

11.2 Account Deletion Requirements#

Google requires account deletion capability since December 2023:

Requirement Implementation
In-app deletion Settings > Account > Delete Account
Web deletion https://veritas.news/account/delete
Full data deletion Cascading deletion via DPA endpoints
Data retention disclosure Privacy policy details retention periods
Confirmation before deletion In-app dialog with warning

Deletion Flow:

text
1. User taps "Delete Account" in Settings
2. Confirmation dialog explains consequences
3. User re-authenticates (password or biometric)
4. API call: DELETE /data-protection/users/:userId
5. All personal data deleted immediately
6. Anonymized aggregate data retained per Ghana DPA Section 65
7. Active subscription cancelled (with Apple/Google notification)
8. User signed out and redirected to welcome screen

11.3 Data Retention Disclosure#

Data Category Retention Period
Account data Until account deletion
Subscription records 7 years (financial compliance)
Payment transactions 7 years (financial compliance)
Usage analytics 2 years (then aggregated/anonymized)
Crash/diagnostic logs 90 days
Tips/feedback Until editorial resolution
Anonymized aggregates Indefinite (per Ghana DPA Section 65)

12. Review Preparation#

12.1 Pre-Review Checklist#

  • AAB uploads and processes successfully in Play Console
  • All store listing metadata entered
  • Feature graphic uploaded
  • Minimum 2 phone screenshots uploaded
  • Privacy policy URL valid and accessible
  • Data Safety section completed
  • IARC content rating questionnaire completed
  • News/magazine declaration submitted
  • In-app billing configured and tested
  • Digital Asset Links deployed and validated
  • Account deletion flow functional
  • Contact information matches in-app and Play Console

12.2 Common Rejection Reasons and Mitigations#

Rejection 1: Missing or Invalid Privacy Policy#

Risk: Most common rejection reason.

Mitigation:

  • Privacy policy URL is publicly accessible
  • Not behind authentication or geo-restrictions
  • Covers all data types declared in Data Safety section
  • Available in English (matches app's primary language)

Rejection 2: Data Safety Discrepancies#

Risk: Data Safety declarations don't match actual data practices.

Mitigation:

  • Audit all API endpoints for data collection
  • Declare all third-party SDK data practices
  • Include payment provider data sharing
  • Keep declarations updated with app changes

Rejection 3: Content Policy Violation#

Risk: News content flagged as inappropriate.

Mitigation:

  • NMC compliance checking ensures content standards
  • Content warnings for sensitive articles
  • Age-appropriate IARC rating (Teen)
  • Editorial guidelines publicly available

Rejection 4: TWA/PWA Quality Issues#

Risk: App opens with browser toolbar or lacks offline functionality.

Mitigation:

  • Digital Asset Links correctly configured
  • SHA-256 fingerprint from Play Console (not upload key)
  • Service worker provides offline experience
  • App shell cached for instant loading

Rejection 5: Metadata Policy Violation#

Risk: Store listing contains prohibited content.

Mitigation:

  • No performance claims ("Best," "#1," "Top")
  • No call-to-actions in feature graphic
  • No misleading screenshots
  • Keywords are accurate and relevant

12.3 Testing Tracks#

Track Purpose
Internal Testing Developer team validation (up to 100)
Closed Testing Selected beta testers
Open Testing Public beta (optional)
Production Full public release

Recommended Flow:

  1. Upload to Internal Testing first
  2. Validate TWA functionality on multiple devices
  3. Promote to Closed Testing with Ghana-based testers
  4. Fix any issues found
  5. Promote to Production with Managed Publishing (manual release)

13. Pre-Submission Checklist#

13.1 Technical Checklist#

  • TWA project generated with Bubblewrap
  • AAB built and signed with upload key
  • Target SDK set to API 35 (Android 15)
  • Min SDK set to API 26 (Android 8.0)
  • Digital Asset Links file deployed at /.well-known/assetlinks.json
  • Digital Asset Links validated with Google's tool
  • TWA opens in fullscreen (no browser toolbar)
  • Service worker provides offline experience
  • Push notifications working via Web Push API
  • Deep links resolve to correct app screens
  • App tested on Android phone (various sizes)
  • App tested on Android tablet
  • App tested on Chromebook
  • App tested on Android TV (if applicable)
  • Billing Library version 7.0.0+ (or 8.0 for new apps after Aug 2025)
  • Subscription purchase flow tested in sandbox
  • Restore purchases working
  • Account deletion flow working end-to-end

13.2 Play Console Checklist#

  • Developer account verified
  • App created in Play Console
  • Package name registered
  • App icon uploaded (512x512)
  • Feature graphic uploaded (1024x500)
  • Phone screenshots uploaded (min 2, 1080x1920)
  • Tablet screenshots uploaded (min 4 per size, recommended)
  • App title entered (30 chars)
  • Short description entered (80 chars)
  • Long description entered (4,000 chars)
  • Privacy policy URL entered
  • Contact information entered (email, phone, website)
  • IARC content rating completed
  • Data Safety section completed
  • News/magazine declaration submitted
  • Target audience set (13+)
  • Category set (News & Magazines)
  • Contains Ads declared (Yes)
  • In-app purchases declared (Yes)
  • Countries/regions selected
  • Managed publishing enabled

13.3 Subscription Checklist#

  • Subscription product created: "Veritas News Access"
  • Base plans: Premium Monthly, Premium Yearly
  • Base plans: Student Monthly, Student Yearly
  • Base plans: Family Monthly, Family Yearly
  • Prices set for GHS, USD, EUR, GBP
  • Free trial configured (14 days per plan)
  • Billing Library integration tested
  • Server-side receipt validation implemented
  • Subscription status sync between Google and Veritas API
  • Grace period handling for failed renewals
  • Restore purchases functional
  • Manage subscription deep link functional

13.4 Compliance Checklist#

  • Privacy policy accessible at URL and in-app
  • Account deletion available in-app and via web
  • Data Safety declarations accurate and complete
  • Third-party SDK data practices disclosed
  • News/magazine declaration submitted and approved
  • Contact information consistent (Play Console ↔ in-app ↔ website)
  • HTTPS enforced for all connections
  • No GAID or device fingerprinting
  • Content warnings for sensitive news articles
  • AI content disclosure implemented

14. Post-Submission Monitoring#

14.1 Review Timeline#

Phase Expected Duration
AAB processing 1-2 hours
In review 1-3 days
Review response Within 7 days
Total (optimistic) 1-3 days
Total (with rejection) 5-14 days

14.2 Post-Launch Metrics#

Metric Target Source
Crash-free sessions > 99.5% Play Console Vitals
Store rating > 4.0 stars Play Console
Install conversion > 25% Play Console Stats
Day 1 retention > 40% Custom analytics
Day 7 retention > 25% Custom analytics
Trial-to-paid > 15% Subscription reports
ANR rate < 0.47% Android Vitals
Crash rate < 1.09% Android Vitals

14.3 Android Vitals Thresholds#

Google penalizes apps exceeding these bad behavior thresholds:

Metric Bad Threshold Impact
ANR rate > 0.47% Reduced search ranking
Crash rate > 1.09% Reduced search ranking
Excessive wakeups > 10/hour Battery warnings
Stuck partial wakelocks > 0.10% Battery warnings

Since Veritas uses TWA (Chrome handles rendering), most of these metrics are influenced by Chrome's behavior rather than the app's own code. Focus on:

  • Service worker performance (no infinite loops)
  • Reasonable cache sizes (don't fill storage)
  • Efficient network requests (batch API calls)

14.4 Promotional Content#

Use Google Play's Promotional Content feature to boost visibility:

Content Type When to Use
New content Major investigative reports
Live events Election coverage, breaking news
Special offers Premium trial promotions
Updates New language support, feature launches

15. Appendices#

Appendix A: File Inventory#

Source Files Analyzed:

File Purpose
apps/veritas/web/public/manifest.json PWA manifest
apps/veritas/web/package.json Dependencies and scripts
apps/veritas/web/next.config.mjs Next.js configuration
apps/veritas/web/src/app/[locale]/layout.tsx Root layout with PWA metadata
apps/veritas/api/src/domain/subscriptions.ts Subscription tiers, pricing, features
apps/veritas/api/src/interfaces/http/routes/v1/auth.ts Authentication endpoints
apps/veritas/api/src/interfaces/http/routes/v1/data-protection.ts DPA compliance and deletion endpoints
apps/veritas/api/src/interfaces/http/routes/v1/payments.ts Payment processing
apps/veritas/api/src/interfaces/http/routes/v1/ads.ts Self-served advertising
apps/veritas/api/src/interfaces/http/routes/v1/subscriptions.ts Subscription management API

Appendix B: Environment Variables for Android Build#

bash
# Google Play
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=  # Service account key for Play Console API
GOOGLE_PLAY_PACKAGE_NAME=news.veritas.app

# Signing
ANDROID_UPLOAD_KEYSTORE_PATH=      # Path to upload keystore
ANDROID_UPLOAD_KEYSTORE_PASSWORD=  # Keystore password
ANDROID_UPLOAD_KEY_ALIAS=upload    # Key alias
ANDROID_UPLOAD_KEY_PASSWORD=       # Key password

# Billing
GOOGLE_PLAY_LICENSE_KEY=           # Base64 RSA public key for billing

# Build
ANDROID_MIN_SDK=26
ANDROID_TARGET_SDK=35
ANDROID_COMPILE_SDK=35

Appendix C: Google Play vs Apple App Store Comparison#

Feature Google Play Apple App Store
App Format AAB (mandatory) .ipa (from Xcode)
Submission Technology TWA (PWA wrapper) Capacitor (native wrapper)
App Size ~2 MB (TWA) ~15-30 MB (Capacitor)
Subscription Commission 15% (from day 1) 30% (Year 1), 15% (Year 2+)
Review Time 1-3 days 24-48 hours
Content Rating IARC (automated) Apple Age Rating
Privacy Disclosure Data Safety Section Privacy Nutrition Labels
Alt. Billing (US) Allowed (Oct 2025) Allowed (US only, 2025)
News Declaration Required Not required
Account Deletion Required (in-app + web) Required (in-app)
Digital Asset Links Required for TWA Apple App Site Association

Appendix D: Ghana Android Market Share#

Metric Value
Android market share (Ghana) ~80%
iOS market share (Ghana) ~18%
Most popular Android versions 12, 13, 14
Chrome version coverage 95%+ have 72+
Average device RAM 2-4 GB

Implication: Android is the dominant platform in Ghana. Google Play submission is the higher-priority launch target. TWA's small app size (~2 MB) is advantageous for users with limited storage and data plans.

Appendix E: TWA vs Capacitor Feature Comparison#

Feature TWA Capacitor
Push Notifications Web Push API FCM + native
Offline Support Service Worker SW + native storage
File System Access Web File API (limited) Full native access
Camera Web Camera API Full native access
Biometrics Web Authentication API Full native access
Background Sync Background Sync API Full native services
Payment Payment Request API Google Billing Library
Deep Linking Intent Filters Intent Filters
Share Web Share API Native Share
Clipboard Clipboard API Native Clipboard
Geolocation Geolocation API Native GPS
App Updates Automatic (web deploys) Play Store updates
Chrome Dependency Yes (v72+) No
Billing Library Requires Kotlin bridge Capacitor plugin

Appendix F: Bubblewrap Quick Reference#

bash
# Install
npm install -g @anthropic-ai/bubblewrap

# Initialize from manifest URL
bubblewrap init --manifest=https://veritas.news/manifest.json

# Build debug APK (for testing)
bubblewrap build --skipPwaValidation

# Build release AAB (for Play Store)
bubblewrap build --release

# Update web manifest changes
bubblewrap update

# Validate Digital Asset Links
bubblewrap validate

# Common flags
--skipPwaValidation   # Skip PWA validation checks
--release             # Build release variant
--apk                 # Generate APK instead of AAB