ht_main is a flutter mobile application that serves as both a powerful, fully functional news application ready for deployment, and an exceptionally robust starter kit, architected for easy extension and customization. It is a key component of the Headlines Toolkit, an ecosystem that also includes a Dart Frog backend API and a web-based content dashboard.
ht_main comes packed with features to accelerate your development and delight your users:
Experience a beautifully crafted, infinitely scrolling news feed. It's highly performant and ready for your content.
- Benefit for you: Save months of UI/UX development and complex state management. Get a production-quality feed system instantly! ⏱️
Empower users with intuitive filtering for headlines by categories, sources, and countries. A dedicated search page helps users find exactly what they're looking for.
- Benefit for you: Offer powerful content discovery tools that significantly enhance user engagement and satisfaction. 🎯
Secure and flexible authentication flows are built-in:
- 📧 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.
- Benefit for you: Complex security and user management handled, including data migration during account linking, letting you focus on features. ✅
Users can tailor their experience:
- Content Preferences: Follow/unfollow categories, sources, and countries.
- Saved Headlines: Bookmark articles for easy access later.
- Benefit for you: A strong foundation for personalization, driving user retention and creating a sticky app experience. ❤️
Offer users control over their app experience:
- Appearance: Light/Dark/System themes, accent colors (via FlexColorScheme), font choices, and text scaling.
- Feed Display: Customize how headlines are presented.
- Benefit for you: Provide a premium, adaptable user experience that caters to individual needs. 🔧
Built with flutter_adaptive_scaffold, ht_main offers responsive navigation and layouts that look great on both phones and tablets.
- Benefit for you: 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.
- GoRouter: Well-structured and powerful navigation.
- Benefit for you: An easy-to-understand, extendable, and testable foundation for your project. 📈
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.
- Benefit for you: Accelerate your development cycle and ensure your app is always ready for any deployment scenario. 🚀
Fully internationalized with working English and Arabic localizations (.arb files). Adding more languages is straightforward.
- Benefit for you: Easily adapt your application for a global audience. 🌐
ht-main is source-available as part of the Headlines Toolkit ecosystem.
To acquire a commercial license for building unlimited news applications, please visit the Headlines Toolkit GitHub organization page for more details.
- Ensure Flutter is installed. (See Flutter documentation)
- Clone the repository:
git clone https://github.com/headlines-toolkit/ht-main.git cd ht-main - Get dependencies:
flutter pub get
- Run the app:
(Note: For full functionality, ensure the
flutter run
ht-apibackend service is running and accessible.)
This project aims for high test coverage to ensure quality and reliability.
- Run tests with:
flutter test