Skip to content

A helpful mobile application for public transportation use in Helsinki region.

Notifications You must be signed in to change notification settings

PatrikZitting/BusNow

Repository files navigation

BusNow Mobile App

Overview

BusNow is a mobile application designed to enhance the experience of using public bus transportation. It provides users with quick access to bus timetables, the ability to save bus stop locations for later use, and the functionality to select bus stops directly from a map interface. The app displays the timetable for the next five buses at the selected station, including their scheduled and real-time estimated arrival times. The catch is that this application is very useful to those who already know which bus they are going to catch and from where, but just need to quickly check the timetables. So in essence, it's made for the everyday-routine public transportation, like going to work, school or say, a hobby. The application was designed with quick access and speed in mind.

Table of Contents

Screenshots

1BusNow2BusNow 3BusNow4BusNow 5BusNow

Features

  • Quick Timetables: Get instant access to bus timetables for any selected stop.
  • Save Stops: Conveniently save your frequently used bus stops for quick future access.
  • Map Integration: Use the map feature to select bus stops and view their timetables.
  • Real-time Updates: See both scheduled and real-time arrival estimates for the next five buses.

Technology Stack

  • React Native: The app is built using React Native, providing a smooth and native-like user experience.
  • SQLite: Local database storage for saving bus stop information.
  • Expo: The project is developed using Expo for efficient cross-platform development and testing.

APIs Used

  • Digitransit API: This API provides all the necessary details about bus stops and their timetables.
  • Google Maps API: Integrated for map functionalities within the app.

Prerequisites

To run the app, you need to have:

  • Node.js and npm (or yarn) installed on your system.
  • Expo CLI installed globally (npm install -g expo-cli or yarn global add expo-cli).
  • An Android or iOS simulator or device for running the application.

Installation and Setup

  1. Clone the repository to your local machine.
  2. Navigate to the project directory and install the dependencies:
    npm install
    
    or
    yarn install
    
  3. You need to have your own Digitransit API Key and Google Maps API Key. These keys should be placed in a .env file in the root of your project:
    DIGITRANSIT_API_KEY=your_digitransit_api_key_here
    GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here
    

Running the App

After setting up the API keys:

  1. Start the Expo development server:
    expo start
    
  2. Open the project in an Android or iOS simulator, or scan the QR code using the Expo Go app on your physical device.

Note

The API keys for Digitransit and Google Maps are not provided in this GitHub repository. You will need to obtain these keys from their respective services.

About

A helpful mobile application for public transportation use in Helsinki region.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published