Liryo App

Overview

Liryo is a mobile reading journal app available on iOS and Android that helps book lovers track their reads, write detailed reviews, and build consistent reading habits. The core premise is simple: stop forgetting the books you love. Everything lives in one place: your library, your reviews, your stats, and your goals.

The app supports two languages (English and Spanish), offers light and dark mode, and lets users personalize the interface with a variety of color accent themes.

Features

Reading Library & Reviews

• Log books with title, author, page count, cover image, genre, format (physical, e-book, audiobook), and language.
• Write detailed reviews with ratings, notes, quotes, characters, vibes, and endings.
• Organize reviews into custom lists.
• Add music associations, places, and images to each reading.
• Fill in book details automatically from a photo of the cover or fisical reviews.

Home Dashboard

• Built-in reading timer (chronometer) to track daily reading sessions.
• Multiple simultaneous current readings with page progress tracking.
• Reading history and reading streak display.
• In-app announcements and update notifications.

Calendar

• Visual calendar showing days with completed reading goals highlighted.
• Streak tracking with best streak record.
• Three views: Habits, Streak, and Readings.

Statistics

• Books read per month chart.
• Average reading time per day of the week.
• Spending by genre breakdown.
• Reading pace, favorite genres, and format preferences.
• Linguistic diversity and reading speed goals.
• Reading heatmap showing activity over time.

Goals

• Daily reading goal in minutes, with progress indicator.
• Annual reading challenge (number of books per year).
• Streak system to motivate consistency.

Glossary

• Access to pre-defined literary terms.
• Create and manage your own custom glossary entries.

Settings & Customization

• Language selection: English or Spanish.
• Light and dark mode.
• Color accent themes: Classic, Blue, Red, Pink, Purple, Green, Yellow, Teal, Cyan, Orange, Lime.
• Reading goals configuration (linguistic diversity, reading speed in pages/min).
• Data management: import and export reviews in multiple formats (PDF, CSV, JSON, plain text, and more).
• Subscription plan management.
• Feedback, bug reports, and feature request submission.

Pricing

Free trial available for Premium. No ads on any plan.

Tech Stack

Frontend (Mobile App)

• React Native with Expo — cross-platform iOS and Android development.
• JavaScript — primary language.
• Tailwind CSS (NativeWind) — utility-first styling.
• i18n — full English and Spanish localization.

Backend

• Node.js with Express.js — RESTful API.
• MySQL — relational database.
• Sequelize — ORM for data modeling.
• Docker & Docker Compose — containerized development and deployment.
• JWT — token-based authentication.
• bcryptjs — password encryption.
• Helmet + express-rate-limit — security headers and rate limiting.
• Winston — logging system.
• Jest + Supertest — unit and integration testing.

Payments & Subscriptions

• RevenueCat — subscription management for App Store and Google Play, with webhook integration for plan lifecycle events (activation, renewal, expiration, cancellation, transfer).

Architecture

The backend exposes a REST API that handles all app data: user accounts, reading library, current readings, reviews, reading goals, habits tracking, glossary, statistics, and push notifications.

Key data models:

• User — account info, plan, preferences.
• CurrentReading — books in progress with page tracking.
• Review — full review with rating, text, quotes, characters, vibes, images.
• ReadingGoal — daily and annual goals.
• TrackingHabits — session-by-session reading logs.
• List — custom review collections.
• Glossary / GlossaryBaseTerms — literary term management.
• Analytics — event tracking per device and user.
• DeviceTokens / NotificationLogs — push notification infrastructure.

Security measures include CORS configuration, HTTP header protection via Helmet, JWT authentication, bcrypt password hashing, and rate limiting on all endpoints.

Upcoming Features

• Book recommendations based on reading history and preferences.
• Random book picker from library or personalized web suggestions.
• Search books from the web and add them directly to the library.
• Offline access — continue tracking without an internet connection.
• Export to third-party apps (Google Sheets, Excel, etc.).
• Initial questionnaire for onboarding personalization.