{"id":30174070,"url":"https://github.com/web-dev-nav/uber-minimum-wage-calculator","last_synced_at":"2026-02-10T02:02:05.405Z","repository":{"id":303398503,"uuid":"1015275707","full_name":"web-dev-nav/uber-minimum-wage-calculator","owner":"web-dev-nav","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-18T05:28:49.000Z","size":24817,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T08:19:42.635Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/web-dev-nav.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-07T09:05:05.000Z","updated_at":"2025-07-18T05:28:53.000Z","dependencies_parsed_at":"2025-07-07T12:37:45.553Z","dependency_job_id":null,"html_url":"https://github.com/web-dev-nav/uber-minimum-wage-calculator","commit_stats":null,"previous_names":["web-dev-nav/uber-minimum-wage-calculator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/web-dev-nav/uber-minimum-wage-calculator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2Fuber-minimum-wage-calculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2Fuber-minimum-wage-calculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2Fuber-minimum-wage-calculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2Fuber-minimum-wage-calculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/web-dev-nav","download_url":"https://codeload.github.com/web-dev-nav/uber-minimum-wage-calculator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2Fuber-minimum-wage-calculator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269977248,"owners_count":24506551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-12T00:15:26.283Z","updated_at":"2026-02-10T02:02:05.343Z","avatar_url":"https://github.com/web-dev-nav.png","language":"Blade","readme":"# Uber Minimum Wage Calculator\n\nA Laravel-based web application that calculates minimum wage for Uber drivers across Canadian provinces, with special support for Ontario's Digital Platform Workers' Rights Act.\n\n\u003cimg width=\"1920\" height=\"1902\" alt=\"captureit_7-29-2025_at_01-24-10\" src=\"https://github.com/user-attachments/assets/9b0af8c4-9b38-4c6e-bbcd-29c5196a481b\" /\u003e\n\n## 🚗 Features\n\n- **Province-based minimum wage calculation** for all Canadian provinces/territories\n- **Ontario Digital Platform Workers' Rights Act** support ($17.20/hour minimum)\n- **IP-based province detection** for automatic location selection\n- **Time format support** (Hours:Minutes - e.g., 8:30)\n- **Net fare and tips integration** for complete earnings calculation\n- **Uber API integration** for automatic data import (optional)\n- **Responsive Uber-style UI** with clean, professional design\n\n## 📊 Calculation Formula\n\n1. **Minimum Wage = Active Time × Hourly Rate**\n2. **Hour Total = Minimum Wage - Net Fare** (amount owed to driver)\n3. **Total Earnings = Hour Total + Net Fare + Tips**\n\nThe \"Hour Total\" represents the minimum wage top-up that platforms must pay drivers under the Digital Platform Workers' Rights Act.\n\n## 🛠 Installation\n\n### Prerequisites\n- PHP 8.1+\n- Composer\n- MySQL/SQLite\n- Node.js \u0026 NPM (for assets)\n\n### Setup Steps\n\n1. **Clone the repository**\n```bash\ngit clone \u003crepository-url\u003e\ncd uber-minimum-wage-calculator\n```\n\n2. **Install dependencies**\n```bash\ncomposer install\nnpm install\n```\n\n3. **Environment configuration**\n```bash\ncp .env.example .env\nphp artisan key:generate\n```\n\n4. **Database setup**\n```bash\n# For MySQL\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=uber_wage_calculator\nDB_USERNAME=root\nDB_PASSWORD=your_password\n\n# Or for SQLite (simpler)\nDB_CONNECTION=sqlite\n```\n\n5. **Run migrations and seeders**\n```bash\nphp artisan migrate\nphp artisan db:seed\n```\n\n6. **Start the development server**\n```bash\nphp artisan serve\n```\n\nVisit `http://localhost:8000` to use the calculator.\n\n## 🔌 Uber API Integration (Optional)\n\n### Setting up Uber Developer Account\n\n⚠️ **Important:** The current Uber API credentials in the code are invalid/demo credentials. To enable real Uber integration, you need to:\n\n1. **Register as Uber Developer**\n   - Go to [Uber Developer Portal](https://developer.uber.com/)\n   - Create an account and verify your identity\n   - Apply for API access (may require business verification)\n\n2. **Create an Application**\n   - Create a new app in the developer dashboard\n   - Set your redirect URI to: `http://your-domain.com/uber/callback`\n   - Note down your Client ID and Client Secret\n\n3. **Configure Environment Variables**\n```bash\n# Add to .env file\nUBER_CLIENT_ID=your_actual_client_id\nUBER_CLIENT_SECRET=your_actual_client_secret\n```\n\n4. **Request Appropriate Scopes**\n   - `partner.trips` - For trip data access\n   - `partner.payments` - For earnings data access\n   - May require special approval from Uber\n\n### API Limitations\n\n- **Access Restrictions:** Uber limits API access to verified partners\n- **Scope Requirements:** Trip and payment data requires special permissions\n- **Rate Limits:** API calls are limited per application\n- **Data Privacy:** Subject to Uber's data usage policies\n\n### Alternative Solutions\n\nIf official API access isn't available:\n\n1. **Manual CSV Import** (recommended)\n   - Drivers export earnings from Uber Driver app\n   - Upload CSV files to the calculator\n   - Automatic parsing and calculation\n\n2. **Manual Data Entry** (current default)\n   - Drivers enter active time, net fare, and tips manually\n   - Still provides accurate minimum wage calculations\n\n## 🗺 Province Data\n\nThe application includes current minimum wage rates for all Canadian provinces:\n\n- **Ontario:** $17.20/hr (Digital Platform Workers' Rights Act)\n- **British Columbia:** $17.85/hr\n- **Nunavut:** $19.00/hr (highest in Canada)\n- **Alberta:** $15.00/hr\n- And all other provinces/territories...\n\nData is regularly updated based on [Government of Canada minimum wage rates](https://minwage-salairemin.service.canada.ca/en/general.html).\n\n## 🎨 Design\n\nThe application features an authentic Uber-style design:\n- **Black header** with Uber branding\n- **Clean white cards** on dark background\n- **Professional typography** with UberMove font family\n- **Responsive design** for mobile and desktop\n\n## 🧪 Testing\n\n```bash\n# Run tests\nphp artisan test\n\n# Run specific test suites\nphp artisan test --testsuite=Feature\nphp artisan test --testsuite=Unit\n```\n\n## 📝 API Endpoints\n\n### Public Endpoints\n- `GET /` - Main calculator interface\n- `POST /calculate` - Calculate wages\n- `GET /api/provinces` - Get province wage rates\n\n### Uber Integration Endpoints\n- `GET /uber/authorize` - Start Uber OAuth flow\n- `GET /uber/callback` - OAuth callback handler\n- `GET /uber/fetch-data` - Fetch driver trip/earnings data\n- `POST /uber/disconnect` - Disconnect from Uber\n\n## 🔒 Security\n\n- **CSRF Protection** on all forms\n- **Input validation** for all user data\n- **Secure OAuth flow** for Uber integration\n- **Session-based token storage** (recommend database storage for production)\n\n## 📄 License\n\nThis project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests for new functionality\n5. Submit a pull request\n\n## ⚠️ Disclaimer\n\nThis calculator is for informational purposes only. Always verify calculations with official government sources and consult legal professionals for employment law questions.\n\n**Government Reference:** [Official Canadian Minimum Wage Rates](https://minwage-salairemin.service.canada.ca/en/general.html)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb-dev-nav%2Fuber-minimum-wage-calculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweb-dev-nav%2Fuber-minimum-wage-calculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb-dev-nav%2Fuber-minimum-wage-calculator/lists"}