Readium

Read Medium articles for free. No subscription required.

Features • Getting Started • Installation • Issues • Contributing

---

📱 Platform Support

⚠️ Android Only
Readium currently supports Android devices only.

---

Features

• 📖 Free Access – Read Medium member-only articles without subscription
• 🎨 Medium-like UI – Familiar typography and clean design
• 🌓 Dark/Light Theme – Comfortable reading in any lighting
• 💾 Reading History – Track articles you've read
• 🔗 Deep Linking – Share articles seamlessly
• ⚙️ Customizable – Adjust font size and appearance
• 💻 Code Highlighting – Beautiful syntax highlighting for code blocks

---

Getting Started

For Users

1. Install the APK build (or build locally)
2. Paste any Medium article URL
3. Read for free – even member-only articles!
4. Share with friends using Readium

---

For Developers

Prerequisites

Make sure you have the following installed:

• Flutter SDK >= 3.27.1
• Dart SDK >= 3.6.0
• Android Studio (latest stable)
• Android SDK
• Android device or emulator

Verify your setup:

flutter doctor

#### Installation
# Clone the repository
git clone https://github.com/Alok-Sci/readium.git
cd readium

# Install dependencies
flutter pub get

# Run the app (Android only)
flutter run

#### Build
flutter build apk --release

Architecture

lib/ ├── core/ # Core functionality │ ├── config/ # App configuration │ ├── services/ # Business logic │ └── theme/ # UI theming ├── features/ # Feature modules │ ├── article/ # Article reading │ ├── history/ # Reading history │ ├── home/ # Home screen │ └── settings/ # App settings └── main.dart # Entry point

Tech Stack

• Flutter – UI framework
• Dart – Programming language
• SQLite – Local storage
• Freedium API – Article fetching service

Deep Linking

Readium supports:

• Custom scheme: readium://medium.com/article-path
• Medium URLs: Direct handling of medium.com and *.medium.com URLs
• Share intent: Share Medium articles directly to Readium

Contributing

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Acknowledgments

• Freedium – For providing the API service (freedium.cfd)
• Flutter team – For the amazing framework
• Open source community – For incredible packages and tools

Support

• Issues: GitHub Issues
• Email: devreadium@gmail.com

---

Made with ❤️ by Alok Singh

⭐ Star us on GitHub • 🐛 Report Bug • 💡 Request Feature