Skip to content

EricHsia7/bus

Repository files navigation

Bus

Bus is a user-friendly web application designed to simplify your travel experience. Whether you're a frequent traveler, daily commuter, or simply exploring new places, Bus provides tools to help you find routes, manage locations, and organize your journeys effortlessly.

Getting Started

Open this application in your browser via one of the urls.

Key Features

Supported Regions

  • Taipei, Taiwan
  • New Taipei, Taiwan

Easy Search

Quickly find routes, locations, and places of interest within the app.

Integration

  • All-in-One Page: Display stops of a route or location on a single page.
  • Visualized Diagram: Show departure time scheduled by its provider in a simplified and readable calendar.
  • Position: Highlight the bus stop where you are currently present.

Personalization

  • Customizable Display: You can customize time-formatting mode, location labels, folder icons, etc.
  • Personal Schedule: By entering your schedules and routines, Bus is allowed to save estimated time data in specified period and cater to bus arrival time.
  • Folder: Save important stops, locations, and routes in folders for quick reference.

Analytics

  • Bus Arrival Time: This feature requires setting Personal Schedule. After set, it will work on route and location page.
  • Data Usage: See the transferred data quantity.
  • Storage: See the drive space used by Bus on your device.

Notification

  • Schedule Notifications: You can set up notifications to remind you about bus arrivals based on their estimated times.
  • Backend Requirements: When you close Bus, operating systems typically restrict its access to system resources. This makes it difficult to handle notifications using frontend technologies alone. To use the notification feature, you'll need to set up backend infrastructure—though you can use free services like Cloudflare Worker for this purpose.
  • Bus Notification Worker: You can set up a worker using @EricHsia7/bus-notification-worker.

Privacy

Your privacy and security are our top priorities. Your all data are stored locally except for the notification feature1. The data is only used for improving your using experience, and not for advertising. You can see them in ./src/data.

Concepts

Locations & Stops

Locations and stops are different in some aspects. Stops are route-position pair, which means a stop can be only on a route, at single geolocation, and towards one direction. On the other hand, a location is a collection of such stops sharing the approximately same geolocation.

Dependencies

Affiliated Repositories

Materials Used

Footnotes

  1. There's an exception that your data may be sent to and stored on providers you choose, if you're using the notification feature.

About

A reader for organized bus information

Resources

Stars

Watchers

Forks

Contributors