Skip to content

csertant/fama

Repository files navigation

fáma logo

fáma is a cross-platform news reader built with Flutter. It helps users discover RSS sources, build a personalized feed, save articles for later, and keep reading across devices and platforms.

GitHub Release GitHub Actions Workflow Status GitHub Actions Workflow Status GitHub Actions Workflow Status GitHub Actions Workflow Status License: GPL v3

Project Scope

The project focuses on delivering a clean, reliable, and customizable RSS reading experience:

  • Discover and subscribe to news sources
  • Aggregate and sync articles into a personal feed
  • Save articles for later reading
  • Manage multiple reading profiles
  • Support modern platforms from a single codebase

App Features

Personalized feed

  • Fetches and syncs articles from subscribed sources
  • Marks articles as read or saved
  • Automatically refreshes when connectivity returns

Source discovery and management

  • Explore recommended sources
  • Filter source recommendations by language, country, category, and genre
  • Add custom sources by URL
  • Remove subscribed sources anytime

Saved reading

  • Dedicated saved-articles view
  • Quickly unsave or mark saved articles as read

Powerful filtering

  • Filter articles by source and author
  • Toggle read/unread visibility
  • Filter by recent time windows

Profiles and preferences

  • Multiple profiles in one app
  • Switch active profile instantly
  • Theme selection (light/dark/system)
  • Language selection via localization support

Cross-platform support

  • Android
  • iOS
  • macOS
  • Windows
  • Linux

Getting Started

  1. Install Flutter (stable) and verify with flutter doctor.
  2. Get packages:
flutter pub get
  1. Run the app (staging providers):
flutter run --target lib/main.dart
  1. Run the development entrypoint (development providers):
flutter run --target lib/main_dev.dart

Contribution Opportunities

Want to contribute? The easiest way is to open an issue using one of the templates:

Before opening a new issue, please search existing issues to avoid duplicates.

Contact

For direct contact, email:

About

your personalized newsfeed for all platforms in flutter

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors