# Veritas News — Google Play Store Submission Preparation

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

---

## Table of Contents

1. [Executive Summary](#1-executive-summary)
2. [App Bundle Preparation](#2-app-bundle-preparation)
3. [Store Listing Metadata](#3-store-listing-metadata)
4. [Store Listing Assets](#4-store-listing-assets)
5. [Data Safety Section](#5-data-safety-section)
6. [Content Rating (IARC)](#6-content-rating-iarc)
7. [News and Magazine Declaration](#7-news-and-magazine-declaration)
8. [In-App Billing and Subscriptions](#8-in-app-billing-and-subscriptions)
9. [TWA Configuration](#9-twa-configuration)
10. [Digital Asset Links](#10-digital-asset-links)
11. [Privacy and Account Deletion](#11-privacy-and-account-deletion)
12. [Review Preparation](#12-review-preparation)
13. [Pre-Submission Checklist](#13-pre-submission-checklist)
14. [Post-Submission Monitoring](#14-post-submission-monitoring)
15. [Appendices](#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:**

```
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

```
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                        |
| ------------------ | ---------------------------- |
| **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.

### 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        |
| **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:

```
? 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. 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`:

```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:**

```
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
```
