TrailMates is an iOS application for spontaneous social meetups along the Ann and Roy Butler Trail in Austin, Texas. Whether you're looking for exercise companions or a quick hangout along the trail, TrailMates helps connect you with friends in real-time.
- Trail Location Sharing: Automatically updates your friends when you're active on the trail and shares your real-time location with them, limited strictly to trail usage.
- Do Not Disturb Mode: Provides full control over your visibility on the trail.
- Augmented Reality Enhancements: Leverages Swift for seamless AR integrations, enabling immersive interactions as you navigate the trail.
- Privacy-Focused: Location sharing is trail-specific, with additional privacy settings to ensure users control their visibility.
TrailMates started in React Native, providing a flexible cross-platform foundation but later transitioned to Swift to optimize performance, especially for native iOS AR integrations. Leveraging Swift’s robust performance and ARKit integration, TrailMates achieves fluid, low-latency AR interactions that enhance user experience along the trail.
- Swift: Powers the iOS app, ensuring smooth AR and real-time location updates.
- ARKit: Adds augmented reality overlays, giving users spatial awareness and enriching their experience on the trail.
- CoreLocation: Manages real-time trail-specific location sharing, with careful handling of background updates to balance accuracy and battery efficiency.
- Cloud Firestore (optional): Supports real-time location storage and friend notifications, enabling instant, secure data updates for group interactions.
- Clone the repository:
git clone https://github.com/username/trailmates.git - Navigate to the project directory:
cd trailmates - Install dependencies:
pod install - Open the
.xcworkspacefile in Xcode:open TrailMates.xcworkspace - Configure API keys: Set up environment keys for Firestore or other services in your Xcode project.
- Run the app:
Command + R
- Expanded AR Features: Plan to add AR gamification elements like friend proximity indicators and interactive checkpoints along the trail.
- Custom Privacy Settings: User-defined location sharing schedules for even more personalized privacy.
- Trail Events: Notifications about public or friend-hosted events along the trail.
Contributions to TrailMates are welcome. To contribute:
- Fork the repository.
- Create a new branch.
- Submit a pull request with clear descriptions and concise commits.
TrailMates is licensed under the MIT License.