Skip to content

Bustime mobile app for real-time public transport tracking, seamlessly integrated with the Bustime API

Notifications You must be signed in to change notification settings

bustime-org/bustime-app

Repository files navigation

Bustime

Bustime website was created in 2012 to provide passengers with information about the current location of public transport in real-time. The provided information is based on satellite navigation data from GLONASS/GPS. Using the service, passengers spend less time waiting at stops, which is especially relevant in adverse weather conditions. Project philosophy:

  1. Provide passengers with reliable information as quickly as possible with minimal energy costs
  2. Increase the convenience of using public transport
  3. Do not multiply entities beyond necessity

How to build the project

Step 0: Assemble a server

  1. Build your server
    • Follow the instructions at https://github.com/bustime-org/bustime to run your own Bustime server.

Step 1: Install Flutter

  1. Download Flutter SDK:

    • Visit the Flutter website and download the SDK for your operating system.
  2. Extract the SDK:

    • Extract the downloaded file to a suitable location on your system (e.g., C:\src\flutter on Windows).
  3. Add Flutter to PATH:

    • Update your system’s environment variables to include the Flutter SDK bin directory in your PATH.
  4. Verify Installation:

    • Open a terminal and run:
      flutter doctor
    • Follow any additional setup instructions provided by the flutter doctor output.

Step 2: Set Up Your Editor

  1. Install IDE:

    • Use an IDE like Android Studio, Visual Studio Code, or IntelliJ IDEA.
  2. Install Flutter Plugin:

    • For VS Code: Install the Flutter and Dart extensions from the Extensions Marketplace.
    • For Android Studio: Go to Settings > Plugins and install Flutter (this will also install Dart).

Step 3: Set Up an Emulator or Device

  1. Android Emulator:

    • Install the Android SDK via Android Studio.
    • Create and launch an emulator from AVD Manager.
  2. iOS Simulator (Mac only):

    • Install Xcode and open the iOS Simulator from Xcode.
  3. Physical Device:

    • Enable Developer Mode on your device and connect it via USB.
    • Run:
      flutter devices
    • Ensure your device appears in the list.

Step 4: Download this project to your local machine

  1. Download the Project:

    • Follow the instructions provided on Gitlab on how to clone this repository to your local machine.
  2. Open the Project:

    • Open the project in your IDE (e.g., VS Code or Android Studio).

Step 5: Adjust the project

  1. Change domain link:
  2. Change the app:
    • Change the app to your liking, feel free to do whatever your heart desires

Step 6: Run the App

  1. Start Debugging:
    • Connect a device or launch an emulator.
    • In your terminal, run:
      flutter run
    • Or, use the Run button in your IDE.

Step 7: Build the App for Release

  1. Android APK:

    • Run:
      flutter build apk --split-per-abi --no-tree-shake-icons
    • The APK file will be located in build/app/outputs/flutter-apk/.
  2. iOS App (Mac only):

    • Ensure you have a valid Apple Developer account and Xcode configured.
    • Run:
      flutter build ios

You’ve successfully installed Flutter, adjusted Bustime to your needs, and built it! 🎉

About

Bustime mobile app for real-time public transport tracking, seamlessly integrated with the Bustime API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages