{"id":48693871,"url":"https://github.com/localstore-platform/mobile","last_synced_at":"2026-04-11T06:46:12.006Z","repository":{"id":326295491,"uuid":"1103386333","full_name":"localstore-platform/mobile","owner":"localstore-platform","description":"📱 Owner mobile app for LocalStore Platform - Flutter app for iOS \u0026 Android.  Daily monitoring, menu management, and AI-powered business insights for Vietnamese  restaurant owners. Offline-first with FCM push notifications.","archived":false,"fork":false,"pushed_at":"2025-12-06T16:05:00.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-09T07:20:30.428Z","etag":null,"topics":["android","dart","firebase-messaging","flutter","ios","mobile-app","offline-first","owner-app","restaurant-app","riverpod","vietnamese"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/localstore-platform.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-24T20:00:18.000Z","updated_at":"2025-12-06T16:05:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/localstore-platform/mobile","commit_stats":null,"previous_names":["localstore-platform/mobile"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/localstore-platform/mobile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstore-platform%2Fmobile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstore-platform%2Fmobile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstore-platform%2Fmobile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstore-platform%2Fmobile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/localstore-platform","download_url":"https://codeload.github.com/localstore-platform/mobile/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localstore-platform%2Fmobile/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31671630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"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":["android","dart","firebase-messaging","flutter","ios","mobile-app","offline-first","owner-app","restaurant-app","riverpod","vietnamese"],"created_at":"2026-04-11T06:46:11.317Z","updated_at":"2026-04-11T06:46:11.995Z","avatar_url":"https://github.com/localstore-platform.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# LocalStore Mobile App\n\n📱 Owner mobile app for LocalStore Platform - Flutter app for iOS \u0026 Android. Daily monitoring, menu management, and AI-powered business insights for Vietnamese restaurant owners. Offline-first with FCM push notifications.\n\n## 📖 Specifications\n\nThis repository implements features defined in the [LocalStore Platform Specs](https://github.com/localstore-platform/specs/tree/v1.1-specs).\n\nSee [docs/SPEC_LINKS.md](docs/SPEC_LINKS.md) for detailed specification references.\n\n## 🛠 Tech Stack\n\n- **Framework:** Flutter 3.x + Dart 3.x\n- **State Management:** Riverpod 2.4\n- **Networking:** Dio + Retrofit\n- **Local Storage:** Hive\n- **Push Notifications:** Firebase Cloud Messaging\n- **Navigation:** go_router\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Flutter 3.x ([Installation Guide](https://docs.flutter.dev/get-started/install))\n- Dart 3.x\n- Xcode (for iOS development)\n- Android Studio (for Android development)\n- CocoaPods (for iOS)\n\n### Setup\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/localstore-platform/mobile.git\n   cd mobile\n   ```\n\n2. **Copy environment configuration:**\n\n   ```bash\n   cp .env.example .env\n   # Edit .env with your configuration\n   ```\n\n3. **Install dependencies:**\n\n   ```bash\n   flutter pub get\n   ```\n\n4. **Run code generation (if applicable):**\n\n   ```bash\n   flutter pub run build_runner build --delete-conflicting-outputs\n   ```\n\n5. **Run the app:**\n\n   ```bash\n   # Run on connected device/emulator\n   flutter run\n\n   # Run on specific platform\n   flutter run -d ios\n   flutter run -d android\n   ```\n\n### Development Commands\n\n```bash\n# Run tests\nflutter test\n\n# Run tests with coverage\nflutter test --coverage\n\n# Analyze code\nflutter analyze\n\n# Format code\ndart format .\n\n# Build release APK\nflutter build apk --release\n\n# Build release iOS\nflutter build ios --release\n```\n\n## 📁 Project Structure\n\n```text\nlib/\n├── core/               # Core utilities, constants, theme\n│   ├── constants/\n│   ├── router/\n│   ├── theme/\n│   └── utils/\n├── features/           # Feature modules (Clean Architecture)\n│   ├── auth/\n│   ├── dashboard/\n│   ├── menu/\n│   └── settings/\n├── l10n/              # Localization files\n├── shared/            # Shared widgets and providers\n│   ├── providers/\n│   └── widgets/\n└── main.dart\n```\n\n## 🌐 Localization\n\nThe app supports Vietnamese (vi-VN) as the primary locale with English (en-US) fallback.\n\n- Currency: `75.000₫` (dot separator)\n- Date format: `dd/MM/yyyy`\n- All strings in `lib/l10n/`\n\n## 🔗 Related Repositories\n\n- [Specs Repository](https://github.com/localstore-platform/specs) - Technical specifications\n- [API Repository](https://github.com/localstore-platform/api) - Backend API\n- [Contracts Repository](https://github.com/localstore-platform/contracts) - Shared types\n\n## 📄 License\n\nThis project is licensed under the AGPL-3.0 License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstore-platform%2Fmobile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocalstore-platform%2Fmobile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalstore-platform%2Fmobile/lists"}