Eve library

Veritas News — iOS App Store Submission Preparation

Tracker

Revision 1

On this page

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

Task 23.16.2.1 | Comprehensive guide for submitting Veritas News to the Apple App Store.


Table of Contents#

  1. Executive Summary
  2. App Binary Preparation
  3. App Store Connect Metadata
  4. App Store Assets
  5. Privacy Details (Nutrition Labels)
  6. Privacy Manifest File
  7. Age Rating Questionnaire
  8. In-App Purchases and Subscriptions
  9. App Review Preparation
  10. Capacitor Configuration
  11. Xcode Project Configuration
  12. Native Feature Integration
  13. Pre-Submission Checklist
  14. Post-Submission Monitoring
  15. Appendices

1. Executive Summary#

Application Overview#

Field Value
App Name Veritas News
Bundle ID news.veritas.app
Platform iOS (iPhone + iPad)
Technology Next.js PWA wrapped with Capacitor
Min iOS iOS 16.0
Category News (Primary), Reference (Secondary)
Content Rating 13+ (News content includes violence, mature themes)
Pricing Free with In-App Purchases (auto-renewable subs)
Languages English, Twi, Ewe, Ga, Hausa, Dagbani

Submission Strategy#

Veritas News is a Next.js Progressive Web App that must be wrapped with Capacitor to create a native iOS binary. A pure PWA cannot be submitted to the App Store. The wrapping strategy integrates native iOS features (push notifications, native sharing, haptic feedback, biometric authentication) to meet Apple's Guideline 4.2 minimum functionality requirements and differentiate the app from a mobile web browsing experience.

Critical Deadlines#

Deadline Requirement
January 31, 2026 Complete updated age rating questionnaire (new 5-tier system)
April 2026 All submissions must use iOS 26 SDK
Ongoing Privacy manifests required for all Required Reason API usage

2. App Binary Preparation#

2.1 Capacitor Project Initialization#

The Veritas web app at apps/veritas/web/ must be wrapped with Capacitor to produce an iOS binary. Capacitor bridges the Next.js PWA to native iOS APIs.

Required Dependencies:

json
{
  "dependencies": {
    "@capacitor/core": "^6.2.0",
    "@capacitor/ios": "^6.2.0",
    "@capacitor/app": "^6.0.0",
    "@capacitor/haptics": "^6.0.0",
    "@capacitor/keyboard": "^6.0.0",
    "@capacitor/push-notifications": "^6.0.0",
    "@capacitor/share": "^6.0.0",
    "@capacitor/splash-screen": "^6.0.0",
    "@capacitor/status-bar": "^6.0.0",
    "@capacitor/preferences": "^6.0.0",
    "@capacitor/browser": "^6.0.0",
    "@capacitor/network": "^6.0.0"
  },
  "devDependencies": {
    "@capacitor/cli": "^6.2.0"
  }
}

2.2 Capacitor Configuration#

Create apps/veritas/web/capacitor.config.ts:

typescript
import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'news.veritas.app',
  appName: 'Veritas News',
  webDir: 'out',
  bundledWebRuntime: false,

  server: {
    // In development, load from local dev server
    // In production, load from bundled web assets
    androidScheme: 'https',
    iosScheme: 'https',
    hostname: 'veritas.news',
  },

  plugins: {
    SplashScreen: {
      launchShowDuration: 2000,
      launchAutoHide: true,
      backgroundColor: '#2563eb',
      androidSplashResourceName: 'splash',
      androidScaleType: 'CENTER_CROP',
      showSpinner: false,
      splashFullScreen: true,
      splashImmersive: true,
    },
    PushNotifications: {
      presentationOptions: ['badge', 'sound', 'alert'],
    },
    Keyboard: {
      resize: 'body',
      style: 'dark',
      resizeOnFullScreen: true,
    },
    StatusBar: {
      style: 'default',
      backgroundColor: '#ffffff',
    },
  },

  ios: {
    contentInset: 'automatic',
    allowsLinkPreview: true,
    scrollEnabled: true,
    scheme: 'Veritas News',
    preferredContentMode: 'mobile',
  },
};

export default config;

2.3 Build Pipeline#

The iOS build pipeline follows these steps:

text
1. next build && next export     → Generate static site in out/
2. npx cap sync ios              → Sync web assets to Xcode project
3. xcodebuild archive            → Create .xcarchive
4. xcodebuild -exportArchive     → Create .ipa for submission
5. xcrun altool --upload-app     → Upload to App Store Connect

Nx Integration (apps/veritas/web/project.json targets):

json
{
  "targets": {
    "build:ios": {
      "executor": "nx:run-commands",
      "options": {
        "commands": ["next build", "npx cap sync ios"],
        "cwd": "apps/veritas/web"
      }
    },
    "open:ios": {
      "executor": "nx:run-commands",
      "options": {
        "command": "npx cap open ios",
        "cwd": "apps/veritas/web"
      }
    }
  }
}

2.4 Next.js Static Export Configuration#

For Capacitor, the Next.js app must be statically exported. Update next.config.mjs:

javascript
const nextConfig = {
  output: 'export',
  // ... existing config
};

Server-side features (API routes, SSR, ISR) are handled by the Veritas API backend. The iOS app communicates with the API at https://api.veritas.news/v1.

2.5 iOS App Signing#

Requirement Value
Team ID Configure in Apple Developer Portal
Signing Certificate Apple Distribution Certificate
Provisioning Profile App Store Distribution Profile
Entitlements Push Notifications, Associated Domains, Sign in with Apple

Required Entitlements File (App.entitlements):

xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>aps-environment</key>
    <string>production</string>
    <key>com.apple.developer.associated-domains</key>
    <array>
        <string>applinks:veritas.news</string>
        <string>webcredentials:veritas.news</string>
    </array>
    <key>com.apple.developer.applesignin</key>
    <array>
        <string>Default</string>
    </array>
</dict>
</plist>

3. App Store Connect Metadata#

3.1 App Identity#

Field Value Limit
App Name Veritas News 30 chars
Subtitle Ghana's AI-Powered Truth Agency 30 chars (exactly 30)
Bundle ID news.veritas.app —

3.2 Description#

Full Description (4,000 character limit):

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

STAY INFORMED WITH TRUSTED NEWS
Browse breaking news from Ghana's top sources including 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.

AI-POWERED SUMMARIES
Get concise, AI-generated summaries of complex stories. Perfect for staying
informed on the go. Available in English, Twi, Ewe, Ga, Hausa, and Dagbani.

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

PERSONALIZED FEED
Customize your news feed by topics, sources, and preferred language.
Set custom alerts for breaking news in categories that matter to you.

SIX GHANAIAN LANGUAGES
Read the news in your preferred language: English, Twi (Akan), Ewe, Ga,
Hausa, or Dagbani. Full translation support powered by Ghana NLP and Khaya.

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

SUBSCRIPTION OPTIONS
- Free: 10 articles/day, basic fact-checking, reading statistics
- Premium: GH₵49.99/month or GH₵499.99/year — unlimited everything
- Student: 50% off Premium with valid student verification
- Family: Share with up to 6 members for GH₵74.99/month

PRIVACY FIRST
Built in compliance with Ghana's Data Protection Act (Act 843) and NMC
guidelines. Your data stays protected with AES-256 encryption. Full data
export and account deletion available.

REGULATORY COMPLIANCE
Adheres to the National Media Commission (NMC) Act 449, Ghana Journalists
Association (GJA) Code of Ethics, and election coverage regulations.
AI-generated content is clearly disclosed per our transparency framework.

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

Character count: ~1,898 (well within 4,000 limit)

3.3 Promotional Text#

text
Breaking news with AI fact-checking, bias scoring, and six Ghanaian languages. Try Premium free for 14 days.

Character count: 107 (within 170 limit)

3.4 Keywords#

text
news,ghana,fact-check,bias,AI,twi,ewe,ga,hausa,veritas,truth,media

Character count: 69 (within 100 limit)

3.5 What's New (Version 1.0)#

text
Welcome to Veritas News — Ghana's AI-Powered Truth Agency.

This is our initial release featuring:
- Breaking news from Ghana's top sources
- AI-powered fact-checking and bias analysis
- Six Ghanaian language support (English, Twi, Ewe, Ga, Hausa, Dagbani)
- Personalized news feed with custom alerts
- Premium subscriptions with offline reading
- AI-generated summaries and multimedia content
- Dark mode support
- Privacy-first design with Ghana DPA compliance

3.6 App Category#

Field Value
Primary Category News
Secondary Category Reference

3.7 Content Rights#

Question Answer
Does your app contain, show, or access third-party content? Yes
Do you have all necessary rights to display this content? Yes
Is any of the content available via license from a third-party? Yes

Documentation Required: Veritas aggregates news from Ghanaian publishers via publicly available RSS feeds. Content is displayed with attribution and links back to original sources. Veritas adds value through AI fact-checking, bias analysis, translation, and summarization — transformative use rather than mere republication.

3.8 Availability#

Field Value
Availability All territories (172 countries/regions)
Primary Market Ghana
Price Free
Pre-order No
Release Manual release after approval

3.9 Localizations#

Prepare App Store metadata in the following languages:

Language Locale Code Status
English en-US Required
English (UK) en-GB Recommended (Ghana uses British English)

App Store Connect does not support Twi, Ewe, Ga, Hausa, or Dagbani as store listing languages. These languages are supported within the app and should be highlighted in the English description and screenshots.

3.10 URLs#

Field URL
Privacy Policy https://veritas.news/privacy
Support URL https://veritas.news/support
Marketing URL https://veritas.news (optional)

3.11 Contact Information#

Field Value
Developer Name Veritas News Ltd
Copyright 2026 Veritas News Ltd
Contact Email support@veritas.news
Contact Phone +233-XXX-XXX-XXXX

4. App Store Assets#

4.1 App Icon#

Asset Size Format Notes
App Store Icon 1024 x 1024 PNG No transparency, no rounded corners (iOS applies mask)

Design Requirements:

  • No alpha channel or transparency
  • sRGB color space
  • No embedded border radius — iOS applies the superellipse mask
  • Must not contain text that is too small to read
  • Should be recognizable at small sizes (29x29 pt)

Current Assets Available:

  • public/icon-512.png (512x512) — Needs upscaling to 1024x1024
  • public/icon-192.png (192x192) — Too small
  • public/apple-touch-icon.png (180x180) — iOS home screen only

Required Action: Create a 1024x1024 app icon from the Veritas brand assets.

4.2 Screenshots#

Required Screenshots — iPhone 6.9"#

Dimensions: 1320 x 2868 px (portrait) or 2868 x 1320 px (landscape) Devices: iPhone 16 Pro Max, 15 Pro Max, 14 Pro Max Quantity: Minimum 3, maximum 10

Recommended Screenshot Set:

# Screen Caption
1 Home Feed "Breaking news from Ghana's trusted sources"
2 Article with Fact Check "AI fact-checking scores 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 Subscription Plans "Choose your Veritas experience"
7 Dark Mode "Beautiful dark mode for comfortable reading"
8 Search Results "Find any story with advanced search"

Required Screenshots — iPad 13"#

Dimensions: 2064 x 2752 px (portrait) or 2752 x 2064 px (landscape) Devices: iPad Pro (M4/M5), iPad Air (M2/M3) Quantity: Minimum 3, maximum 10

Same set as iPhone screenshots, adapted for iPad layout with split-view considerations.

Optional Screenshot Sizes#

Device Class Dimensions (Portrait) Priority
iPhone 6.3" 1206 x 2622 High
iPhone 6.1" 1170 x 2532 Medium
iPhone 5.5" 1242 x 2208 Low
iPad 11" 1488 x 2266 Medium

Note: If only the 6.9" screenshots are provided, Apple auto-scales to all other iPhone sizes. Similarly, 13" iPad screenshots auto-scale to smaller iPads. Providing device-specific screenshots improves presentation quality.

Specification Value
Duration 15-30 seconds
Format H.264 or ProRes 422 (HQ)
Container .mov, .m4v, or .mp4
Max File Size 500 MB
Resolution Must match screenshot dimensions

Recommended Preview Script (30 seconds):

text
00:00-05:00  App launch → Home feed with breaking news
05:00-10:00  Scroll through articles → Tap into article
10:00-15:00  Fact-check score display → Bias analysis view
15:00-20:00  Language switch (English → Twi) → Article re-renders
20:00-25:00  AI summary generation → Audio playback
25:00-30:00  Dark mode toggle → Subscription CTA

Content Rules:

  • Must show actual in-app footage only
  • No marketing overlays, device frames, or third-party content
  • Audio must come from the app itself (no voiceover or music)
  • Must not contain pricing information

4.4 Current Asset Inventory#

Asset Path Status
Icon 192x192 public/icon-192.png Exists (referenced in manifest)
Icon 192x192 Maskable public/icon-192-maskable.png Exists (referenced in manifest)
Icon 512x512 public/icon-512.png Exists (referenced in manifest)
Icon 512x512 Maskable public/icon-512-maskable.png Exists (referenced in manifest)
Apple Touch Icon public/apple-touch-icon.png Exists (180x180)
Favicon public/favicon.ico Exists
Screenshot Wide public/screenshots/home.png Exists (1280x720 — wrong dimensions for App Store)
Screenshot Mobile public/screenshots/home-mobile.png Exists (750x1334 — wrong dimensions for App Store)
App Icon 1024x1024 — NEEDED
Screenshots 1320x2868 — NEEDED
Screenshots 2064x2752 — NEEDED
Splash Screen — NEEDED

5. Privacy Details (Nutrition Labels)#

5.1 Data Collection Summary#

Based on analysis of the Veritas API codebase, the following data is collected and must be disclosed in App Store Connect privacy nutrition labels.

5.2 Contact Info#

Data Type Collected Purpose Linked to Identity Tracking
Name Yes Account management Yes No
Email Address Yes Account, authentication Yes No
Phone Number Yes Payment (MoMo) Yes No
Physical Address No — — —

5.3 Financial Info#

Data Type Collected Purpose Linked to Identity Tracking
Payment Info Yes Subscription billing Yes No
Credit Info No — — —
Other Financial No — — —

Note: Credit card data is NOT stored — delegated to Stripe and mobile money providers (MTN MoMo, Vodafone Cash, AirtelTigo Money). Phone numbers used for mobile money payments are collected.

5.4 Identifiers#

Data Type Collected Purpose Linked to Identity Tracking
User ID Yes Account, personalization Yes No
Device ID No — — —

5.5 Usage Data#

Data Type Collected Purpose Linked to Identity Tracking
Product Interaction Yes Analytics, personalization Yes No
Advertising Data Yes Ad serving, impressions No No
Other Usage Data No — — —

Product Interaction details:

  • Article reads (daily count per user)
  • Search queries (daily count)
  • Fact check views (daily count)
  • Bias analysis views (daily count)
  • AI summary requests (daily count)
  • Article exports (monthly count)
  • API calls (daily count)

Advertising Data details:

  • Ad impressions (with viewability: 50% visible for 1+ second)
  • Ad clicks per campaign/creative
  • Device type for ad targeting (mobile/tablet/desktop)

5.6 Browsing History#

Data Type Collected Purpose Linked to Identity Tracking
Browsing History No — — —
Search History Yes Personalization Yes No

5.7 Purchases#

Data Type Collected Purpose Linked to Identity Tracking
Purchase History Yes Subscription mgmt Yes No

5.8 User Content#

Data Type Collected Purpose Linked to Identity Tracking
Other User Content Yes Tips/feedback Optional (anonymous tips supported) No
Emails or Text Messages No — — —
Photos or Videos No — — —
Audio Data No — — —

5.9 Diagnostics#

Data Type Collected Purpose Linked to Identity Tracking
Crash Data Yes App improvement No No
Performance Data Yes App improvement No No

5.10 Location#

Data Type Collected Purpose Linked to Identity Tracking
Precise Location No — — —
Coarse Location No — — —

Note: IP addresses are extracted from request headers for rate limiting only, not stored for location purposes. No geolocation enrichment is performed.

5.11 Sensitive Info#

Data Type Collected Purpose Linked to Identity Tracking
Sensitive Info No — — —

Note: While the DPA consent framework tracks categories for sensitive data (racial/ethnic origin, political opinions, religious beliefs), these are consent categories per Ghana DPA Section 96 — the app does not actively collect this data. Users' news reading preferences may incidentally reflect political interests, but this is classified under "Product Interaction," not sensitive data collection.

5.12 Data Not Collected#

The following data types are NOT collected:

  • Health & Fitness (Health, Fitness)
  • Contacts (address book access)
  • Surroundings (Environment Scanning)
  • Body (Hands, Head)
  • Precise/Coarse Location
  • Gameplay Content
  • Customer Support content (beyond tips)
  • Device ID (no IDFA, no device fingerprinting)

5.13 Third-Party Data Sharing#

Third Party Data Shared Purpose
Stripe Payment method, email, amount Subscription billing
MTN MoMo Phone number, amount Mobile payment
Vodafone Cash Phone number, amount Mobile payment
AirtelTigo Phone number, amount Mobile payment
Apple (StoreKit) Subscription status IAP management

No data is shared with:

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

5.14 App Tracking Transparency#

ATT Framework Required: No

Veritas does not track users across other companies' apps or websites. The app does not use IDFA or any cross-app tracking identifiers. No ATT prompt is needed.


6. Privacy Manifest File#

6.1 PrivacyInfo.xcprivacy#

This file must be included in the Xcode project root:

xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- Tracking declaration -->
    <key>NSPrivacyTracking</key>
    <false/>

    <!-- Tracking domains (none) -->
    <key>NSPrivacyTrackingDomains</key>
    <array/>

    <!-- Data collected -->
    <key>NSPrivacyCollectedDataTypes</key>
    <array>
        <!-- Email Address -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeEmailAddress</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Name -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeName</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Phone Number (MoMo payments) -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypePhoneNumber</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Payment Info -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypePaymentInfo</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- User ID -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeUserID</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Product Interaction -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeProductInteraction</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
                <string>NSPrivacyCollectedDataTypePurposeProductPersonalization</string>
            </array>
        </dict>

        <!-- Advertising Data -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeAdvertisingData</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <false/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeThirdPartyAdvertising</string>
            </array>
        </dict>

        <!-- Search History -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeSearchHistory</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeProductPersonalization</string>
            </array>
        </dict>

        <!-- Purchase History -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypePurchaseHistory</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Other User Content (Tips) -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeOtherUserContent</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <false/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Crash Data -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeCrashData</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <false/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>

        <!-- Performance Data -->
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypePerformanceData</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <false/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
            <key>NSPrivacyCollectedDataTypePurposes</key>
            <array>
                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
            </array>
        </dict>
    </array>

    <!-- Required Reason APIs -->
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <!-- UserDefaults (used by Capacitor Preferences plugin) -->
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>CA92.1</string>
            </array>
        </dict>

        <!-- File Timestamp (used for cache management) -->
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>C617.1</string>
            </array>
        </dict>
    </array>
</dict>
</plist>

6.2 Required Reason API Justifications#

API Category Reason Code Justification
UserDefaults CA92.1 Access user preferences and app state within the app
File Timestamp C617.1 Access file timestamps for cache invalidation

7. Age Rating Questionnaire#

7.1 Updated Rating System (Effective July 2025)#

The new iOS age rating tiers are: 4+, 9+, 13+, 16+, 18+

Deadline: Complete the updated questionnaire by January 31, 2026.

7.2 Questionnaire Responses#

In-App Controls#

Question Answer
Does the app provide parental controls? No
Does the app use age assurance mechanisms? No

Capabilities#

Question Answer
Does the app allow unrestricted web access? No
Does the app support user-generated content distribution? No
Does the app provide messaging or chat? No
Does the app contain advertising? Yes

Advertising note: Veritas serves self-hosted native ads (display, sponsored content). No third-party ad networks (AdMob, Facebook Ads) are integrated. Ads comply with NMC advertising guidelines.

Mature Themes#

Question Answer
Does the app contain profanity or crude humor? Infrequent
Does the app contain horror/fear themes? Infrequent
Does the app reference alcohol, tobacco, or drug use? Infrequent

Justification: As a news application, Veritas aggregates articles from Ghanaian news sources. These articles may occasionally reference violence, crime, substance abuse, or disturbing events in their reporting. This content is editorial/journalistic in nature, not glorifying or instructional.

Medical or Wellness#

Question Answer
Does the app provide medical or treatment information? No
Does the app offer health or wellness topics? No

Sexuality or Nudity#

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

Violence#

Question Answer
Does the app contain cartoon or fantasy violence? No
Does the app contain realistic violence? Infrequent
Does the app contain prolonged graphic or sadistic realistic violence? No
Does the app reference guns or other weapons? Infrequent

Justification: News articles may contain descriptions or images of real-world violence (crime reports, conflict coverage, accident reports). This is journalistic reporting, not entertainment violence. Images are editorially selected and may be accompanied by content warnings.

Chance-Based Activities#

Question Answer
Does the app contain gambling? No
Does the app contain simulated gambling? No
Does the app contain contests? No
Does the app contain loot boxes? No

7.3 Expected Rating#

Based on the above responses, the expected rating is 13+ due to:

  • Infrequent realistic violence (news reporting)
  • Infrequent mature themes (news content about crime, conflict, substance abuse)
  • Advertising present

This aligns with major news apps (BBC News: 12+, CNN: 12+, Al Jazeera: 12+) under the previous rating system. Under the new system, 13+ is the equivalent tier.


8. In-App Purchases and Subscriptions#

8.1 Subscription Group Configuration#

Subscription Group Name: Veritas News Access

All subscription tiers belong to the same group. Users can upgrade/downgrade within the group, but only one subscription can be active at a time.

8.2 Subscription Products#

8.2.1 Premium Monthly#

Field Value
Reference Name Veritas Premium Monthly
Product ID news.veritas.premium.monthly
Type Auto-Renewable Subscription
Duration 1 Month
Price (GH) GH₵49.99
Price (US) $9.99
Price (EU) €8.99
Price (UK) £7.99
Free Trial 14 days
Display Name Veritas Premium
Description Unlimited reading, ad-free, AI summaries, offline access, advanced search

8.2.2 Premium Yearly#

Field Value
Reference Name Veritas Premium Yearly
Product ID news.veritas.premium.yearly
Type Auto-Renewable Subscription
Duration 1 Year
Price (GH) GH₵499.99
Price (US) $99.99
Price (EU) €89.99
Price (UK) £79.99
Free Trial 14 days
Display Name Veritas Premium (Annual)
Description Save ~17% with annual billing. All Premium features included.

8.2.3 Student Monthly#

Field Value
Reference Name Veritas Student Monthly
Product ID news.veritas.student.monthly
Type Auto-Renewable Subscription
Duration 1 Month
Price (GH) GH₵24.99
Price (US) $4.99
Price (EU) €4.49
Price (UK) £3.99
Free Trial 14 days
Display Name Veritas Student
Description 50% off Premium for verified students. All features included.

8.2.4 Student Yearly#

Field Value
Reference Name Veritas Student Yearly
Product ID news.veritas.student.yearly
Type Auto-Renewable Subscription
Duration 1 Year
Price (GH) GH₵249.99
Price (US) $49.99
Price (EU) €44.99
Price (UK) £39.99
Free Trial 14 days
Display Name Veritas Student (Annual)
Description Save ~17% with annual billing. Student verification required.

8.2.5 Family Monthly#

Field Value
Reference Name Veritas Family Monthly
Product ID news.veritas.family.monthly
Type Auto-Renewable Subscription
Duration 1 Month
Price (GH) GH₵74.99
Price (US) $14.99
Price (EU) €13.49
Price (UK) £11.99
Free Trial 14 days
Display Name Veritas Family
Description Share Premium with up to 6 family members. Each gets their own profile.

8.2.6 Family Yearly#

Field Value
Reference Name Veritas Family Yearly
Product ID news.veritas.family.yearly
Type Auto-Renewable Subscription
Duration 1 Year
Price (GH) GH₵749.99
Price (US) $149.99
Price (EU) €134.99
Price (UK) £119.99
Free Trial 14 days
Display Name Veritas Family (Annual)
Description Save ~17% with annual billing. Up to 6 members included.

8.3 Apple Commission#

Scenario Commission Notes
Year 1 30% Standard rate
Year 2+ (continuous) 15% After 1 year of continuous paid service
Small Business Program 15% If under $1M/year revenue

Pricing Consideration: Apple takes 30% commission on all IAP revenue. Prices above are the customer-facing prices. Revenue per subscription:

Plan Monthly Price Apple Cut (30%) Net Revenue
Premium (GHS) GH₵49.99 GH₵15.00 GH₵34.99
Premium (USD) $9.99 $3.00 $6.99
Student (GHS) GH₵24.99 GH₵7.50 GH₵17.49
Family (GHS) GH₵74.99 GH₵22.50 GH₵52.49

8.4 StoreKit Integration#

The app must use StoreKit 2 for iOS subscription management. This requires:

  1. StoreKit Configuration File — Map product IDs to App Store Connect
  2. Transaction Listener — Handle purchase completions, renewals, cancellations
  3. Receipt Validation — Server-side validation via App Store Server API v2
  4. Subscription Status — Sync between Apple and Veritas API subscription records
  5. Restore Purchases — Required button in subscription settings
  6. Manage Subscription — Deep link to iOS subscription management

Dual Payment System: The iOS app must route all digital content purchases through Apple IAP (required by App Store guidelines). Mobile money payments (MTN MoMo, Vodafone Cash, AirtelTigo) are for web-only subscriptions and cannot be offered in the iOS app. Stripe can be used for web payments. The app must detect platform and show only Apple IAP options on iOS.

8.5 Subscription Terms Display#

The app must display subscription terms before purchase, including:

  • Price and billing frequency
  • Free trial duration and what happens after trial ends
  • Auto-renewal disclosure
  • How to cancel
  • Link to Terms of Service
  • Link to Privacy Policy

Required Text (per Apple guidelines):

text
Payment will be charged to your Apple ID account at confirmation of purchase.
Subscription automatically renews unless it is canceled at least 24 hours
before the end of the current period. Your account will be charged for renewal
within 24 hours prior to the end of the current period. You can manage and
cancel your subscriptions by going to your account settings on the App Store
after purchase. Any unused portion of a free trial period will be forfeited
when you purchase a subscription.

9. App Review Preparation#

9.1 Demo Account#

Provide a pre-configured demo account for Apple reviewers:

Field Value
Email apple-review@veritas.news
Password (Generate secure password)
Tier Premium (fully unlocked)
Notes Account pre-loaded with reading history, bookmarks, and preferences

Account Requirements:

  • Must have an active premium subscription (bypassing payment for review)
  • Must have articles available for viewing
  • Must have the language switcher demonstrable
  • Must not require 2FA or CAPTCHA for sign-in

9.2 App Review Notes#

text
Veritas News is Ghana's AI-powered news agency. This app aggregates and
enriches news articles from licensed Ghanaian publishers using artificial
intelligence for fact-checking, bias analysis, and multi-language translation.

DEMO ACCOUNT:
Email: apple-review@veritas.news
Password: [secure-password]
This account has Premium access pre-configured.

CONTENT NOTES:
- News content is sourced from Ghanaian publishers via RSS feeds with
  attribution
- AI fact-checking and bias scoring are proprietary features (not simple
  aggregation)
- Six Ghanaian language translations are provided via Ghana NLP partnership
- AI-generated content is clearly labeled per our AI disclosure framework

PAYMENT NOTES:
- Subscriptions are handled via StoreKit 2 in the iOS app
- Mobile money payments (MTN MoMo, Vodafone Cash) are web-only and not
  offered in the iOS app
- Student verification uses educational email or SheerID

BACKEND:
- API server: https://api.veritas.news/v1
- No IP restrictions for Apple review servers

REGULATORY:
- The app complies with Ghana's National Media Commission (NMC) Act 449
- The app complies with Ghana's Data Protection Act (Act 843)
- AI content disclosure follows our 4-level transparency framework

9.3 Common Rejection Risks and Mitigations#

Risk 1: Guideline 4.2 — Minimum Functionality#

Risk: App rejected as a repackaged website with insufficient native functionality.

Mitigation:

  • Integrate push notifications via APNs (not just web push)
  • Implement native sharing via UIActivityViewController
  • Add haptic feedback for interactions (bookmarking, fact-check reveals)
  • Implement native navigation patterns (swipe-back gesture, tab bar)
  • Provide offline reading with cached articles
  • Use Face ID/Touch ID for authentication
  • Implement native splash screen (not web-rendered)
  • Add 3D Touch / Haptic Touch quick actions from home screen

Risk 2: Guideline 4.2.2 — Content Aggregator#

Risk: App rejected as a content aggregator without sufficient unique value.

Mitigation:

  • AI fact-checking is proprietary value-add (not available on source sites)
  • Bias analysis scoring is unique functionality
  • Multi-language translation (6 Ghanaian languages) adds significant value
  • AI-generated summaries provide unique content
  • Personalized feed with topic/source filtering
  • Cross-source article clustering and comparison
  • Reading statistics and media diversity analytics

Risk 3: Guideline 5.1.1(i) — Privacy Policy#

Risk: Privacy policy not accessible within the app.

Mitigation:

  • Privacy policy accessible at /privacy within the app
  • Link in settings menu
  • Link during account creation flow
  • Link in subscription purchase flow
  • Privacy policy URL provided in App Store Connect metadata

Risk 4: Guideline 3.1.1 — In-App Purchase Requirement#

Risk: App offers alternative payment methods for digital content.

Mitigation:

  • All digital content subscriptions in the iOS app go through StoreKit/Apple IAP
  • Mobile money payment options hidden on iOS platform
  • Stripe direct payments hidden on iOS platform
  • No external payment links for digital content (unless U.S. market)
  • Physical goods/services exempt (N/A for Veritas)

Risk 5: Account Deletion Requirement#

Risk: App allows account creation but not deletion.

Mitigation:

  • Account deletion available via /data-protection/users/:userId API endpoint
  • In-app account deletion in Settings → Account → Delete Account
  • Cascading deletion of all personal data per Ghana DPA
  • Confirmation dialog with warning about data loss
  • 30-day grace period before permanent deletion

Risk 6: Sign in with Apple Requirement#

Risk: App offers Google/Facebook sign-in but not Sign in with Apple.

Mitigation:

  • Sign in with Apple must be implemented alongside Google and Facebook OAuth
  • Must be offered as a first-party option with equal prominence
  • Apple Sign In entitlement added to provisioning profile

9.4 Expedited Review#

If needed, Apple offers expedited review for apps with critical issues. Not recommended for initial submission unless there is a time-sensitive launch event.


10. Capacitor Configuration#

10.1 Project Initialization Commands#

bash
# From apps/veritas/web/
pnpm add @capacitor/core @capacitor/ios @capacitor/app \
  @capacitor/haptics @capacitor/keyboard @capacitor/push-notifications \
  @capacitor/share @capacitor/splash-screen @capacitor/status-bar \
  @capacitor/preferences @capacitor/browser @capacitor/network

pnpm add -D @capacitor/cli

# Initialize Capacitor
npx cap init "Veritas News" "news.veritas.app" --web-dir out

# Add iOS platform
npx cap add ios

# Sync web assets to native project
npx cap sync ios

10.2 iOS-Specific Capacitor Plugins#

Plugin Purpose
@capacitor/push-notifications APNs push notifications
@capacitor/share Native UIActivityViewController
@capacitor/haptics Haptic feedback
@capacitor/keyboard Keyboard management
@capacitor/splash-screen Native splash screen
@capacitor/status-bar Status bar customization
@capacitor/preferences Secure key-value storage
@capacitor/browser In-app browser for external links
@capacitor/network Network status monitoring
@capacitor/app App lifecycle (foreground/background)
bash
# Biometric authentication (Face ID / Touch ID)
pnpm add @capacitor-community/biometric-auth

# In-App Purchases (StoreKit 2)
pnpm add @capacitor-community/in-app-purchases

# Badge count management
pnpm add @capacitor/badge

# Screen orientation lock
pnpm add @capacitor/screen-orientation

11. Xcode Project Configuration#

11.1 Info.plist Entries#

The following keys must be configured in the Xcode project Info.plist:

xml
<!-- Push Notification Usage Description -->
<key>NSUserNotificationsUsageDescription</key>
<string>Veritas News sends notifications for breaking news, fact-check updates, and personalized alerts.</string>

<!-- Camera Usage (for student verification document upload) -->
<key>NSCameraUsageDescription</key>
<string>Veritas uses your camera to scan student ID documents for verification.</string>

<!-- Photo Library Usage (for student verification document upload) -->
<key>NSPhotoLibraryUsageDescription</key>
<string>Veritas accesses your photo library to upload student ID documents for verification.</string>

<!-- Face ID Usage Description -->
<key>NSFaceIDUsageDescription</key>
<string>Veritas uses Face ID for secure authentication.</string>

<!-- App Transport Security -->
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>veritas.news</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSExceptionMinimumTLSVersion</key>
            <string>TLSv1.2</string>
        </dict>
    </dict>
</dict>

<!-- Background Modes -->
<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
    <string>fetch</string>
</array>

<!-- Supported Interface Orientations (iPhone) -->
<key>UISupportedInterfaceOrientations</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
</array>

<!-- Supported Interface Orientations (iPad) -->
<key>UISupportedInterfaceOrientations~ipad</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>

<!-- Minimum iOS Version -->
<key>MinimumOSVersion</key>
<string>16.0</string>

<!-- Associated Domains -->
<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:veritas.news</string>
    <string>webcredentials:veritas.news</string>
</array>

11.2 Deployment Target#

Setting Value
iOS Deployment Target 16.0
Targeted Device Family iPhone, iPad
Swift Language Version 5.9

11.3 Build Settings#

Setting Value
PRODUCT_BUNDLE_IDENTIFIER news.veritas.app
MARKETING_VERSION 1.0.0
CURRENT_PROJECT_VERSION 1
CODE_SIGN_STYLE Manual
CODE_SIGN_IDENTITY Apple Distribution
DEVELOPMENT_TEAM (Team ID from Dev Portal)
PROVISIONING_PROFILE_SPECIFIER Veritas News App Store

11.4 Capabilities#

Enable the following capabilities in Xcode:

Capability Configuration
Push Notifications Enabled
Associated Domains applinks:veritas.news, webcredentials:veritas.news
Sign in with Apple Enabled
Background Modes Remote notifications, Background fetch
In-App Purchase Enabled

12. Native Feature Integration#

12.1 Push Notifications#

Implementation Architecture:

text
User Device (iOS)
    ↓ APNs device token
Veritas API (/notifications/register)
    ↓ Store device token
Notification Service
    ↓ Breaking news event
APNs (Apple Push Notification service)
    ↓ Push notification
User Device (iOS)

Notification Categories:

Category Title Format Action Buttons
BREAKING_NEWS "BREAKING: {headline}" Read, Share, Dismiss
FACT_CHECK "Fact Check: {claim}" View, Dismiss
DAILY_DIGEST "Your Daily Digest" Read, Dismiss
CUSTOM_ALERT "{topic}: {headline}" Read, Share, Dismiss
SUBSCRIPTION "Your subscription..." View, Dismiss

Permission Request Timing: Request push notification permission after the user has viewed at least 3 articles (delayed permission request increases opt-in rates).

12.2 Native Sharing#

typescript
import { Share } from '@capacitor/share';

async function shareArticle(article: Article) {
  await Share.share({
    title: article.headline,
    text: `${article.headline} — Verified by Veritas News`,
    url: `https://veritas.news/article/${article.slug}`,
    dialogTitle: 'Share this article',
  });
}

12.3 Haptic Feedback#

typescript
import { Haptics, ImpactStyle, NotificationType } from '@capacitor/haptics';

// Bookmark added
async function onBookmark() {
  await Haptics.impact({ style: ImpactStyle.Light });
}

// Fact-check reveal
async function onFactCheckReveal() {
  await Haptics.impact({ style: ImpactStyle.Medium });
}

// Subscription purchase complete
async function onPurchaseSuccess() {
  await Haptics.notification({ type: NotificationType.Success });
}

12.4 Biometric Authentication#

typescript
import { BiometricAuth } from '@capacitor-community/biometric-auth';

async function authenticateWithBiometrics() {
  const available = await BiometricAuth.checkBiometry();
  if (available.isAvailable) {
    const result = await BiometricAuth.authenticate({
      reason: 'Authenticate to access Veritas News',
      cancelTitle: 'Use Password',
      allowDeviceCredential: true,
    });
    return result.verified;
  }
  return false;
}

12.5 Offline Reading#

Offline reading uses @capacitor/preferences for metadata and the browser Cache API for article content:

typescript
import { Preferences } from '@capacitor/preferences';

interface CachedArticle {
  id: string;
  headline: string;
  body: string;
  cachedAt: string;
  expiresAt: string;
}

async function cacheArticleForOffline(article: Article) {
  const cached: CachedArticle = {
    id: article.id,
    headline: article.headline,
    body: article.body,
    cachedAt: new Date().toISOString(),
    expiresAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
  };

  await Preferences.set({
    key: `offline_article_${article.id}`,
    value: JSON.stringify(cached),
  });
}

12.6 Network Status#

typescript
import { Network } from '@capacitor/network';

// Listen for network status changes
Network.addListener('networkStatusChange', (status) => {
  if (!status.connected) {
    // Show offline banner, switch to cached content
    showOfflineBanner();
  } else {
    // Hide offline banner, refresh content
    hideOfflineBanner();
    refreshFeed();
  }
});

Apple App Site Association file at https://veritas.news/.well-known/apple-app-site-association:

json
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAM_ID.news.veritas.app",
        "paths": [
          "/article/*",
          "/fact-check/*",
          "/topic/*",
          "/author/*",
          "/source/*",
          "/search",
          "/breaking",
          "/politics",
          "/sports",
          "/business",
          "/entertainment",
          "/technology",
          "/health"
        ]
      }
    ]
  },
  "webcredentials": {
    "apps": ["TEAM_ID.news.veritas.app"]
  }
}

13. Pre-Submission Checklist#

13.1 Development Checklist#

  • Capacitor project initialized with all plugins
  • Next.js static export configured (output: 'export')
  • iOS platform added and synced (npx cap sync ios)
  • Xcode project builds without errors
  • App runs on iPhone simulator (latest iOS)
  • App runs on iPad simulator
  • App runs on physical iPhone device
  • All native plugins functioning (push, share, haptics, biometrics)
  • StoreKit 2 integration complete
  • All subscription products tested in sandbox
  • Restore purchases working
  • Account deletion working end-to-end
  • Sign in with Apple integrated
  • Offline reading functional
  • Deep linking working (universal links)
  • Push notifications delivered via APNs
  • Dark mode rendering correctly
  • All 6 languages functional in-app
  • Safe area insets respected (notch, Dynamic Island, home indicator)
  • Landscape orientation handled on iPad
  • Accessibility: VoiceOver navigation functional
  • Accessibility: Dynamic Type supported
  • No private API usage detected (run nm on binary)

13.2 App Store Connect Checklist#

  • App created in App Store Connect
  • Bundle ID registered in Developer Portal
  • App name reserved
  • Primary and secondary categories set
  • Full description entered (English)
  • Promotional text entered
  • Keywords entered
  • What's New text entered
  • Support URL configured
  • Privacy Policy URL configured
  • Marketing URL configured (optional)
  • Copyright info entered
  • Contact info entered
  • Screenshots uploaded (6.9" iPhone — minimum 3)
  • Screenshots uploaded (13" iPad — minimum 3)
  • App icon uploaded (1024x1024)
  • App preview uploaded (optional)
  • Age rating questionnaire completed
  • Privacy nutrition labels completed
  • Content rights declaration completed

13.3 Subscription Checklist#

  • Subscription group created: "Veritas News Access"
  • All 6 subscription products created with correct Product IDs
  • Prices set for all territories (GHS, USD, EUR, GBP)
  • Free trial configured (14 days)
  • Subscription terms displayed before purchase
  • Auto-renewal disclosure text included
  • Restore purchases button accessible in Settings
  • Manage subscription deep link functional
  • Server-side receipt validation implemented
  • Subscription status sync between Apple and Veritas API
  • Grace period handling for failed renewals
  • Offer codes configured (optional)

13.4 Privacy and Security Checklist#

  • PrivacyInfo.xcprivacy file included in Xcode project
  • All Required Reason APIs declared with reason codes
  • App Tracking Transparency: NOT required (no cross-app tracking)
  • Privacy nutrition labels match actual data collection
  • Third-party SDK privacy manifests included
  • No IDFA or device fingerprinting
  • HTTPS enforced for all network requests
  • Certificate pinning for API connections (recommended)
  • Keychain used for sensitive token storage
  • No sensitive data in UserDefaults
  • No logging of PII in production builds

13.5 Review Preparation Checklist#

  • Demo account created (apple-review@veritas.news)
  • Demo account has Premium subscription active
  • Demo account has sample data (bookmarks, reading history)
  • App Review Notes prepared
  • Backend API accessible (no IP restrictions)
  • No test/debug content in production build
  • No placeholder screens or "coming soon" features
  • All links in the app functional (privacy policy, terms, etc.)
  • Content available for review (articles loaded)
  • Crash-free session verified on latest iOS

13.6 Build and Upload Checklist#

  • Archive created with Release configuration
  • Code signing with Apple Distribution certificate
  • App Store provisioning profile used
  • Bitcode enabled (if required by Xcode version)
  • dSYM files generated for crash symbolication
  • .ipa validated with xcrun altool --validate-app
  • .ipa uploaded with xcrun altool --upload-app or Xcode Organizer
  • Build appears in App Store Connect
  • Build processing complete (wait for Apple processing)
  • External testing group set up in TestFlight (optional)

14. Post-Submission Monitoring#

14.1 Review Timeline#

Phase Expected Duration
Upload processing 1-24 hours
In review 24-48 hours
Review response Within 48 hours
Total (optimistic) 2-3 days
Total (with rejection) 5-10 days

14.2 Rejection Response Plan#

If the app is rejected, Apple provides specific guideline references. Common response strategies:

  1. Guideline 4.2 rejection: Add more native features, improve native navigation, provide detailed notes explaining unique value proposition
  2. Privacy rejection: Update PrivacyInfo.xcprivacy, correct nutrition labels
  3. Content rejection: Add content moderation, age-gate, or editorial guidelines
  4. IAP rejection: Ensure all digital content purchases use Apple IAP, remove alternative payment references
  5. Metadata rejection: Fix screenshots, description, or inappropriate keywords

14.3 Post-Launch Monitoring#

Metric Target Tool
Crash-free sessions > 99.5% App Store Connect
App Store rating > 4.0 stars App Store Connect
Download conversion > 30% App Store Analytics
Day 1 retention > 40% Custom analytics
Day 7 retention > 25% Custom analytics
Trial-to-paid > 15% Subscription reports

15. Appendices#

Appendix A: File Inventory#

Source Files Analyzed:

File Purpose
apps/veritas/web/package.json Web app dependencies and scripts
apps/veritas/web/next.config.mjs Next.js configuration with security headers
apps/veritas/web/public/manifest.json PWA manifest with icons, shortcuts, share target
apps/veritas/web/src/app/[locale]/layout.tsx Root layout with PWA metadata and Apple Web App config
apps/veritas/web/src/app/globals.css Global styles with PWA, safe area, dark mode support
apps/veritas/web/src/i18n/config.ts 6-language i18n configuration
apps/veritas/web/src/messages/en.json English translations (250+ keys)
apps/veritas/web/src/messages/tw.json Twi translations
apps/veritas/api/src/domain/subscriptions.ts Subscription tiers, pricing, features, limits
apps/veritas/api/src/interfaces/http/routes/v1/auth.ts Authentication endpoints
apps/veritas/api/src/interfaces/http/routes/v1/subscriptions.ts Subscription management API
apps/veritas/api/src/interfaces/http/routes/v1/data-protection.ts DPA compliance endpoints
apps/veritas/api/src/interfaces/http/routes/v1/payments.ts Payment processing (MoMo, Stripe)
apps/veritas/api/src/interfaces/http/routes/v1/ads.ts Self-served advertising
apps/veritas/api/src/interfaces/http/routes/v1/tips.ts Anonymous tips with encryption
apps/veritas/api/src/interfaces/http/routes/v1/preferences.ts User preferences
apps/veritas/api/src/infrastructure/auth/accessToken.ts JWT token management
apps/veritas/api/src/infrastructure/crypto/encryption.ts AES-256-GCM encryption

Appendix B: Environment Variables for iOS Build#

bash
# Apple Developer
APPLE_TEAM_ID=                    # Apple Developer Team ID
APPLE_BUNDLE_ID=news.veritas.app  # Bundle identifier
APPLE_APP_STORE_CONNECT_API_KEY=  # App Store Connect API key
APPLE_APP_STORE_CONNECT_ISSUER=   # API key issuer ID

# Push Notifications
APNS_KEY_ID=                      # APNs authentication key ID
APNS_KEY_PATH=                    # Path to .p8 key file
APNS_TEAM_ID=                     # Same as APPLE_TEAM_ID

# StoreKit
APPLE_SHARED_SECRET=              # Shared secret for receipt validation
APP_STORE_SERVER_API_KEY=         # App Store Server API key

# Build
IOS_CODE_SIGN_IDENTITY=Apple Distribution
IOS_PROVISIONING_PROFILE=Veritas News App Store

Appendix C: App Store Review Guidelines Reference#

Guideline Topic Relevance to Veritas
1.1.6 False Information Fact-checking core feature
1.1.7 Exploiting Tragedies News content editorial standards
1.2 User-Generated Content Tips/feedback feature
3.1.1 In-App Purchase Subscription billing
3.1.2 Subscriptions Auto-renewable subs
4.2 Minimum Functionality PWA wrapping risk
4.2.2 Content Aggregator News aggregation risk
5.1.1 Data Collection and Storage Privacy policy, data handling
5.1.2 Data Use and Sharing Third-party data sharing
5.1.2(i) AI Data Sharing AI fact-checking disclosure
5.2 Intellectual Property Content licensing

Appendix D: Pricing Comparison (Ghana Market)#

Competitor Monthly Price Annual Price
Veritas Premium GH₵49.99 GH₵499.99
Veritas Student GH₵24.99 GH₵249.99
Veritas Family GH₵74.99 GH₵749.99
Apple News+ $12.99 (US) —
The New York Times $4/month $48/year
The Economist $20/month $189/year
Graphic Online (GH) Free —
GhanaWeb Free —

Market Positioning: Veritas Premium at GH₵49.99/month (~$3.20 USD at current rates) is competitively priced for the Ghana market, significantly below international news subscription prices while offering unique AI-powered features.

Appendix E: iOS App Icon Specifications#

All icon sizes auto-generated from the 1024x1024 App Store icon:

Size (pt) Scale Pixels Usage
20 2x 40x40 Notification (iPhone)
20 3x 60x60 Notification (iPhone)
29 2x 58x58 Settings (iPhone)
29 3x 87x87 Settings (iPhone)
40 2x 80x80 Spotlight (iPhone)
40 3x 120x120 Spotlight (iPhone)
60 2x 120x120 App Icon (iPhone)
60 3x 180x180 App Icon (iPhone)
20 1x 20x20 Notification (iPad)
20 2x 40x40 Notification (iPad)
29 1x 29x29 Settings (iPad)
29 2x 58x58 Settings (iPad)
40 1x 40x40 Spotlight (iPad)
40 2x 80x80 Spotlight (iPad)
76 1x 76x76 App Icon (iPad)
76 2x 152x152 App Icon (iPad)
83.5 2x 167x167 App Icon (iPad Pro)
1024 1x 1024x1024 App Store

Note: Xcode 15+ with a single 1024x1024 icon can auto-generate all required sizes. No manual asset catalog creation needed if using the "Single Size" option in the asset catalog.