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#
- Executive Summary
- App Binary Preparation
- App Store Connect Metadata
- App Store Assets
- Privacy Details (Nutrition Labels)
- Privacy Manifest File
- Age Rating Questionnaire
- In-App Purchases and Subscriptions
- App Review Preparation
- Capacitor Configuration
- Xcode Project Configuration
- Native Feature Integration
- Pre-Submission Checklist
- Post-Submission Monitoring
- 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:
{
"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:
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:
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):
{
"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:
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 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):
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#
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#
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)#
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 1024x1024public/icon-192.png(192x192) — Too smallpublic/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.
4.3 App Previews (Optional but Recommended)#
| 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):
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 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:
- StoreKit Configuration File — Map product IDs to App Store Connect
- Transaction Listener — Handle purchase completions, renewals, cancellations
- Receipt Validation — Server-side validation via App Store Server API v2
- Subscription Status — Sync between Apple and Veritas API subscription records
- Restore Purchases — Required button in subscription settings
- 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):
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 |
|---|---|
| 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#
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
/privacywithin 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/:userIdAPI 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#
# 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) |
10.3 Additional Recommended Plugins#
# 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:
<!-- 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:
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#
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#
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#
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:
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#
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();
}
});
12.7 Universal Links (Deep Linking)#
Apple App Site Association file at
https://veritas.news/.well-known/apple-app-site-association:
{
"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
nmon 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-appor 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:
- Guideline 4.2 rejection: Add more native features, improve native navigation, provide detailed notes explaining unique value proposition
- Privacy rejection: Update PrivacyInfo.xcprivacy, correct nutrition labels
- Content rejection: Add content moderation, age-gate, or editorial guidelines
- IAP rejection: Ensure all digital content purchases use Apple IAP, remove alternative payment references
- 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#
# 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.