Gig Tracker

Features

🏠 Home Page

• Firebase Phone Authentication: Secure sign-in/sign-up with phone number.
• Dynamic Dashboard: Shows authenticated user content.
• Shift Management: Start/End work shifts with mileage tracking.
• Quick Entry: Buttons to quickly log gas purchases or other expenses (snacks/drinks).
• Today's Summary: At-a-glance view of today's earnings, spending, miles driven, and hours worked.
• Recent Activity Feed: A live-updating list of your most recent activities (gas, shifts, expenses).

⛽ Fuel & Expense Entry

• Geolocation & Maps: Automatically finds user's location and displays it on a Google Map.
• Nearby Gas Stations: Uses the Google Places API to search for and list nearby gas stations, sorted by distance.
• Simplified Fuel Entry: Enter price per gallon and total cost; gallons are calculated automatically.
• Mileage Validation: Ensures new mileage entries are greater than the last recorded value.
• Cloud Sync: All entries are saved directly to your personal Firebase Firestore database.

📊 Reports Page

• Visual Dashboard: A bar chart summarizes weekly hours worked and earnings.
• Comprehensive Stats: Key metrics like total miles, total earned, total spent, and average cost per mile.
• Advanced Filtering: Filter all activities by time period (week, month, year) and by type (gas, shifts, snacks, maintenance).
• Unified Activity Feed: A detailed, scrollable history of all your logged activities.
• Data Export: Download filtered gas data to a CSV file.

🔧 Maintenance Log

• Vehicle Status: Displays current mileage and a configurable "Oil Change Due" reminder.
• Quick Logging: Buttons to quickly log common maintenance tasks like car washes, oil changes, and repairs.
• Cost & Mileage Tracking: Optionally add cost and current mileage to maintenance records.
• Location Awareness: Automatically detects and saves the location of the service (e.g., "Jiffy Lube on Main St").
• Full History: A complete, scrollable log of all maintenance activities.

📍 Geo-Tagging

• Capture & Save: Save your current geographic coordinates with a single tap.
• Automatic Naming: Uses Google's Geocoding API to automatically name the location based on its address.
• Manage Places: View a list of all tagged locations, edit their names, or delete them.
• Quick Navigation: Includes a link to open any tagged location directly in Google Maps.

📱 PWA Features

• Installable: Can be installed on mobile home screen
• Offline Capable: Works without internet connection
• Service Worker: Caches essential files for offline use
• App-like Experience: Full-screen mode, app icons

Technology Stack

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Authentication: Firebase Authentication (Phone)
• Database: Firebase Firestore for real-time data synchronization and persistence.
• UI Framework: StickyMobile Bootstrap theme
• Styling: Tailwind CSS for utility classes
• Icons: Font Awesome
• Storage: `localStorage` is used for minor client-side caching (e.g., last mileage, PWA prompts).
• PWA: Service Worker, Web App Manifest
• Geolocation: HTML5 Geolocation API, Google Maps API, Google Places API

Data Storage

• Cloud Storage: All user-generated data (shifts, gas entries, expenses, etc.) is stored securely in your personal Firebase Firestore database, associated with your authenticated account.
• Real-time Sync: Data is synchronized in real-time across all devices where you are logged in.
• Local Caching: `localStorage` is used for non-critical data like UI preferences and PWA prompt timers.
• Data Export: The "Reports" page provides a feature to export your gas data to a CSV file for personal backup or analysis.

Privacy

• Location data is only used when app is active
• All user data is transmitted securely over HTTPS and stored in a private Firebase project.
• Data is not shared with third parties.
• Location tracking can be disabled in browser settings
• You can export your data at any time from the reports page.