Local train schedule

Find Belgrade(RS) train departures by time, date and station

Table of Contents

1. Motivation
2. App Features
3. Tools and Dependencies
4. Local Usage
5. Todos
6. Author

---

Motivation

This app was built out of need for a more accessible and readable alternative to the official local train schedule in PDF.
In order to find a departure in the PDF version of the schedule on mobile, the user has to zoom in, then go over a lot of unnecessary information while putting extra effort not to lose track of the row, just to find a departure.

Nope.

The app uses data from a JSON file that was created specifically for the app by running a program.
The JSON file can be easily updated after the schedule becomes obsolete - which usually happens once a year - by reusing the helper functions with most recent data passed in.

App Features

As a User, you simply select departure station, arrival station, date and time and you'll get a list of departures/arrivals with train id-s.

Weekday and weekend schedule differs and national holidays are taken into account automatically. If the departures don't exist for the entered criteria, a message will pop up. Tapping on the question mark in the header, you will find more info about the app. Tapping on train icon will refresh the page. Diamond icon is just a placeholder.

Tools and Dependencies

• React - User interface
• Vite - Build tooling
• Vitest - Testing
• Sass - Style

Local Usage

In the root folder of the cloned repo, run:

1. npm install to install the dependencies;
2. npm run dev to run the app in development mode;
3. npm run test to test;

Todos

• Enable users to save and quickly access their most frequent departures;
• Enable sharing search results;

Author

@marija-kov