Flutter News App - API Server Full Source Code

This repository contains the complete, production-ready source code for the backend API server that powers the entire Flutter News App ecosystem. Built with the high-performance Dart Frog framework, it gives you all the server-side features you need, right out of the box. It is the core component of the Flutter News App - Full Source Code Toolkit, serving the Flutter mobile app and the web-based content dashboard.

This API server comes packed with all the features you need to launch a professional, scalable news application.

• Provides secure, modern authentication flows, including passwordless email sign-in and anonymous guest accounts.
• Intelligently handles converting guest users to permanent accounts, preserving all their settings and saved content.
• Includes a separate, role-aware login flow for privileged dashboard users.

Your Advantage: You get a complete, secure authentication system without the complexity. All the user management logic is done for you. ✅

• Implement precise permissions with a dual-role system: appRole for mobile app features and dashboardRole for admin functions.
• Securely control access to API features and data management capabilities based on user roles.

Your Advantage: A powerful, built-in security model that protects your data and ensures users only access what they're supposed to. 🛡️

• Protects critical endpoints like email verification and data access from abuse and denial-of-service attacks.
• Features configurable, user-aware limits that distinguish between guests and authenticated users.
• Includes a bypass for trusted roles (admin, publisher) to ensure dashboard functionality is never impeded.

Your Advantage: Your API is protected from day one against common abuse vectors, ensuring stability and preventing costly overages on services like email providers. ✅

• Effortlessly sync user-specific settings like theme, language, and font styles across devices.
• Manage personalized content preferences, including saved headlines and followed topics/sources.

Your Advantage: Deliver a seamless, personalized experience that keeps users' settings in sync, boosting engagement and retention. ❤️

• Securely manage all your core news data, including headlines, topics, sources, and countries.
• The API supports flexible querying, filtering, and sorting, allowing your app to display dynamic content feeds.

Your Advantage: A powerful and secure data backend that's ready to scale with your content needs. 📈

• Centrally manage your app's behavior without shipping an update.
• Control ad frequency, feature flags, force-update prompts, and maintenance status directly from the server.

Your Advantage: Adapt your app on the fly, run experiments, and respond to issues instantly, giving you maximum operational control. 🕹️

• Access real-time, aggregated metrics on key data points like total headlines, topics, and sources.
• Provides an at-a-glance overview perfect for administrative dashboards.

Your Advantage: Instantly feed your content dashboard with the data it needs to provide valuable insights. 🎯

• Built with Dart and the high-performance Dart Frog framework.
• Features a clean, layered architecture with standardized API responses and built-in dependency injection.

Your Advantage: A solid, maintainable codebase that's easy to understand, extend, and build upon. 🔧

Get started for free and purchase when you're ready to launch!

• TRY IT: Download and explore the full source code under the PolyForm Free Trial license. Perfect for evaluation.
• BUY IT: One-time payment for a lifetime license to publish unlimited commercial apps.
• GET YOURS: Purchase via GitHub Sponsors.

For a complete guide on setting up your local environment, running the server, 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.

This project aims for high test coverage to ensure quality and reliability.

• Run tests with:

  very_good test --min-coverage 90