Eve library

Veritas Product Features

Guide

Revision 1

On this page

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#

  1. Executive Summary
  2. News Ingestion and Aggregation
  3. AI Editorial Pipeline
  4. Fact-Checking and Verification
  5. Bias Detection and Balance
  6. Content Generation
  7. Multimedia Production
  8. Live Streaming
  9. Social Media Distribution
  10. Reader Experience
  11. Multilingual Support
  12. Subscription and Monetization
  13. B2B API Platform
  14. USSD and Feature Phone Access
  15. Investigative Journalism Tools
  16. Election Coverage and Compliance
  17. Knowledge Graph and Entity Intelligence
  18. Analytics and Intelligence
  19. Notifications and Alerts
  20. Community Engagement
  21. Platform Availability
  22. Access Tiers
  23. 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:

  1. Draft Generation -- AI generates initial article drafts from ingested source material, maintaining attribution and adding context
  2. Fact-Check Review -- The Fact-Checker agent verifies claims, flags unverified statements, and adds evidence links
  3. Managing Editor QC -- The Managing Editor reviews for editorial standards, clarity, balance, and accuracy
  4. Editor-in-Chief Approval -- Final review and approval before publication
  5. 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
Instagram Reels, Stories (multi-segment), feed posts Fully automated
Facebook Page posts, video, links Fully automated
WhatsApp Business Channel broadcasts, news summaries Fully automated
Telegram Channel posts with polls, media, formatted text Fully automated
LinkedIn 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 Instagram Graph API Available Reels, Stories, feed posts
WhatsApp 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