Welcome to SongLib

SongLib for Android, iOS, Windows

Overview

SongLib is a robust mobile solution tailored for our users who need to sing hymns, designed to streamline their operations and enhance productivity. This Flutter-based application facilitates their access to your church songbook/hymns seamlessly that you don't have to worry about even being online once you have set up the app on your device.

Getting Started

Follow this guide to set up and run SongLib:

Setting Up SongLib:

1. Install Flutter and Dependencies: Ensure Flutter is installed on your system. Download the Flutter SDK from the official website and set up your preferred IDE (e.g., Android Studio or Visual Studio Code) with the Flutter plugin.

2. Clone the Repository: Clone SongLib repository from GitHub using Git:

   git clone [email protected]:SiroDaves/SongLibApp.git

3. Install Packages: Navigate to the project directory and run:

   flutter pub get

Running SongLib:

1. Device Setup: Connect an emulator or physical device to your development environment. Check connected devices:

   flutter devices

2. Update Dependencies:

   flutter pub get

3. Update Code Generated Files:

   dart run build_runner build --delete-conflicting-outputs

4. Update Localization Strings:

   flutter gen-l10n

5. Running SongLib:

   flutter run

Building SongLib

1. Android:

   • Staging: AppTester (Firebase Distribution):

     flutter build apk --flavor staging -t lib/main_stg.dart --no-tree-shake-icons

   • Production (For Play Store):

     flutter build appbundle --flavor production -t lib/main_prod.dart --no-tree-shake-icons

2. iOS:

   • Production (For Play Store):

     flutter build ipa -t lib/main_prod.dart --no-tree-shake-icons

   To upload to the App Store either:

   • Drag and drop the "build/ios/ipa/*.ipa" bundle into the Apple Transporter macOS app https://apps.apple.com/us/app/transporter/id1450874784
   • Run "xcrun altool --upload-app --type ios -f build/ios/ipa/*.ipa --apiKey your_api_key --apiIssuer your_issuer_id". See "man altool" for details about how to authenticate with the App Store Connect API key.

3. Windows:

   flutter build windows --target=lib/main_prod.dart
   

---

Congratulations! You've successfully set up and run or built SongLib. Explore the codebase, make modifications, and contribute to creating a seamless experience for the users. Happy coding!