Better Rail

 

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

Overview

Better Rail is built with React Native. We also use Swift, SwiftUI and Kotlin to leverage native platform functionalities.

Installation

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.

Prerequisites

• 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.

Setup Steps

• Fork the repo and clone it to your machine.
• Run bun install.
• Run bun start to start the development server.
• Run the app with bun ios (to open the iPhone simulator) or bun 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 (or bun 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!

License

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.