HeraldMeld - Morning Briefing App with AI Voice, News & Weather | Flutter

HeraldMeld - AI Daily Briefing App | Flutter + NestJS Full-Stack

A complete, production-ready AI briefing platform built with Flutter, NestJS, and React. Generates personalized daily audio briefings by combining weather, calendar, tasks, news, and motivational quotes — synthesized into natural AI voice — with gamification, subscriptions, and 90 REST endpoints.

🚀 Key Features

🎙️ Daily Briefing System

• AI generates a personalized audio briefing every morning — 7 segments: greeting, weather, calendar, news, todos, quote, closing

• OpenAI TTS with 6 natural voices (Alloy, Echo, Fable, Onyx, Nova, Shimmer)

• Full audio player — play/pause, segment navigation, progress tracking

• Briefing history with replay and listen status

• Customizable schedule, segment order, and voice preferences

📡 Content Sources

• Weather — Real-time + 5-day forecast via OpenWeatherMap

• Calendar — Full CRUD with all-day events, color coding, and recurrence

• Task Management — Todos with priority levels, due dates, and categories

• News Feed — 15 topic categories with AI-generated 2–3 sentence summaries

🤖 AI Features

• AI Briefing Coach — GPT-4o-mini chat for news analysis, productivity tips, and Q&A

• AI News Summaries — automatic article summarization

• AI Motivational Quotes — daily generated quotes for briefing closing

• Automated Cron reminders — hourly briefing alerts, task due-date notifications, weekly summaries

🏆 Gamification & Engagement

• 20 achievements across 8 categories (Briefing, Streak, News, AI, Productivity & more)

• XP & level system — earn XP for listening, completing tasks, using AI coach

• Daily streaks — consecutive listening days tracking

• Global leaderboard · Analytics dashboard with 30-day listening patterns

🔔 Push Notifications (Multi-Channel)

• Firebase Cloud Messaging — real FCM with device token management

• WebSocket — real-time instant delivery via Socket.io

• 7 notification types: briefing reminder, task alert, breaking news, achievement, subscription expiring & more

⚙️ More Features

• 31 Mobile Screens — complete user journey from onboarding to settings

• Auth — Email/OTP, Google Sign-In, Apple Sign-In · JWT auto-refresh

• Admin Dashboard — user management, briefing stats, feedback, subscription tracking

• Multi-Language — in-app language switcher

• 4 CI/CD Pipelines — GitHub Actions for mobile, backend, frontend, and production deploy

🛠️ Tech Stack

📱 Mobile App (Flutter)

• Flutter 3.2+ / Dart — iOS & Android, 31 screens

• State management: Riverpod · Navigation: GoRouter

• Payments: in_app_purchase (Apple StoreKit + Google Play Billing)

• Notifications: Firebase FCM · Auth: Google Sign-In, Apple Sign-In, JWT

⚙️ Backend (NestJS)

• NestJS 11 (TypeScript) — 21 modules, 90 REST endpoints + WebSocket

• Database: PostgreSQL (30 tables) · Cache & queue: Redis + BullMQ

• AI: OpenRouter (GPT-4o-mini) · TTS: OpenAI (6 voices) · Weather: OpenWeatherMap

• Storage: Cloudflare R2 · Email: AWS SES · Realtime: Socket.io

• Swagger API docs at /docs · 3 SQL migrations with seed data

🌐 Frontend

• React + Tailwind CSS landing page (Landing, Privacy, Terms)

• 4 GitHub Actions CI/CD workflows

💳 Subscription Plans

• Free — 1 briefing/day, 3 news topics, 5 AI coach credits, 20 todos

• Premium Monthly — $4.99/mo — Unlimited briefings, all 15 news topics, unlimited AI

• Premium Yearly — $39.99/yr — Same as monthly, best value

• 7-day free trial · Apple StoreKit + Google Play · Server-side receipt verification

📦 What's Included

• 📱 Full Flutter source code — iOS & Android (31 screens)

• ⚙️ NestJS backend — 21 modules, 90 endpoints, 30-table schema, 3 migrations + seed data

• 🌐 React + Tailwind CSS landing page

• 🔄 4 GitHub Actions CI/CD workflows

• 📋 Environment config template

• 📖 Swagger API docs (auto-generated)

✅ Requirements

• Flutter 3.2+ · Android Studio / Xcode

• Node.js 18+ · PostgreSQL · Redis

• OpenAI API key (TTS) · OpenRouter API key (AI chat) · OpenWeatherMap key

• Firebase project · Cloudflare R2 · AWS SES

🎙️ Your morning briefing, powered by AI.  |  📊 21 modules · 90 endpoints · 30 tables · 31 screens