Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs center. This file is its operational companion (service topology, APIs, schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
AI-Powered News Agency for Ghana and West Africa
Veritas is an autonomous AI-powered news agency that ingests, analyzes, fact-checks, produces, and distributes verified news across every major digital channel. Built for Ghana and West Africa, Veritas delivers multilingual, multimedia news -- from automated article generation to 24/7 live streaming -- while maintaining editorial integrity through AI-powered fact-checking, bias detection, and compliance monitoring.
Table of Contents#
- Executive Summary
- News Ingestion and Aggregation
- AI Editorial Pipeline
- Fact-Checking and Verification
- Bias Detection and Balance
- Content Generation
- Multimedia Production
- Live Streaming
- Social Media Distribution
- Reader Experience
- Multilingual Support
- Subscription and Monetization
- B2B API Platform
- USSD and Feature Phone Access
- Investigative Journalism Tools
- Election Coverage and Compliance
- Knowledge Graph and Entity Intelligence
- Analytics and Intelligence
- Notifications and Alerts
- Community Engagement
- Platform Availability
- Access Tiers
- Integration Features
Executive Summary#
Veritas operates as a complete newsroom-in-a-box. Its core value proposition is delivering verified, balanced news at scale without the overhead of a traditional newsroom. The platform handles every stage of the news lifecycle:
| Stage | What Veritas Does |
|---|---|
| Discover | Ingests from 300+ RSS feeds, sitemaps, and social media sources |
| Analyze | NLP pipeline: sentiment, topics, entities, language, embeddings |
| Verify | Automated claim extraction, evidence retrieval, fact-checking |
| Score | Political bias analysis with Ghana Political Lean (GPL) scoring |
| Produce | AI-generated articles, video, audio, podcasts, and social content |
| Edit | Seven AI agents simulate a professional newsroom editorial process |
| Distribute | Pushes to web, mobile, YouTube, TikTok, Instagram, WhatsApp, USSD |
| Monetize | Subscriptions, ads, mobile money, B2B API licensing |
Key Numbers#
| Metric | Value |
|---|---|
| Content Sources | 300+ Ghanaian news outlets |
| Supported Languages | 6 (English + 5 Ghanaian) |
| AI Newsroom Agents | 7 specialized roles |
| Social Platforms | 8+ distribution channels |
| API Endpoints | 80+ REST endpoints |
| Payment Providers | 5 (including mobile money) |
News Ingestion and Aggregation#
Automated Source Collection#
Veritas continuously monitors and ingests content from across the Ghanaian media landscape:
- RSS Feed Monitoring -- Scheduled polling of 300+ Ghanaian news outlet RSS feeds with configurable refresh intervals per source
- Sitemap Crawling -- Deep sitemap discovery and parsing for outlets that publish sitemaps alongside RSS feeds
- Social Media Monitoring -- Tracks breaking news and trending topics from X/Twitter and Facebook pages of major outlets
- Source Reliability Scoring -- Each source is scored for reliability based on historical accuracy, editorial standards, and correction frequency
Content Processing#
Once ingested, every piece of content passes through an automated processing pipeline:
- Semantic Deduplication -- Uses pgvector embeddings to detect and merge duplicate or near-duplicate stories from different sources
- Language Detection -- Automatically identifies whether content is in English, Twi, Ewe, Ga, Hausa, or Dagbani
- Content Normalization -- Standardizes headlines, timestamps, author attribution, and media assets across different source formats
- Media Extraction -- Pulls featured images, embedded videos, and other media assets with proper attribution
- Source Attribution Tracking -- Maintains full provenance records linking every article back to its original source
Story Clustering#
Related articles are automatically grouped into coherent story threads:
- Semantic Story Grouping -- Clusters articles covering the same event or topic using embedding similarity
- Timeline Construction -- Builds chronological timelines showing how a story has developed across sources
- Multi-Source Perspective View -- Presents the same story from multiple outlets side by side, highlighting differences in framing
AI Editorial Pipeline#
Seven Specialized AI Agents#
Veritas simulates a professional newsroom with seven AI agents, each with distinct roles and priorities:
| Agent | Priority | Responsibilities |
|---|---|---|
| Editor-in-Chief | 10 | Final editorial decisions, content approval, standards |
| Managing Editor | 9 | Content editing, quality control, editorial standards |
| Fact-Checker | 8 | Claim verification, evidence retrieval, accuracy scoring |
| Journalist (Investigative) | 7 | Deep investigative reporting, source analysis |
| Journalist (Political) | 7 | Political coverage, election reporting, government news |
| Content Strategist | 6 | Trending topics, content planning, audience insights |
| Social Media Mgr | 5 | Social posting, platform optimization, engagement |
Editorial Workflow#
Content flows through a structured editorial pipeline:
- Draft Generation -- AI generates initial article drafts from ingested source material, maintaining attribution and adding context
- Fact-Check Review -- The Fact-Checker agent verifies claims, flags unverified statements, and adds evidence links
- Managing Editor QC -- The Managing Editor reviews for editorial standards, clarity, balance, and accuracy
- Editor-in-Chief Approval -- Final review and approval before publication
- Scheduling -- Content is scheduled for optimal publication timing based on traffic patterns and audience behavior
Content Management System#
The built-in CMS provides full editorial control:
- Draft, Review, Schedule, Publish, Archive -- Complete lifecycle management for all content types
- Revision History -- Full version history with content diffing between revisions
- Priority-Based Scheduling -- Peak traffic window optimization with Ghana timezone-aware quiet hours (Africa/Accra)
- AI-Powered Quality Control -- Automated quality reviews at each stage of the editorial pipeline
Fact-Checking and Verification#
Automated Claim Extraction#
Veritas automatically identifies verifiable claims within articles:
- Claim Detection -- NLP-powered identification of factual claims, statistics, quotes, and attributions within article text
- Claim Linking -- Connects extracted claims to their original sources and any related prior fact-checks
- Claim Classification -- Categorizes claims by type (statistical, quote, prediction, policy, historical)
Evidence Retrieval and Scoring#
For each extracted claim, Veritas searches for supporting or contradicting evidence:
- Cross-Reference Search -- Searches the knowledge base, prior articles, and external databases for relevant evidence
- Evidence Quality Scoring -- Rates evidence quality based on source reliability, recency, and relevance
- Verdict Assignment -- Assigns verdicts (true, mostly true, mixed, mostly false, false, unverifiable) with confidence scores
- ClaimReview Structured Data -- Outputs fact-checks in Schema.org ClaimReview format for search engine integration
Source Credibility Tracking#
Every source in the system has a dynamic credibility score:
- Historical Accuracy Tracking -- Tracks the accuracy record of each source over time
- Correction Monitoring -- Notes when sources issue corrections and how promptly
- Reliability Scoring -- Aggregate reliability scores inform how much weight claims from each source receive
Bias Detection and Balance#
Ghana Political Lean (GPL) Scoring#
Veritas provides a unique Ghana-specific political bias analysis system:
- Political Spectrum Analysis -- Scores content on a political lean spectrum tailored to the Ghanaian political landscape
- Coverage Balance Analysis -- Measures whether coverage of political topics gives proportional representation to different political perspectives
- Coverage Blindspot Detection -- Inspired by Ground News, identifies topics and perspectives that are underrepresented in coverage
Bias Transparency#
Users see bias information integrated directly into their reading experience:
- Bias Score Badges -- Every article displays its political lean score
- Multi-Source Comparison -- Side-by-side views showing how different outlets with different political leanings cover the same story
- Source Diversity Indicators -- Highlights when a story is being covered by sources from across the political spectrum versus only one side
Content Generation#
AI Article Generation#
Veritas generates original articles and reports using AI:
- News Article Drafting -- AI-generated articles from clustered source material with full attribution
- Weather Reports -- Automated weather summaries for Ghanaian regions
- Market Summaries -- Daily financial market overviews covering the Ghana Stock Exchange, Cedi exchange rates, and commodity prices
- Fuel Price Updates -- Automated tracking and reporting of fuel price changes across Ghana
- Trend Analysis -- AI-generated analysis of trending topics and emerging stories
AI Writing Assistant#
A built-in writing assistant helps journalists and editors:
- Draft Improvement -- Suggests improvements to clarity, conciseness, and readability
- Headline Generation -- Generates multiple headline options optimized for engagement and accuracy
- A/B Testing for Headlines -- Tests different headline variants to optimize click-through rates while maintaining editorial integrity
- Summary Generation -- Creates article summaries at different length levels
Multimedia Production#
AI Video Production#
Veritas produces broadcast-quality video content using AI:
- AI Anchor Avatars -- Lifelike AI news anchors powered by HeyGen, Tavus, and D-ID that read news scripts on camera
- Script-to-Video Pipeline -- Automated pipeline that converts written scripts into complete video segments with anchor shots, B-roll, lower thirds, and transitions
- B-Roll Insertion -- Intelligent insertion of relevant B-roll footage at appropriate points in the script, with Ghana-specific keyword detection
- Graphics Overlays -- Automated lower thirds, headline banners, bullet points, source citations, and breaking news banners
- Multi-Format Output -- Renders in 720p, 1080p, and 4K at 24/30/60fps with 16:9, 9:16 (vertical), and 1:1 (square) aspect ratios
YouTube Shorts and Short-Form Video#
Dedicated pipelines for short-form video across platforms:
- YouTube Shorts Production -- Automated creation of vertical news clips optimized for YouTube Shorts format
- TikTok Video -- Platform-specific formatting with trending sounds, hashtags, and caption optimization
- Instagram Reels -- Reels production with Instagram-optimized formatting, hashtags, and engagement hooks
- Caption and Subtitle Generation -- Automated captioning in all supported languages
Audio and Podcast Production#
Full audio content production capabilities:
- Text-to-Speech -- AI voice synthesis in English (via ElevenLabs) and Ghanaian languages (via Ghana NLP Khaya) for audio versions of articles
- Voice Profiles -- Multiple anchor voice personas with distinct characteristics, tones, and language specializations
- Podcast Series -- Automated podcast episode production with scheduled recording, editing, and distribution
- Radio Syndication -- Audio formatting for radio broadcast partners
- Voice Assistant Integration -- Content formatted for voice assistant platforms
Live Streaming#
24/7 YouTube Live Infrastructure#
Veritas operates a continuous live news stream:
- RTMP Server -- Custom RTMP ingest server for live broadcast
- Multi-Platform Push -- Simultaneous streaming to YouTube Live and other platforms
- Lower-Thirds Graphics -- Real-time on-screen graphics including anchor names, headlines, and breaking news banners
- Breaking News Overlays -- Automatic breaking news alerts that interrupt regular programming
Interactive Viewer Q&A#
Live stream viewers can interact directly with AI anchors:
- Multi-Channel Question Submission -- Accept questions from YouTube Live Chat, X/Twitter, Instagram, Facebook, Telegram, web forms, mobile app, and SMS
- AI-Powered Moderation -- Automatic question screening with profanity filters, spam detection, duplicate detection, and sentiment analysis
- AI Response Generation -- AI generates anchor responses with source citations and fact-check verification
- Conversational Video Intelligence -- Tavus CVI integration for interactive, conversational AI responses during live broadcasts
- Priority Queue -- Questions are prioritized by relevance, upvotes, and viewer engagement
- Engagement Analytics -- Real-time metrics on questions received, sources, sentiment distribution, and response times
Social Media Distribution#
Platform Coverage#
Veritas distributes content across eight major social platforms:
| Platform | Content Types | Automation Level |
|---|---|---|
| YouTube | Long-form video, Shorts, Live streaming | Fully automated |
| TikTok | Short-form video with trending sounds/hashtags | Fully automated |
| Reels, Stories (multi-segment), feed posts | Fully automated | |
| Page posts, video, links | Fully automated | |
| Business Channel broadcasts, news summaries | Fully automated | |
| Telegram | Channel posts with polls, media, formatted text | Fully automated |
| Professional news updates, analysis | Fully automated | |
| X/Twitter | Breaking news, thread creation, monitoring | Fully automated |
Intelligent Scheduling#
Content distribution is optimized for maximum engagement:
- Unified Cross-Platform Scheduler -- Single scheduling engine manages posting across all platforms with conflict detection and resolution
- Optimal Time Window Calculation -- AI determines the best posting times for each platform based on Ghana timezone audience patterns
- Breaking News Staggering -- Breaking news is posted in a specific platform priority order (fastest platforms first) with configurable delays
- Content Pillar Rotation -- Ensures variety in content types posted to each platform
- Virality Scoring -- AI scores content candidates for viral potential on each platform using platform-specific signals
Platform-Specific Optimization#
Each platform receives content tailored to its format:
- TikTok -- Trending sound matching, hashtag optimization, caption strategy optimization, and content pillar balancing
- Instagram Reels -- Hashtag sets, caption optimization, and engagement hook templates
- Instagram Stories -- Multi-segment stories with polls, stickers, breaking news hooks, and category-specific visual styles
- WhatsApp -- Formatted message templates with media attachments, subscriber management, and broadcast orchestration
- Telegram -- HTML-formatted posts, polls, hashtags, and media grouping
Growth and Partnership Automation#
Automated audience growth and partnership management:
- Platform Growth Targets -- Set subscriber/follower targets per platform with AI-generated growth plans
- Engagement Automation -- AI-powered community engagement with sentiment monitoring and crisis detection
- Influencer Discovery -- Automated identification of relevant influencers for partnership opportunities
- Partnership Proposal Generation -- AI-generated collaboration proposals for potential partners
- Affiliate Tracking -- Automated affiliate event tracking and performance reporting
Channel Ecosystem Management#
Manage the complete multi-channel presence from a single dashboard:
- Channel Branding -- Platform-specific branding plans for each channel
- Content Routing -- Rules-based routing of content to appropriate channels based on topic, format, and audience
- Cross-Promotion -- Automated cross-promotion between channels
- Membership Tiers -- Platform-specific membership programs with exclusive content and perks
- Unified Analytics Dashboard -- Consolidated analytics across all channels
Reader Experience#
Web Application (PWA)#
The web application is a Progressive Web App with full offline capabilities:
- Responsive Design -- Adapts seamlessly to desktop, tablet, and mobile screens
- Internationalization -- Full i18n support with locale-based routing for all six supported languages
- Offline Mode -- Service worker caching enables reading cached articles without an internet connection
- Reading Mode -- Distraction-free reading experience with customizable typography (font family, font size), themes (light, dark, sepia), and reading progress tracking
- Reading Statistics -- Tracks reading time, articles read, and reading history
- Search with Autocomplete -- Full-text article search with autocomplete suggestions, faceted filtering by category, topic, language, source, and bias
Mobile Application#
Native mobile experience via Expo/React Native:
- Offline Reading -- Download articles for offline access
- Push Notifications -- Breaking news and personalized alerts via FCM
- Audio Playback -- Listen to AI-narrated versions of articles
- Customizable Themes -- Light and dark mode support
- Accessibility -- Full accessibility features with screen reader support
Content Discovery#
Users can discover content through multiple pathways:
- Trending Stories -- Real-time trending articles based on view counts and engagement within configurable time windows
- Personalized Recommendations -- Collaborative and content-based filtering suggests articles based on reading history and preferences
- User Preferences -- Users set preferred topics, categories, languages, and sources for personalized feeds
- Related Articles -- Semantic similarity-based article recommendations
- Story Timelines -- Follow developing stories across multiple articles and sources
Multilingual Support#
Six Ghanaian Languages#
Veritas supports the major languages of Ghana:
| Language | Region | TTS Provider | Features |
|---|---|---|---|
| English | National | ElevenLabs | Full NLP, TTS, generation, search |
| Twi | Ashanti, most regions | Ghana NLP (Khaya) | TTS, translation, NER |
| Ewe | Volta Region | Ghana NLP (Khaya) | TTS, translation, NER |
| Ga | Greater Accra | Ghana NLP (Khaya) | TTS, translation, NER |
| Hausa | Northern Ghana | Ghana NLP (Khaya) | TTS, translation, NER |
| Dagbani | Northern Ghana | Ghana NLP (Khaya) | TTS, translation, NER |
Language Features#
- Code-Switching Detection -- Identifies when text switches between languages (common in Ghanaian English), enabling appropriate NLP processing
- Ghanaian English Normalization -- Handles Ghanaian English idioms and expressions in NLP analysis
- Translation -- Article translation between all supported languages via Ghana NLP Khaya API
- Language-Specific Search -- Search results can be filtered by language
- Language-Specific Feeds -- Content feeds filtered by language preference
Subscription and Monetization#
Subscription Plans#
Veritas offers tiered subscription plans:
- Free Tier -- Basic access with limited article views, ads displayed
- Premium Tier -- Unlimited articles, reading mode, audio articles, ad-free experience, priority content
- Family Plan -- Premium access for up to 6 family members with invite/ accept/decline/leave workflows
- Student Plan -- Discounted access with student verification via email domain, ID upload, or enrollment letter
Subscription Management#
Full subscription lifecycle management:
- Subscribe, Upgrade, Downgrade, Cancel, Resume, Pause, Unpause -- Complete lifecycle operations
- Usage Tracking -- Monthly and per-feature usage monitoring with configurable limits
- Feature Access Control -- Granular feature gating (reading mode, audio articles, ad-free, API access, etc.)
- Subscription History -- Complete history of plan changes and billing events
- Subscription Analytics -- Revenue analytics, churn tracking, and plan distribution metrics
Payment Methods#
Designed for the Ghanaian market with local payment support:
| Provider | Type | Region |
|---|---|---|
| Stripe | Credit/Debit | Global |
| Paystack | Local payments | Ghana |
| MTN MoMo | Mobile money | Ghana |
| Vodafone Cash | Mobile money | Ghana |
| AirtelTigo | Mobile money | Ghana |
Advertising#
- Ad Serving -- Integrated ad display for free-tier users
- Ad Network Management -- Manage multiple ad network integrations
- Paywall System -- Configurable paywall for premium content
Tipping#
- Reader Tips -- Readers can send tips (payments) to support journalism
B2B API Platform#
News Feed API#
Third-party partners can access Veritas content programmatically:
- Article Feed -- Paginated, filterable article feed with engagement metrics, entity mentions, bias scores, and full metadata
- Trending Articles -- Trending content within configurable time windows
- Article Detail -- Full article content with body text, entities, and engagement data
Search API#
- Full-Text Faceted Search -- Search articles with faceted aggregations by category, topic, source, language, and bias
- Autocomplete Suggestions -- Type-ahead suggestions for search queries
Fact-Check API#
- Claim Listing -- Browse fact-checked claims with ClaimReview structured data
- Claim Detail -- Full claim detail with evidence and verdict
- Claim Search/Verification -- Submit a claim text and receive matching fact-checks
Entity API#
- Entity Search -- Search named entities (people, organizations, locations, events, products, legislation, concepts)
- Entity Detail -- Full entity profiles with metadata and aliases
- Entity-Article Relationships -- Find all articles mentioning a specific entity with sentiment scores
- Entity Relationship Graph -- Explore relationships between entities (leads, member of, located in, founded, works for, related to, opposes, allies with, subsidiary of, parent of)
Media API#
- Media Asset Listing -- Browse media assets (images, video, audio, documents, embeds) with filters by article, kind, and role
- Media Search -- Search media by alt text, caption, and credit
- Article Media -- Get all media associated with a specific article
Monitoring and Alerts API#
- Alert Subscriptions -- Create keyword, topic, entity mention, breaking news, fact-check, source, or sentiment change alerts
- Webhook Delivery -- Receive alert notifications via webhook or email
- Alert Frequency Control -- Configure instant, hourly, daily, or weekly alert delivery
- Monitoring Dashboard -- API usage statistics and monitoring metrics
Developer SDKs#
- TypeScript SDK -- Full-featured TypeScript/JavaScript SDK with typed methods for all API endpoints
- Python SDK -- Async and sync Python SDK with comprehensive API coverage
API Key Management#
- Scoped API Keys -- Fine-grained permission scopes (articles:read, search:read, claims:read, claims:search, entities:read, entities:write, analytics:read)
- Rate Limiting -- Per-key rate limits with configurable hourly and daily quotas
- Usage Metering -- Automatic tracking of API usage per key, endpoint, and time period
- Sandbox Environment -- Test API keys with sandbox endpoints for development
USSD and Feature Phone Access#
Telco Gateway Integration#
Veritas reaches users without smartphones through USSD menus:
- MTN Gateway -- Integration with Ghana's largest mobile network
- Vodafone Gateway -- Integration with Vodafone Ghana
- AirtelTigo Gateway -- Integration with AirtelTigo Ghana
- Glo Gateway -- Integration with Globacom
USSD Menu System#
- Multilingual Menus -- USSD menus available in English and Twi
- Category Navigation -- Browse news by category through numbered menu options
- Article Delivery -- Articles formatted for USSD character limits with pagination for longer content
- Session Management -- Stateful USSD sessions with timeout handling
Voice Callback#
- Text-to-Voice -- Articles converted to voice for delivery via phone call
- Voice Callback Requests -- Users can request a callback to hear news read aloud
- Multi-Provider Support -- Voice delivery through multiple telephony providers
Investigative Journalism Tools#
Anonymous Tip Submission#
- Encrypted Tips -- Tips are encrypted at rest using AES-256-GCM for source protection
- Anonymous Submission -- Tips can be submitted without identification
- Evidence Attachment -- Support for attaching documents and media as evidence
- Contact Options -- Optional encrypted contact information for follow-up
Research Assistant#
- AI Research Tools -- AI-powered research assistance for journalists investigating stories
- Knowledge Base Search -- RAG-powered search across the full article archive and knowledge base
Election Coverage and Compliance#
Ghana Election Compliance Framework#
Veritas includes comprehensive election coverage compliance tools:
- Constitutional Provisions Reference -- Database of Ghanaian constitutional provisions relevant to election coverage
- Coverage Guidelines -- Election coverage guidelines reference for editorial staff
- Election Offences Reference -- Database of election offences under Ghanaian law
Election Phase Awareness#
- Phase Detection -- Automatic detection of current election phase (pre-election, campaign, silence period, election day, post-election)
- Silence Period Enforcement -- Automatic content compliance checking during the constitutionally mandated silence period before elections
Compliance Checking#
- Content Compliance Check -- Automated analysis of article text for election coverage compliance
- Coverage Balance Analysis -- Measures whether election coverage gives proportional representation to registered political parties
- Violation Tracking -- Records and tracks coverage violations for audit and compliance reporting
- Political Party Database -- Maintains current list of registered political parties for balance analysis
Knowledge Graph and Entity Intelligence#
Named Entity Recognition and Tracking#
- Entity Extraction -- AI-powered extraction of people, organizations, locations, events, products, legislation, and concepts from articles
- Entity Profiles -- Rich profiles with aliases, descriptions, images, and metadata
- Entity Mention Tracking -- Tracks every mention of an entity across all articles with mention count, sentiment, and context
Entity Relationship Graph#
- Relationship Types -- Ten relationship types: leads, member of, located in, founded, works for, related to, opposes, allies with, subsidiary of, parent of
- Confidence Scoring -- Each relationship has a confidence score
- Graph Navigation -- Navigate the entity relationship graph to discover connections between people, organizations, and events
Analytics and Intelligence#
Content Analytics#
- Article Performance -- View counts, engagement metrics, and read time tracking per article
- Content Trends -- Identify trending topics, emerging stories, and content gaps
- Source Performance -- Analytics on which sources drive the most engagement
Social Media Analytics#
- Per-Platform Metrics -- Detailed performance metrics for each social platform (views, engagement, shares, comments)
- Cross-Platform Comparison -- Compare performance across all distribution channels
- Posting Time Analysis -- Identify optimal posting windows based on historical engagement
- Hashtag Effectiveness -- Track which hashtags drive the most engagement
- Content Pillar Performance -- Measure effectiveness of different content categories per platform
- Virality Tracking -- Monitor which content achieves viral distribution
Revenue Analytics#
- Subscription Analytics -- Revenue, churn, plan distribution, and growth metrics
- Ad Revenue Tracking -- Advertising revenue analytics
- B2B API Usage Analytics -- Track API partner usage and revenue
Real-Time Dashboard#
- Real-Time Data Feeds -- Live metrics streaming for operational monitoring
- Breaking News Monitoring -- Real-time monitoring of breaking news events
Notifications and Alerts#
Push Notifications#
- FCM Push -- Firebase Cloud Messaging push notifications to mobile devices
- Breaking News Alerts -- Immediate push for breaking news events
- Personalized Alerts -- Topic and entity-based notification preferences
Email Notifications#
- SMTP/SendGrid/SES -- Multi-provider email delivery
- Newsletter Campaigns -- Email newsletter creation and distribution
- Digest Emails -- Configurable daily or weekly news digests
Emergency Broadcasts#
- Emergency Alert Distribution -- Rapid distribution of emergency and safety information across all channels simultaneously
- Multi-Channel Emergency Push -- Simultaneous alerts across web, mobile, social, and USSD
Community Engagement#
Commenting System#
- Article Comments -- Threaded commenting on articles with moderation
Community Features#
- Community Engagement -- Community-driven features for reader interaction and participation
Platform Availability#
| Platform | Technology | Status | Key Features |
|---|---|---|---|
| Web (PWA) | Next.js 16, React 19 | Available | Offline support, i18n, reading mode |
| Mobile (iOS) | Expo/React Native | Available | Push notifications, offline, audio playback |
| Mobile (Android) | Expo/React Native | Available | Push notifications, offline, audio playback |
| REST API | Hono | Available | 80+ endpoints, OpenAPI docs, JWT auth |
| B2B API | Hono + SDKs | Available | TypeScript and Python SDKs |
| USSD | Telco gateway | Available | MTN, Vodafone, AirtelTigo, Glo |
| YouTube | YouTube Data/Live API | Available | Videos, Shorts, Live streaming |
| TikTok | TikTok API | Available | Short-form video automation |
| Instagram Graph API | Available | Reels, Stories, feed posts | |
| WhatsApp Business API | Available | Channel broadcasts | |
| Telegram | Telegram Bot API | Available | Channel posts with media |
| CLI | Commander.js | Available | Administrative and development tools |
Access Tiers#
Consumer Tiers#
| Feature | Free | Premium | Family | Student |
|---|---|---|---|---|
| Article reading | Limited | Unlimited | Unlimited | Unlimited |
| Article search | Yes | Yes | Yes | Yes |
| Trending articles | Yes | Yes | Yes | Yes |
| Bias scores | Yes | Yes | Yes | Yes |
| Fact-check access | Yes | Yes | Yes | Yes |
| Reading mode | No | Yes | Yes | Yes |
| Audio articles | No | Yes | Yes | Yes |
| Ad-free experience | No | Yes | Yes | Yes |
| Offline reading (mobile) | Limited | Full | Full | Full |
| Push notifications | Basic | Full | Full | Full |
| Family sharing (up to 6) | No | No | Yes | No |
| Student discount | No | No | No | Yes |
B2B API Tiers#
| Capability | Basic | Professional | Enterprise |
|---|---|---|---|
| News Feed API | Yes | Yes | Yes |
| Search API | Yes | Yes | Yes |
| Fact-Check API | No | Yes | Yes |
| Entity API | No | Yes | Yes |
| Media API | No | Yes | Yes |
| Monitoring/Alerts API | No | No | Yes |
| Rate limits (per hour) | Low | Medium | High |
| Webhook notifications | No | Yes | Yes |
| Dedicated support | No | No | Yes |
Integration Features#
Cross-Domain (Oshun Monorepo)#
- Shared Infrastructure -- Uses @oshun/database patterns and shared Docker Compose infrastructure (PostgreSQL, Redis, MinIO)
- Event Bus -- Publishes domain events for cross-domain coordination
External AI Services#
| Service | Integration Purpose |
|---|---|
| Anthropic Claude | LLM for editorial pipeline, content generation |
| OpenAI | Alternative LLM provider |
| HeyGen | AI video avatar rendering |
| D-ID | AI video avatar rendering |
| Tavus CVI | Conversational video intelligence for live Q&A |
| ElevenLabs | English text-to-speech |
| Ghana NLP (Khaya) | Ghanaian language TTS, NER, and translation |
| Cohere | Embeddings and reranking |
External Distribution Services#
| Service | Integration Purpose |
|---|---|
| YouTube Data API | Video uploads, channel management, analytics |
| YouTube Live API | 24/7 live streaming |
| TikTok API | Video uploads, analytics |
| Instagram Graph | Reels, Stories, feed posts |
| Facebook Graph | Page management, posts |
| WhatsApp Business | Channel broadcasts, subscriber management |
| Telegram Bot | Channel posts, polls, media |
| LinkedIn API | Professional content distribution |
Payment Integrations#
| Provider | Integration Purpose |
|---|---|
| Stripe | Global card payments and subscription billing |
| Paystack | Ghana local payment processing |
| MTN MoMo API | MTN Mobile Money integration |
| Vodafone Cash | Vodafone Mobile Money integration |
| AirtelTigo | AirtelTigo Mobile Money integration |
Notification Integrations#
| Service | Integration Purpose |
|---|---|
| FCM | Firebase Cloud Messaging for mobile push notifications |
| SendGrid | Transactional and marketing email delivery |
| AWS SES | Email delivery at scale |
| SMTP | Direct SMTP email delivery |