bus-arrival-totoro

Totoro Bus Arrival App

A cute, modern Flutter app to check Singapore bus arrival times, inspired by Totoro! 🐾

🌐 Live Demo

Try the app online!

Features

• 🚌 See how many minutes left until the next buses arrive at your stop
• 🐻 Totoro-themed, 2025-style UI with adorable graphics
• 🌐 Works on web (shows mock data for demo)
• 📱 Live LTA API data on mobile and desktop (no CORS issues)
• 🔄 Pull-to-refresh for the latest arrivals
• 🚨 Friendly error handling and retry

Screenshots

Add your screenshots here!

How to Run

Prerequisites

• Flutter SDK
• Dart

Web (Demo with Mock Data)

flutter run -d chrome

Mobile/Desktop (Live Data)

flutter run -d windows   # or -d android, -d ios

Note: The LTA API does not support CORS, so live data only works on mobile/desktop. Web uses mock data for a smooth demo.

Deployment

This app is automatically deployed to GitHub Pages using GitHub Actions. Every push to the main branch triggers a new build and deployment.

Manual Deployment

flutter build web
# The build output is in build/web/

Project Structure

• lib/bus_arrival_page.dart — Main Totoro bus arrival UI
• lib/services/lta_api_service.dart — API and mock data logic
• lib/models/bus_arrival.dart — Bus arrival model

Credits

• Totoro images: pngimg.com
• Bus data: LTA DataMall

License

MIT (see LICENSE)

---

Made with Flutter and Totoro spirit!