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#
- Executive Summary
- App Bundle Preparation
- Store Listing Metadata
- Store Listing Assets
- Data Safety Section
- Content Rating (IARC)
- News and Magazine Declaration
- In-App Billing and Subscriptions
- TWA Configuration
- Digital Asset Links
- Privacy and Account Deletion
- Review Preparation
- Pre-Submission Checklist
- Post-Submission Monitoring
- 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:
# 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:
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 |
Setup Steps:
- Enroll in Play App Signing in Play Console (Setup > App signing)
- Generate an upload key locally:
keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload - Sign the AAB with the upload key
- Upload the signed AAB to Play Console
- 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#
{
"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#
AI-powered news from Ghana with fact-checking, bias scoring, and six languages.
Character count: 78 (within 80 limit)
3.3 Long Description#
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 |
|---|---|
| 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.
4.4 Screenshots — Tablet/Chromebook (Recommended)#
| 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.
4.5 Video Preview (Optional but Recommended)#
| 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 |
| 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:
- 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.
- 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).
- 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:
? 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#
<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:
- Cache the app shell (HTML, CSS, JS) for instant offline loading
- Cache previously viewed articles for offline reading
- Show an offline banner with cached article list
- 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. Digital Asset Links#
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:
[
{
"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#
-
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
-
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
- Must be served at the exact path:
-
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
- Use Google's validation tool:
10.4 Next.js Configuration#
Add a rewrite in next.config.mjs to serve the assetlinks.json:
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:
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:
- Upload to Internal Testing first
- Validate TWA functionality on multiple devices
- Promote to Closed Testing with Ghana-based testers
- Fix any issues found
- 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#
# 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#
# 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