Mashhad Metro is a free and open-source mobile application designed to help residents and pilgrims navigate the Mashhad Metro system with ease. Built with Flutter, this app provides comprehensive information about all metro stations, lines, facilities, and real-time navigation assistance.
Data Source: This application uses metro station data from the mashhad-metro-data repository, which maintains accurate and up-to-date information about the Mashhad Metro system.
Whether you're a daily commuter or visiting the holy city for the first time, Mashhad Metro is your essential companion for exploring the city's metro network.
- 🗺️ Interactive Map - View all metro stations on an interactive map with zoom and navigation capabilities
- 📍 Complete Station Information - Access detailed information for each station including addresses and exact locations
- 🏢 Facilities Finder - Easily locate stations with specific amenities (elevators, restrooms, WiFi, parking, etc.)
- 🚉 Multi-Line Support - Browse all metro lines and identify interchange stations seamlessly
- 📱 Offline Access - Use all station information without an internet connection
- 🎨 Modern UI/UX - Clean, intuitive interface with dark mode support
- ♿ Accessibility - Designed for users of all ages and abilities
- 🆓 100% Free & Open Source - No ads, no tracking, no hidden costs
| Platform | Myket | Bazaar | Anardoni | F-Droid | GitHub Releases |
|---|---|---|---|---|---|
| Android |  |
 |
- |  |
 |
| iOS | - | - |  |
- | |
Before you begin, ensure you have the following installed:
- Flutter SDK (3.0.0 or higher)
- Android Studio or Xcode (for iOS)
- Git
- Clone the repository
git clone https://github.com/shahriaarrr/mashhad-metro.git
cd mashhad-metro- Install dependencies
flutter pub get- Run the app in debug mode
flutter run- Build for Android (APK)
flutter build apk --releaseThe APK file will be located at: build/app/outputs/flutter-apk/app-release.apk
- Build for Android (App Bundle)
flutter build appbundle --releaseThe AAB file will be located at: build/app/outputs/bundle/release/app-release.aab
- Build for iOS (macOS only)
flutter build ios --releaseTo customize the build, you can modify the following files:
android/app/build.gradle- Android build configurationios/Runner.xcodeproj- iOS build configurationpubspec.yaml- Project dependencies and metadata
App Icon Design: Sajjad Khiabani
A special thanks to Sajjad for creating the beautiful and modern app icon that perfectly represents the spirit of Mashhad Metro.
Warning
Important Notice
If you notice any incorrect or outdated information about metro stations, facilities, or routes, please DO NOT report it here.
All metro data is maintained in a separate repository:
👉 mashhad-metro-data
Please report data issues or submit corrections there. This helps keep the data accurate for all applications that use it.
Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, we appreciate your help in making Mashhad Metro better.
- 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
Please read our Contributing Guidelines for more details.
The user interface of this project was inspired by the beautiful design of the Tehran Metro App created by @mosayeb-a.
Their thoughtful approach to creating an intuitive and visually appealing metro navigation experience served as a foundation for this project's design language. We're grateful for their contribution to making public transportation more accessible through great design.
If you encounter any issues, please open an issue with:
- A clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Screenshots (if applicable)
- Device information and OS version
- GitHub Issues: Report a bug or request a feature
- Email: shahriaarrr@gmail.com
- Project Repository: github.com/shahriaarrr/mashhad-metro
Made with ❤️ for pilgrims and residents of Mashhad
⭐ If you find this app helpful, please consider giving it a star on GitHub! ⭐