A Flutter application designed to empower hikers to discover the hidden gems and connect with the vibrant community of trails enthusiasts in Sri Lanka.
- Offline Mapping: Seamlessly explore trails even without an internet connection (using OpenStreetMap).
- Trail Database: Browse a rich database of Sri Lankan trails, including descriptions, difficulty ratings, and user reviews.
- Community Forum: Engage with fellow hikers, share experiences, and get recommendations.
- User Profiles: Personalize your hiking journey by tracking completed trails and saving favorites.
- [Future] Real-Time Updates: Receive up-to-date trail condition reports from users.
- [Future] AI-Powered Trail Recommendations: Discover trails tailored to your preferences.
- Flutter SDK (https://docs.flutter.dev/get-started/install)
- A code editor (VS Code or Android Studio are recommended)
- Firebase account (https://firebase.google.com/)
- Clone this repository.
- Install dependencies:
flutter pub get
- Set up a Firebase project and configure it within the app. (Instructions to follow in the project's setup guide).
- Run the app:
flutter run
lib
: Contains the core Flutter source code.screens
: Individual screen files.widgets
: Reusable UI components.models
: Data models.services
: Classes for interacting with Firebase and APIs.
pubspec.yaml
: Lists project dependencies.
We enthusiastically welcome contributions to the Serendib Trails project! Here's how you can help:
- Report Issues: If you find bugs or have feature ideas, please open an issue in the repository.
- Submit Code: Feel free to fork the repo, work on improvements, and submit pull requests.
- Spread the Word: Share Serendib Trails with other hikers and the Flutter community!
This project is licensed under the MIT License. See the LICENSE file for details.
- Project Maintainer: Malinga Rajapaksha (0606malingarajapaksha@gmail.com)
- Main Technologies: Flutter, Firebase, OpenStreetMap
Let's build a fantastic hiking app together!