📚 ReadlyBook

ReadlyBook — это современное Android-приложение для управления личной библиотекой книг с поддержкой чтения epub, pdf и txt-файлов и синхронизацией данных в облаке.

📹 Демонстрация работы

ReadlyBookExample.mp4

✨ Основные возможности

• 🔐 Аутентификация пользователей — вход и регистрация через Firebase Authentication
• 📖 Управление библиотекой — добавление, редактирование и удаление книг
• 📄 Чтение epub, pdf и txt — встроенный просмотрщик файлов
• ☁️ Облачное хранилище — синхронизация обложек и файлов через Firebase Storage
• 💾 Оффлайн-режим — локальное кэширование данных с помощью Room Database
• ✨ Анимации — плавные переходы и Lottie-анимации
• 🔍 Поиск книг — быстрый поиск по названию, автору и жанру
• 🔑 Поддержка автоматического входа

🛠 Технологический стек

Основные технологии

UI

• Jetpack Compose — современный декларативный UI toolkit
• Material 3 — компоненты Material Design 3
• Navigation Compose — навигация между экранами
• Coil — загрузка и кэширование изображений
• Lottie — анимации в формате JSON от Airbnb

Backend & Data

• Firebase Authentication — аутентификация пользователей
• Firebase Firestore — облачная NoSQL база данных
• Firebase Storage — хранилище файлов (обложки и файлов)
• Room Database — локальное хранилище данных

PDF

• Pdf-Viewer (io.github.afreakyelf:Pdf-Viewer) — библиотека для отображения PDF-файлов

Dependency Injection

• Dagger 2 — внедрение зависимостей

Асинхронность

• Kotlin Coroutines — асинхронное программирование
• WorkManager — фоновые задачи

🚀 Установка и запуск

1. Клонирование репозитория

git clone https://github.com/maxkeils/ReadlyBook.git
cd ReadlyBook

2. Настройка Firebase

Для работы приложения необходим файл google-services.json:

1. Создайте проект в Firebase Console
2. Добавьте Android-приложение с package name: max.keils.readlybook
3. Включите следующие сервисы:
   • Authentication (Email/Password)
   • Firestore Database
   • Storage
4. Скачайте файл google-services.json
5. Поместите его в папку app/

ReadlyBook/
├── app/
│   ├── google-services.json  ← Поместите файл сюда
│   └── ...

📱 Тестирование

Тестовое устройство

Приложение протестировано на: Pixel 9 Pro API 36

🐛 Ограничения

• Поддержка только epub, pdf и txt форматов
• Требуется подключение к интернету для первого входа
• Размер загружаемых PDF-файлов ограничен настройками Firebase Storage
• Сейчас приложение корректно функционирует только при включённом VPN — это связано с ограничениями доступа к Firebase.