MUNI when

A mobile app for tracking MUNI bus and train arrival times for riders who are already on board.

Overview

MUNI when is designed to help passengers who are already on a MUNI vehicle track when they'll arrive at their destination. By simply entering the vehicle ID (visible on the bus or train), passengers can see estimated arrival times for upcoming stops.

Key Features

• Quick vehicle tracking by ID
• Real-time arrival predictions
• Save favorite routes for quick access

Getting Started

Prerequisites

• Node.js 18 or newer
• Expo CLI
• For iOS: XCode and iOS Simulator
• For Android: Android Studio and Android Emulator

Installation

1. Clone the repository

git clone https://github.com/yourusername/muni-when.git
cd muni-when

2. Install dependencies

npm install

3. Start the development server

npm start

4. Follow the Expo CLI instructions to open the app on your device or emulator

Development

This project is built with:

• React Native
• Expo
• TypeScript

Project Structure

muni-when/
├── app/                  # Main application screens
│   ├── (tabs)/           # Tab-based navigation screens
│   │   ├── index.tsx     # Track screen (main)
│   │   └── saved.tsx     # Saved locations screen
├── assets/               # Static assets like images
├── components/           # Reusable UI components
│   ├── BusTracker.tsx    # Core tracking component
│   └── ...
├── constants/            # App constants
└── hooks/                # Custom React hooks

API Integration

The app will integrate with the 511 API to provide real-time transit information. The API integration will be implemented once the endpoints are provided.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• San Francisco Municipal Transportation Agency (SFMTA) & 511 for providing transit data
• Expo team for their excellent React Native tooling