Better Rail is an open source mobile client for Israel Railways, with an emphasis on great design, performance and accessibility.
Available on the App Store & Play Store
Better Rail is built with React Native. We also use Swift, SwiftUI and Kotlin to leverage native platform functionalities.
The following steps assume your environment is already set up for running Expo / React Native apps (Xcode for iOS, Android Studio for Android).
If this is your first time, check out the Expo local development setup guide beforehand.
- Bun: This project uses Bun as the package manager. See the Bun installation guide for instructions.
- CocoaPods (iOS only): Required by the prebuild step. See the installation guide.
- Fork the repo and clone it to your machine.
- Run
bun install. - Run
bun startto start the development server. - Run the app with
bun ios(to open the iPhone simulator) orbun android(for the Android emulator). The first run generates the native projects and may take a while.
If you change anything that affects the native layer (config, plugins, native dependencies), run
bun prebuild(orbun prebuild:clean) to regenerate the native projects.
If you want to contribute and face issues during installation, please reach out to us at feedback@better-rail.co.il and we'll try to help!
The source code is released under the AGPL-3.0 license.
The project assets - the user interface, app branding, images, illustations, icons and fonts are outside the scope of the license.
