- Real-Time GPS Tracking - Accurate speed monitoring using device GPS
- Multi-Transport Modes - Walking, Running, Car, Train, Flight with custom speed limits
- Interactive Speedometer - Beautiful animated digital speedometer with progress rings
- Journey Recording - Complete path tracking with timestamps and speed data
- Live Map Integration - OpenStreetMap with real-time position and route visualization
- Journey History - Detailed statistics for all tracked journeys
- Speed Analytics - Max speed, average speed, and speed distribution
- Elevation Tracking - Altitude monitoring with elevation gain/loss
- Achievement System - Gamified experience with unlockable achievements
- Weather Integration - Real-time weather data for journey context
- Dark/Light Theme - Seamless theme switching with system preference detection
- Responsive Design - Optimized for mobile, tablet, and desktop
- Offline Support - Works without internet connection (GPS only)
- Speed Alerts - Customizable speed limit warnings
- PWA Ready - Installable as mobile app
- TypeScript - Full type safety and better developer experience
- Performance Optimized - Fast loading with code splitting
- Accessibility - WCAG compliant with screen reader support
- Privacy First - All data stored locally, no tracking
SpeedSync main interface showing the digital speedometer, transport modes, and real-time tracking controls
- 🎯 Interactive Speedometer - Large digital display with progress ring
- 🚗 Transport Mode Selection - Walking, Running, Car, Train, Flight options
- ⚙️ Speed Settings - Customizable speed limits and alerts
- 📊 Real-time Stats - Distance, duration, max/avg speed tracking
- 🎨 Modern UI - Clean, responsive design with smooth animations
- 📱 Mobile Optimized - Perfect for on-the-go speed tracking
- Node.js 18+
- npm, yarn, or pnpm
- Modern browser with GPS support
# Clone the repository
git clone https://github.com/ahansardar/SpeedSync---A-Speedometer-For-All-Your-Rides.git
cd speedsync
# Install dependencies
npm install
# or
yarn install
# or
pnpm install
# Start development server
npm run dev
# or
yarn dev
# or
pnpm devOpen http://localhost:3000 in your browser.
Create a `.env.local` file in the root directory:
- Allow Location Access - Grant GPS permissions when prompted
- Select Transport Mode - Choose from walking, running, car, train, or flight
- Set Speed Limit - Configure speed alerts for safety
- Start Tracking - Tap the play button to begin journey recording
- Monitor Speed - Watch real-time speed on the digital speedometer
- View Journey - See your path on the integrated map
- Stop & Save - End tracking to save journey data
- 🚶 Walking (0-8 km/h) - Perfect for pedestrian tracking
- 🏃 Running (0-25 km/h) - Ideal for jogging and running
- 🚗 Car (0-200 km/h) - Standard vehicle tracking
- 🚆 Train (0-300 km/h) - High-speed rail monitoring
✈️ Flight (0-900 km/h) - Aviation speed tracking
Unlock achievements by reaching milestones:
- 🏆 Speed Demon - Reach 100+ km/h
- 🗺️ Explorer - Travel 10+ km in one journey
- ⏱️ Endurance Master - Journey for over 1 hour
- 🚴 Century Rider - Travel 100+ km
- And many more!
- Next.js 15 - React framework with App Router
- TypeScript - Type-safe JavaScript
- Tailwind CSS - Utility-first CSS framework
- Shadcn/ui - Beautiful, accessible UI components
- Lucide React - Modern icon library
- Geolocation API - GPS tracking
- OpenStreetMap - Map tiles and routing
- OpenWeather API - Weather data (optional)
- Local Storage - Client-side data persistence
- ESLint - Code linting
- Prettier - Code formatting
- TypeScript - Static type checking
- Tailwind CSS - Styling
speedsync/
├── app/ # Next.js App Router
│ ├── globals.css # Global styles
│ ├── layout.tsx # Root layout
│ └── page.tsx # Main application
├── components/ # React components
│ ├── ui/ # Shadcn/ui components
│ ├── speedsync-icon.tsx # Custom app icon
│ ├── achievement-panel.tsx
│ └── theme-provider.tsx
├── lib/ # Utility functions
├── public/ # Static assets
├── docs/ # Documentation
└── README.md
# Build for production
npm run build
# Start production server
npm start# Build Docker image
docker build -t speedsync .
# Run container
docker run -p 3000:3000 speedsync- Netlify - Connect GitHub repo for auto-deployment
- GitHub Pages - Use `npm run export` for static export
- Railway - One-click deployment from GitHub
- Local Storage Only - All journey data stored on your device
- No Tracking - No analytics or user tracking by default
- GPS Only - Location data never leaves your device
- Open Source - Full transparency of data handling
- HTTPS Required - Secure connection for GPS access
- Permission-Based - Explicit GPS permission required
- No Server Storage - No personal data on external servers
- Client-Side Processing - All calculations done locally
We welcome contributions!
# Fork and clone the repo
git clone https://github.com/ahansardar/SpeedSync---A-Speedometer-For-All-Your-Rides.git
# Create a feature branch
git checkout -b feature/amazing-feature
# Make your changes and commit
git commit -m 'Add amazing feature'
# Push to your fork
git push origin feature/amazing-feature
# Open a Pull Request- 🌍 Internationalization - Multi-language support
- 📊 Analytics - Advanced journey analytics
- 🎨 Themes - Additional color schemes
- 🔌 Integrations - Third-party service connections
- 📱 Mobile App - React Native version
- 🧪 Testing - Unit and integration tests
- Performance: 95+
- Accessibility: 100
- Best Practices: 100
- SEO: 100
- First Contentful Paint: < 1.5s
- Largest Contentful Paint: < 2.5s
- Cumulative Layout Shift: < 0.1
- First Input Delay: < 100ms
- Indoor GPS may be less accurate
- Requires clear sky view for best results
- Battery usage increases during tracking
- Requires modern browser with Geolocation API
- HTTPS required for GPS access
- Some features may not work in private/incognito mode
- Continuous GPS tracking affects battery life
- Large journey datasets may impact performance
- Map rendering requires good internet connection
- Offline Maps - Download maps for offline use
- Journey Sharing - Share journeys with friends
- Route Planning - Plan routes before traveling
- Voice Alerts - Audio speed limit warnings
- Fitness Integration - Connect with fitness trackers
- Social Features - Leaderboards and challenges
- Advanced Analytics - Machine learning insights
- API Integration - Connect with other apps
This project is licensed under the MIT License - see the LICENSE file for details.
- OpenStreetMap - Map data and tiles
- Shadcn/ui - Beautiful UI components
- Vercel - Hosting and deployment
- Next.js Team - Amazing React framework
- Tailwind CSS - Utility-first CSS framework
- Portfolio: Ahan Sardar)
- GitHub: @ahansardar
- Email: ahansardarvis@gmail.com
- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📖 Documentation: Wiki
Built with ❤️ for the developer community
