Complete, production-ready source code for a feature-rich Flutter news app mobile client.
This repository contains the complete, production-ready source code for a feature-rich Flutter news app mobile client. It gives you everything you need to launch your own news app on the App Store and Google Play, right out of the box. It is a key component of the Flutter News App Full Source Code Toolkit, an ecosystem that also includes a Dart Frog backend API and a web-based content management dashboard.
This app comes packed with all the features you need to launch a professional news application.
Click on any category to explore.
📰 Content Discovery & Feed
- Display news in a beautiful, performant, infinitely scrolling feed.
- Customizable Display: Users can personalize their feed by choosing headline density (compact, standard, comfortable) and image style (hidden, small thumbnail, large thumbnail).
- Rich In-Feed Decorators: Beyond simple calls-to-action, the feed dynamically injects items like
CallToActionItem(e.g., link account, upgrade, rate app, enable notifications) andContentCollectionItem(e.g., suggested topics/sources to follow), all managed by configurable rules and user interaction status.
💡 Your Advantage: You get a production-quality feed system instantly. Skip the months of complex UI work and state management. ⏱️
- Comprehensive Filtering: Let users filter headlines by
Topic,Source, andCountryusing a dedicated filter interface. - "Followed Items" Filter: Users can instantly filter the feed to show only content from their followed topics, sources, and countries.
- Unified Search: Includes a dedicated search page to help users find specific content quickly, with the ability to search across headlines, topics, sources, and countries.
🎯 Your Advantage: Give your users powerful content discovery tools that keep them engaged and coming back for more.
🔐 Security & Customization
- 📧 Email + Code (Passwordless) Sign-In: Modern and secure.
- 👤 Anonymous Sign-In: Allow users to explore before committing.
- 🔗 Account Linking: Seamlessly convert anonymous users to registered accounts, preserving all their personalized settings, content preferences, and saved headlines.
✅ Your Advantage: All the complex security and user management is already done for you, including data migration when users link their accounts.
- Content Preferences: Follow/unfollow
Topics,Sources, andCountrys. - Saved Headlines: Bookmark articles for easy access later.
- Decorator Interaction Tracking: User interactions with in-feed decorators (e.g., "Link Account" prompts) are tracked and persisted, ensuring a personalized and non-repetitive experience.
❤️ Your Advantage: Built-in personalization features that drive user retention and create a sticky app experience.
- Appearance: Configure base theme (Light/Dark/System), accent colors (via FlexColorScheme), font choices (family, size, weight).
- Feed Display: Customize how headlines are presented, including
HeadlineDensityandHeadlineImageStyle, and visibility of source/publish date. - Language Selection: Choose the application's display language.
🎨 Your Advantage: Deliver a premium, adaptable user experience that caters to individual needs without writing any code.
💰 Monetization & Remote Control
Go beyond basic ad banners. This app includes a sophisticated, provider-agnostic monetization engine designed for flexibility, performance, and a seamless user experience.
- Multi-Platform by Design: The entire ad system is built on a provider-agnostic abstraction, giving you the freedom to choose your monetization strategy. It comes with pre-built, production-ready providers for:
- Google AdMob Provider: The industry standard, ready to go out of the box.
- Local Ad Provider: Use a custom ad server to serve ads directly from your own backend, giving you full control over your ad inventory and revenue.
- Demo Ad Provider: A built-in placeholder provider that makes development and testing a breeze, without needing live ad network credentials.
- Seamless Integration, Not Intrusion: Ads are designed to complement your content, not detract from it.
- Theme-Aware Styling: Native ads automatically inherit their look and feel from the user's selected theme (light/dark mode, colors, fonts), making them feel like a natural part of the UI.
- Format-Aware Loading: The system intelligently requests the right ad format (e.g., small or large templates) to match the user's feed layout preferences, ensuring a perfect fit every time.
- Optimized for Performance: A fast, fluid user experience is paramount.
- Intelligent Caching: An
InlineAdCacheServiceefficiently caches native and banner ads to ensure buttery-smooth scrolling in feeds, minimizing network requests and eliminating UI jank. - Proactive Interstitial Loading: A dedicated manager pre-loads full-screen interstitial ads in the background, so they are ready to be displayed instantly during navigation without any lag.
- Intelligent Caching: An
- Powerful Remote Control: All ad behavior is driven by the backend
RemoteConfig. You can remotely control ad frequency, placement rules, and even switch the primary ad provider—all without shipping a new app update.
💸 Your Advantage: Start generating revenue from day one with a highly extensible and robust ad system that’s built to scale with your business.
Gain complete command over your application's operational state and user experience through a powerful, backend-driven control plane. This architecture empowers you to manage critical app behavior and content delivery with significant flexibility, eliminating the need for frequent app store updates.
- Real-time Configuration Management:
- Comprehensive Global Settings: Remotely manage all critical application parameters, including detailed advertising configurations, user preference limits, and overall application status. This allows for dynamic adjustments to features and policies without client-side code changes.
- Adaptive User Engagement: Control the dynamic injection and behavior of in-app prompts and content collections. Tailor their appearance, frequency, and targeting based on user roles and historical interactions, ensuring a highly personalized and effective engagement strategy.
- Robust Operational Resilience:
- Proactive Status Monitoring: An intelligent background service continuously monitors the application's health and status against backend directives. This ensures immediate detection and response to any changes in operational state.
- Seamless Critical State Handling: Implement essential "kill switch" functionalities and version enforcement with built-in, production-ready flows:
- Maintenance Mode: Instantly activate a full-screen maintenance page, providing clear communication to users during service downtime.
- Mandatory Updates: Enforce critical updates by displaying a non-dismissible screen that guides users directly to the latest version in their respective app stores.
⚙️ Your Advantage: Deploy with confidence, knowing you have a sophisticated, backend-driven system to manage your app's lifecycle, content, and user experience. This architecture provides the agility to respond to market demands and operational needs in real-time, ensuring continuous service delivery and a superior user journey.
🏗️ Architecture & Technical Excellence
- Built with
flutter_adaptive_scaffold, the app offers responsive navigation and layouts that look great on both phones and tablets.
↔️ Your Advantage: Deliver a consistent and optimized UX across a wide range of devices effortlessly.
- Developed with best practices for a maintainable and scalable codebase:
- Flutter & Dart: Cutting-edge mobile development.
- BLoC Pattern: Predictable and robust state management, enhanced with
bloc_concurrencytransformers (droppable, restartable, sequential) for advanced event handling. - GoRouter: Well-structured and powerful navigation.
- KV Storage Service: Utilizes
KVStorageServicefor secure and efficient local key-value storage.
📈 Your Advantage: The app is built on a clean, modern architecture that's easy to understand and maintain. It's solid and built to last.
- Easily switch between development (in-memory data or local API) and production environments with a simple code change. This empowers rapid prototyping, robust testing, and seamless deployment.
🚀 Your Advantage: A flexible setup that speeds up your development cycle and makes deployment simple.
- Fully internationalized with working English and Arabic localizations (
.arbfiles). Adding more languages is straightforward.
🌐 Your Advantage: Easily adapt your application for a global audience and tap into new markets.
This Flutter News App Mobile Client package is an integral part of the Flutter News App Full Source Code Toolkit. For comprehensive details regarding licensing, including trial and commercial options for the entire toolkit, please refer to the main toolkit organization page.
For a complete guide on setting up your local environment, running the mobile client, and understanding the configuration, please see the Local Setup Guide in our official documentation.
Our documentation provides a detailed, step-by-step walkthrough to get you up and running smoothly.