Trailblaze Tracker

The application allows users to track rides in real-time via GPS, log them manually, or import them from GPX/TCX files. It features a personal dashboard to view ride history and statistics, team functionality to join and manage groups, and community feeds to see what others are up to.

Tech Stack

• Framework: Next.js (App Router) with React
• Language: TypeScript
• Styling: Tailwind CSS with ShadCN UI components, using a custom, modern theme with a fiery and high-contrast color palette.
• Backend & Database: Firebase (Authentication, Firestore, Storage)
• Generative AI: Genkit (Google AI)
• Deployment: Firebase App Hosting

Core Features

For All Trailblazers

• Track & Log Rides: Track rides in real-time with GPS, or manually log them with details, photos, and Strava links.
• Import from GPX/TCX: Easily import your past rides from other services by uploading GPX or TCX files.
• Personal Dashboard: View your personal ride history and see weekly/monthly summaries of your total mileage.
• Join & Discover Teams: Find new teams to join, participate in team activities, and see how you stack up.
• Team Chat: Communicate with teammates in a dedicated chat room, with support for images and location sharing.
• Community Feed: See what others are up to in global and team-specific community ride feeds.
• Team Challenges: Compete in team-wide challenges based on miles, number of rides, or weekly consistency.
• Public Profiles: Create a public profile page with a custom URL to share your stats and public rides.

For Team Managers

• Full Team Control: Edit your team's details, photo, and enable or disable features like Chat, Group Rides, and more.
• Member Management: Promote members to Manager or Coach, demote them, or remove them from the team.
• Easy Invite System: Generate and share a unique invite link that automatically adds new members to your team.
• Team Announcements: Create, edit, and publish announcements for your team.
• Schedule Group Rides: Organize team events by creating and managing group rides.
• Run Time Trials: Set up time trial events for your team and manage a live timer for each participant.
• AI Coaching Analysis: Use Gemini AI to analyze time trial results and generate personalized coaching feedback.
• Export Ride Data: Export team ride data to CSV or generate a picture-rich PDF report.
• Public Team Page: Create a public-facing page for your team to attract new members.

Admin Features

The application includes a comprehensive admin dashboard (/admin) for platform oversight, allowing administrators to:

• View application-wide statistics (total users, total teams).
• Manage all users in the system, including updating their roles (Admin, Manager, User).
• Manage all teams, including enabling/disabling features on a per-team basis and disabling entire teams.