You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
@@ -18,105 +18,88 @@ This repository contains the complete, production-ready source code for a Flutte
## β Feature Showcase: Everything You Get, Ready to Go
This dashboard comes packed with all the features you need to manage a professional news application.
This dashboard provides a complete, production-ready command center for your entire news operation. Each feature is designed to give you effortless control over your content, monetization, and the mobile app's behavior in real-time.
Manage the entire lifecycle of your news content with full CRUD (Create, Read, Update, Delete) capabilities, complemented by advanced archiving and restoration features:
- **Topics:** Draft, Create, edit, archive, and restore news topics.
- **Sources:** Draft, Create, edit, archive, and restore news sources.
> **π‘ Your Advantage:** Gain detailed control over your content. This centralized system ensures accuracy and consistency, allowing you to manage draft/active content and easily retrieve or remove archived items.
---
### π Dashboard Overview
Get a real-time overview of your content ecosystem with key statistics and quick actions:
- **Content Counts:** View the total number of headlines, topics, and sources.
- **Recent Activity:** See recently created headlines to stay on top of new content.
- **Quick Actions:** Directly create new headlines, topics, or sources from the overview.
> **β€οΈ Your Advantage:** Quickly assess your content operation and jump directly into key management tasks, streamlining your workflow.
### π° Complete Editorial Control
Manage the entire lifecycle of your content from a single, intuitive interface. This is more than just a database editor; it's a complete content operations hub.
- **Full Content Lifecycle:** Seamlessly draft, publish, edit, archive, and restore all content assets, including headlines, topics, and news sources.
- **At-a-Glance Operational Overview:** A centralized dashboard provides a real-time snapshot of your content ecosystem, including key statistics and shortcuts for common editorial tasks.
> **Your Advantage:** Gain granular control over your entire content pipeline. This centralized system streamlines your editorial workflow, ensures content consistency, and simplifies asset management.
Manage the monetization engine of your mobile app directly from the dashboard. This integrated system provides deep control over your ad inventory and the rules that govern how ads are displayed.
- **Flexible Ad Provider System:** Switch the primary ad provider for the mobile app between `Google AdMob` for industry-standard monetization or your own `Local` ad server for full control over your inventory.
- **Local Ad Inventory Management:** When using the local provider, you have full CRUD capabilities for all your ad creatives, including:
- **Native Ads:** Design ads that blend with your content.
- **Banner Ads:** Implement traditional banner ads.
- **Granular Remote Configuration:** Fine-tune the mobile ad experience without shipping an app update:
- **Ad Unit Management:** Configure AdMob and local ad unit identifiers from one place.
- **Role-Based Rules:** Define ad frequency, placement, and format based on user roles (guest, standard, premium).
- **Format Control:** Set rules for feed ads, in-article ads, and interstitial ads independently.
> **π‘ Your Advantage:** This provides a centralized control panel to manage a flexible monetization strategy. Deploy local ad campaigns or optimize your AdMob settings on the fly to maximize revenue potential.
Take direct control of your mobile app's revenue strategy. This integrated system allows you to manage your ad inventory and fine-tune display rules without ever touching the mobile app's code.
- **Flexible Ad Provider Strategy:** Instantly switch the mobile app's primary ad source between industry-standard networks like Google AdMob or your own self-hosted ad server for maximum control.
- **Custom Ad Inventory Management:** When using the local provider, you have full creative control to upload and manage a wide variety of ad formats, from native and banner to full-screen interstitial ads.
- **Granular, Role-Based Rules:** Define precisely how and when ads are shown based on user subscription tiers (e.g., guest, standard, premium), optimizing both revenue and user experience.
> **Your Advantage:** Deploy a powerful, backend-driven monetization strategy. A/B test ad providers, launch direct-sold campaigns, and adjust revenue models on the fly to respond to market demands in real-time.
---
### π Centralized Application Control
Manage the mobile client's remote configuration directly from the dashboard. This feature allows you to control various aspects of the mobile application without requiring an app store update. Configurable elements include:
- **Maintenance Mode:** Enable or disable maintenance mode for the mobile app.
- **Force Update:** Mandate app updates to a specific version, with an option to force users to update.
- **Feed Decorators:** Manage the enablement and visibility of in-feed promotional and engagement elements like `linkAccount`, `upgrade`, `rateApp`, `suggestedTopics`, etc.
- **User Preference Limits:** Set maximum limits for followed items (countries, sources, topics) and saved headlines, tiered by user roles.
> **π― Your Advantage:** Gain control over your mobile application's behavior. Adjust critical settings on the fly to ensure your users have the best experience and your business goals are met.
### π Real-Time Application Management
Dynamically control the mobile app's behavior and operational state directly from the dashboard, eliminating the need for constant app store updates.
- **Critical State Management:** Instantly activate a maintenance mode or enforce a mandatory app update for your users to handle operational issues or critical releases gracefully.
- **Dynamic In-App Content:** Remotely manage the visibility and behavior of in-feed promotional prompts and user engagement elements.
- **Tier-Based Feature Gating:** Define and enforce feature limits based on user roles, such as setting the maximum number of followed topics or saved headlines for different subscription levels.
> **Your Advantage:** Gain unparalleled agility to manage your live application. Ensure service stability, drive user actions, and configure business rules instantly, all from a centralized control panel.
<summary><strong>π Team Security & Customization</strong></summary>
### π Robust User Authentication
Secure authentication flows are built-in for administrators and publishers using Email + Code (Passwordless) Sign-In.
> **β Your Advantage:** The security and user management for your administrative team is already handled for you.
### π Secure Administrative Access
A complete and secure user authentication system is built-in for your editorial and administrative teams.
- **Modern, Passwordless Sign-In:** Ensures that only authorized personnel can access the dashboard using a secure and easy-to-use email-based verification system.
> **Your Advantage:** The security and user management for your administrative team is already handled, providing peace of mind from day one.
---
### π¨ Customizable Dashboard Settings
Provide your administrative team with the ability to personalize their dashboard experience through a robust settings interface. This feature allows individual administrators and publishers to tailor the dashboard's appearance and behavior, including:
- **Appearance Settings:** Adjust base themes (light/dark/system), accent colors, font families, text scale factors, and font weights.
- **Language Selection:** Choose their preferred language for the dashboard interface.
> **π‘ Your Advantage:** Improve the productivity of your administrative team with a customizable dashboard. Personalized display and language options create a more efficient and user-friendly management experience.
### π¨ A Personalized Workspace
Empower your team with a dashboard experience they can tailor to their own preferences, improving comfort and productivity.
- **Full Appearance Control:** Each team member can configure their own workspace, including light/dark themes, accent colors, and text styles.
- **Multi-Language Interface:** The dashboard is fully internationalized, allowing each user to select their preferred language.
> **Your Advantage:** Create a more efficient and user-friendly management environment for your team, leading to increased productivity and satisfaction.
Built with `flutter_adaptive_scaffold`, the dashboard offers a clean, responsive interface that works well on any screen size.
> **βοΈ Your Advantage:** Provides a consistent administrative experience on desktops, tablets, and mobile browsers.
### π₯οΈ Fully Responsive Design
The dashboard interface is engineered to deliver a seamless and consistent administrative experience across any device, from a large desktop monitor to a tablet or mobile phone.
> **Your Advantage:** Manage your news operation from anywhere, on any device, without compromising on functionality or user experience.
---
### ποΈ Clean & Modern Architecture
Developed with best practices for a maintainable and scalable codebase:
- **Flutter & Dart:** Modern web development.
- **BLoC Pattern:** Predictable state management.
- **GoRouter:** Well-structured navigation.
> **π Your Advantage:** The dashboard is built on a clean, modern architecture that is easy to understand and maintain.
### ποΈ Clean & Modern Foundation
Developed with industry best practices to ensure the codebase is scalable, maintainable, and a pleasure to work with.
- **Predictable State Management:** Leverages the BLoC pattern for a clear and testable architecture.
- **Structured Navigation:** Employs declarative routing to keep the application flow logical and easy to extend.
> **Your Advantage:** The dashboard is built on a clean, modern architecture that is easy to understand, maintain, and build upon.
---
### π οΈ Production-Ready Environment Tooling
Utilizes compile-time variables (`--dart-define`) to seamlessly switch between `production`, `development`, and `demo` environments.
- **Error-Proof Configuration:** This approach ensures environment-specific settings like API endpoints are set at build time, preventing accidental release of development configurations.
> **Your Advantage:** A robust, professional environment setup that streamlines the development-to-production pipeline and prevents common configuration mistakes.
Utilizes compile-time variables to seamlessly switch between `production`, `development`, and `demo` environments.
- **Error-Proof Configuration:** This professional approach ensures that environment-specific settings like API endpoints are set at build time, preventing accidental release of development configurations.
> **Your Advantage:** A robust environment setup that streamlines the development-to-production pipeline and prevents common configuration mistakes.
---
### π Localization Ready
Fully internationalized with working English and Arabic localizations (`.arb` files). Adding more languages is straightforward.
> **π Your Advantage:** Adapt your dashboard for a global team.
### π Built for a Global Team
The application is fully internationalized and includes working English and Arabic localizations out of the box.
- **Simple Extensibility:** The architecture is designed to make adding new languages a straightforward process.
> **Your Advantage:** Easily adapt the dashboard for a diverse, global administrative team.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.