{"id":35523905,"url":"https://github.com/maninder-mike/milow","last_synced_at":"2026-04-14T00:01:24.635Z","repository":{"id":326937455,"uuid":"1107199972","full_name":"Maninder-mike/milow","owner":"Maninder-mike","description":"Offline trip \u0026 fuel tracking for truckers. Syncs with dispatch in real-time.","archived":false,"fork":false,"pushed_at":"2026-04-11T06:22:28.000Z","size":37269,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"beta","last_synced_at":"2026-04-11T08:28:34.186Z","etag":null,"topics":["android","ios","macos","windows"],"latest_commit_sha":null,"homepage":"https://www.maninder.co.in/milow","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maninder-mike.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-30T19:07:24.000Z","updated_at":"2026-04-11T06:14:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Maninder-mike/milow","commit_stats":null,"previous_names":["maninder-mike/milow"],"tags_count":60,"template":false,"template_full_name":null,"purl":"pkg:github/Maninder-mike/milow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maninder-mike%2Fmilow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maninder-mike%2Fmilow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maninder-mike%2Fmilow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maninder-mike%2Fmilow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maninder-mike","download_url":"https://codeload.github.com/Maninder-mike/milow/tar.gz/refs/heads/beta","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maninder-mike%2Fmilow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31776013,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["android","ios","macos","windows"],"created_at":"2026-01-04T00:26:43.207Z","updated_at":"2026-04-14T00:01:24.616Z","avatar_url":"https://github.com/Maninder-mike.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eMilow\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eFleet Management \u0026 Driver Operations Platform\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#apps\"\u003eApps\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n  \u003ca href=\"#architecture\"\u003eArchitecture\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Flutter-3.32+-02569B?logo=flutter\" alt=\"Flutter\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Dart-3.10+-0175C2?logo=dart\" alt=\"Dart\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Supabase-Backend-3FCF8E?logo=supabase\" alt=\"Supabase\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-iOS%20%7C%20Android%20%7C%20macOS%20%7C%20Windows-lightgrey\" alt=\"Platforms\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\nMilow is a comprehensive fleet management solution designed for trucking and logistics companies. It consists of two purpose-built applications:\n\n- **Milow Driver** — Mobile app for drivers to log trips, fuel purchases, and expenses\n- **Milow Terminal** — Desktop app for dispatchers and fleet managers\n\nBuilt with performance, reliability, and offline-first capabilities at its core.\n\n---\n\n## Features\n\n### 🚛 Driver App (iOS \u0026 Android)\n\n| Feature | Description |\n|---------|-------------|\n| **Trip Logging** | Record pickups, deliveries, border crossings, and trailers |\n| **Fuel Tracking** | Log fuel and DEF purchases with receipt scanning |\n| **Expense Management** | Capture receipts and categorize expenses |\n| **Offline-First** | Full functionality without internet connection |\n| **Document Scanner** | AI-powered receipt and document scanning |\n| **Dynamic Theming** | Material You with wallpaper-based colors |\n\n### 🖥️ Terminal App (macOS \u0026 Windows)\n\n| Feature | Description |\n|---------|-------------|\n| **Fleet Dashboard** | Real-time vehicle status and location overview |\n| **Driver Management** | Assign drivers to vehicles, track HOS compliance |\n| **Dispatch Board** | Drag-and-drop load assignment and routing |\n| **IFTA Reporting** | Automated fuel tax calculation and reporting |\n| **User Roles** | Admin, dispatcher, and viewer permission levels |\n| **Biometric Login** | Touch ID / Windows Hello support |\n\n---\n\n## Apps\n\n### Milow Driver\n\n```\napps/driver/\n├── lib/\n│   ├── core/           # Theme, providers, services\n│   └── features/       # Feature modules (trips, fuel, expenses)\n└── test/               # Unit and widget tests\n```\n\n**Platforms:** iOS 15+, Android 8.0+\n\n### Milow Terminal\n\n```\napps/terminal/\n├── lib/\n│   ├── core/           # Router, providers, theme\n│   └── features/       # Feature modules (auth, dashboard, dispatch)\n└── test/               # Unit and widget tests\n```\n\n**Platforms:** macOS 12+, Windows 10+\n\n---\n\n## Installation\n\n### Milow Terminal (macOS)\n\n#### Install\n\n```bash\nbrew tap Maninder-mike/milow-terminal\nbrew install --cask milow-terminal\n```\n\n#### Update\n\n```bash\nbrew update\nbrew upgrade --cask milow-terminal\n```\n\n#### Uninstall\n\n```bash\nbrew uninstall --cask milow-terminal\nbrew untap Maninder-mike/milow-terminal\n```\n\n#### Troubleshooting\n\nIf you encounter issues during installation or update:\n\n```bash\n# Clear Homebrew cache\nbrew cleanup --prune=all\n\n# Reinstall from scratch\nbrew uninstall --cask milow-terminal\nbrew untap Maninder-mike/milow-terminal\nbrew tap Maninder-mike/milow-terminal\nbrew install --cask milow-terminal\n```\n\n### Milow Terminal (Windows)\n\nAvailable on the [Microsoft Store](https://apps.microsoft.com/detail/9p641q1x1bmg).\n\n### Milow Driver\n\n**Android:** Available on the [Google Play Store](https://play.google.com/store/apps/details?id=maninder.co.in.milow)\n\n**iOS:** Coming soon to the App Store\n\n---\n\n## Development\n\n### Prerequisites\n\n- Flutter SDK 3.32+\n- Dart 3.10+\n- Xcode 15+ (for iOS/macOS)\n- Android Studio (for Android)\n- Visual Studio 2022 (for Windows)\n\n### Getting Started\n\n```bash\n# Clone the repository\ngit clone https://github.com/Maninder-mike/milow.git\ncd milow\n\n# Install dependencies\nflutter pub get\n\n# Create environment file\ncp apps/terminal/.env.example apps/terminal/.env\n# Edit .env with your Supabase credentials\n\n# Run the Terminal app\ncd apps/terminal \u0026\u0026 flutter run -d macos\n\n# Run the Driver app\ncd apps/driver \u0026\u0026 flutter run\n```\n\n### Running Tests\n\n```bash\n# All tests\nflutter test\n\n# Terminal app tests\ncd apps/terminal \u0026\u0026 flutter test\n\n# Driver app tests\ncd apps/driver \u0026\u0026 flutter test\n```\n\n### Code Quality\n\n```bash\n# Static analysis\nflutter analyze\n\n# Format code\ndart format .\n```\n\n---\n\n## Architecture\n\n### Monorepo Structure\n\n```\nmilow/\n├── apps/\n│   ├── driver/         # Mobile app (iOS/Android)\n│   └── terminal/       # Desktop app (macOS/Windows)\n├── packages/\n│   └── core/           # Shared business logic\n├── database/\n│   └── migrations/     # Supabase migrations\n└── .github/\n    └── workflows/      # CI/CD pipelines\n```\n\n### Tech Stack\n\n| Layer | Technology |\n|-------|------------|\n| **Frontend** | Flutter, Riverpod, go_router |\n| **UI (Mobile)** | Material 3 Expressive |\n| **UI (Desktop)** | Fluent UI |\n| **Backend** | Supabase (PostgreSQL, Auth, Storage) |\n| **CI/CD** | GitHub Actions |\n| **Distribution** | Play Store, Homebrew, Windows Store |\n\n### State Management\n\n- **Driver App:** Provider\n- **Terminal App:** Riverpod with code generation\n\n---\n\n## Security\n\n- Row-Level Security (RLS) on all database tables\n- JWT-based authentication via Supabase Auth\n- Compile-time secrets injection for production builds\n- Biometric authentication support\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n---\n\n\u003cp align=\"center\"\u003e\n  Built with ❤️ by the Milow Team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaninder-mike%2Fmilow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaninder-mike%2Fmilow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaninder-mike%2Fmilow/lists"}