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 written primarily with React Native. We also use Swift & SwiftUI to leverage native iOS functionalities.

The following steps assumes your environment is already set up for running React Native apps.
If this is your first time, check out the official set up guide beforehand.

• Bun: This project uses Bun as the package manager. Please see the Bun installation guide for instructions.

• Fork the repo and clone to your machine.
• Run bun install
• MacOS / Linux users: Run bun rename-dev-configs to rename the firebase development configs.
• Windows users: Duplicate the firebase configs in /ios and /android/app, and remove the .development suffix from the duplicated files.
• Run bun build-android to generate the Android assets.
• Run bun start to start the metro development server
• Run the app with bun ios (to open the iPhone simulator) or bun android (for the Android simulator).

If you want to contribute and face issues during instllation, please reach out to us at [email protected] 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.