Adventist Hymnal

New version of the adventist hymnal multi-platform.

If you like this app, help me supporting this project:

• 

A multi-language hymnal app supporting Spanish, English, Russian and Portuguese. Built with Flutter using Clean Architecture.

Table of contents

• Features
• Presence in stores
• Architecture
• Getting Started
• Build for Release
• Main Packages
• Contributing
• Support
• License

Features

• Advanced Search: Find hymns by title, lyrics, or number with text normalization (stripping accents and special characters).
• Multiple Hymnals: Support for different language versions:
  • English: 1985 & 1941 versions
  • Español: 2009 & 1962 versions
  • Português: 1996 version
  • Русский: 1997 version
• Audio Playback: Listen to instrumental and/or sung versions.
• Sheet Music: View piano sheet music for hymns with zoom support.
• Favorites & History: Save and reorder favorites, and view your recently opened hymns.
• Customization: Adjust font size, toggle theme mode, and enable/disable background images.

---

Presence in stores

Other platforms / Alternative (Android):

• GitHub Releases (Direct APK download)

---

Architecture

This app follows Clean Architecture with a focus on reusability and maintainability:

lib/
├── constants/          # App-wide constants
├── core/               # Core utilities and shared logic (e.g., StringUtils)
├── services/           # Global services (DI, audio, settings, favorites)
├── styles/             # Theme, fonts, and common styles
├── widgets/            # Reusable UI components (AppScaffold, HymnListTile)
└── layers/             # Clean architecture layers
    ├── data/           # Repositories and data sources
    ├── domain/         # Domain models
    └── screens/        # Feature-based UI screens and controllers

---

Getting Started

Prerequisites

• Flutter SDK (3.0.0 or higher)
• Dart SDK

Installation

1. Clone the repository:

git clone https://github.com/isax5/Hymnal-Flutter.git
cd Hymnal-Flutter

2. Install dependencies:

flutter pub get

3. Run the app:

flutter run

---

Build for Release

Android:

flutter build apk --release
flutter build appbundle --release

iOS:

flutter build ios --release

---

Main Packages

Package	Purpose
get_it	Dependency injection
just_audio	Audio playback engine
just_audio_background	Background audio support
shared_preferences	Local storage
flutter_svg	SVG support
photo_view	Zoomable images for sheet music
share_plus	Share functionality
equatable	Value-based equality for models

---

Contributing

Contributions are welcome! Please visit our GitHub Repository for more information. You can also support by donating on Paypal.

Support

Reach out to me at one of the following places:

• Twitter: @IsaacRebolledo
• LinkedIn: Isaac Rebolledo

License

This project is open source. See the repository for license details.