https://github.com/church-life-apps/songs
A cross platform app for songs and hymns.
https://github.com/church-life-apps/songs
android app ionic ios mobile-app react typescript webapp
Last synced: 41 minutes ago
JSON representation
A cross platform app for songs and hymns.
- Host: GitHub
- URL: https://github.com/church-life-apps/songs
- Owner: Church-Life-Apps
- Created: 2020-07-09T17:59:21.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2026-05-29T04:12:34.000Z (17 days ago)
- Last Synced: 2026-05-29T06:12:01.431Z (17 days ago)
- Topics: android, app, ionic, ios, mobile-app, react, typescript, webapp
- Language: TypeScript
- Homepage: https://church-life-apps.github.io/
- Size: 82.9 MB
- Stars: 4
- Watchers: 5
- Forks: 0
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# THIS APP IS BEING DISCONTINUED
We are (very) slowly discontinuing this app while we develop a new version! This means that for the most part we won't develop new features here, but we will still maintain the app including important bug fixes.
# Songs
An Ionic web, Android and iOS app for the SHL and SFG songbooks
The web app is hosted here: https://church-life-apps.github.io/
# Contributors
Feel free to contact us if you are interested in contributing, or just send a PR! Let us know if you have any questions or run into any problems.
# Developer Setup
[Clone](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository) this repository.
To setup your develop environment, you will need to install [Node.js](https://nodejs.org/en/download/), and run `npm install` in the root directory.
Use `npm start` to run the app locally.
You can also use `npm run build` to build the app, and `npm run test` to run tests.
# Android
To run the app on Android app follow these steps:
1. Install Android Studio if you don't already have it.
2. Navigate to the root directory of this project in Terminal.
3. To open Android studio with the project code, run `npx cap open android`
4. To update the Android version with the latest web code, run `ionic capacitor sync`.
5. Connect your Android device to your computer, or with an emulator run the app.
Info came from this guide: https://www.joshmorony.com/deploying-capacitor-applications-to-android-development-distribution/
We will need it when we want to deploy to Google Play store.
# iOS
To run the app on iPhone follow these steps:
1. Requires an IPhone and a Mac computer.
2. Install XCode if you don't already have it (XCode only runs on Mac).
- Install cocoapods, and create a user to be a developer (don't need paid developer account yet)
3. Navigate to the root directory of this project in Terminal.
4. To open XCode with the project code, run `npx cap open ios`
5. To update the iOS version with the latest web code, run `ionic capacitor sync`.
6. Connect your iPhone to your computer, or with an simulator run the app.