RouteWise Mobile
A comprehensive jeepney navigation companion for commuters in Cebu Province. RouteWise helps users identify which jeepneys to ride, calculates total fares, and provides real-time notifications throughout their journey.
Features
🚐 Smart Route Identification
- Identifies which jeepney routes serve your origin and destination
- Shows specific jeepney route codes and names
- Provides direct routes when available
- Suggests transfer routes with clear connection points
- Displays multiple route alternatives for flexibility
💰 Comprehensive Fare Calculator
- Calculates complete fare for entire journey
- Shows individual costs for each jeepney segment
- Real-time pricing based on current fare rates
- Distance-based accurate calculations
- Compares costs across different route options
🔔 Real-Time Notifications
- Alerts when approaching transfer stops
- Reminds which jeepney to board next
- Notifies when to get off at destinations
- Step-by-step guidance throughout journey
- GPS-triggered location-based alerts
🗺️ Journey Management
- Complete trip planning from origin to destination
- Real-time location tracking and progress monitoring
- Clear transfer point identification
- Guidance on where to wait for connecting jeepneys
- Trip history for frequently traveled routes
Getting Started
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
- React Native development environment
- Android Studio (for Android development)
- Xcode (for iOS development on Mac)
Installation
- Clone the repository
git clone https://github.com/yourusername/routewise-mobile.git
cd routewise-mobile
- Install dependencies
npm install
# or
yarn install
- Install iOS dependencies (Mac only)
cd ios && pod install
cd ..
Running the App
Android
npm run android
# or
yarn android
iOS
npm run ios
# or
yarn ios
Start Metro bundler
npm start
# or
yarn start
Tech Stack
- React Native - Cross-platform mobile framework
- TypeScript - Type-safe development
- React Navigation - Navigation library
- Redux Toolkit - State management
- React Native Maps - Map integration
- AsyncStorage - Local data persistence
Project Structure
mobile/
├── src/
│ ├── components/ # Reusable UI components
│ ├── screens/ # App screens
│ ├── navigation/ # Navigation configuration
│ ├── services/ # API and external services
│ ├── store/ # Redux store and slices
│ ├── utils/ # Utility functions
│ ├── hooks/ # Custom React hooks
│ ├── types/ # TypeScript type definitions
│ ├── constants/ # App constants
│ └── assets/ # Images, fonts, etc.
├── android/ # Android-specific code
├── ios/ # iOS-specific code
└── __tests__/ # Test files
Development
Code Style
- Follow TypeScript best practices
- Use functional components with hooks
- Maintain consistent naming conventions
- Write self-documenting code
Testing
npm test
# or
yarn test
Linting
npm run lint
# or
yarn lint
Building for Production
Android
cd android
./gradlew assembleRelease
iOS
cd ios
xcodebuild -workspace RouteWise.xcworkspace -scheme RouteWise -configuration Release
Contributing
We welcome contributions! Please see our contributing guidelines for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature)
- Commit your changes (
git commit -m 'Add some AmazingFeature')
- Push to the branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
Team
- Vince Kevin Añana - Project Leader
- Jeff Gabriel Leung - Developer
- Daniel Montesclaros - Developer
- Mark John Toroy - Developer
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Cebu Institute of Technology University
- College of Engineering and Architecture
- Mr. Rex Seadino Jr. - Project Advisor
Support
For support, email [email protected] or open an issue in this repository.
Roadmap
RouteWise - Making jeepney travel simple and stress-free 🚐
