{"id":18189659,"url":"https://github.com/ngodat213/kiwis_flutter","last_synced_at":"2026-05-04T11:33:08.422Z","repository":{"id":260683713,"uuid":"863604437","full_name":"ngodat213/kiwis_flutter","owner":"ngodat213","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-23T06:24:12.000Z","size":8843,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T04:37:46.533Z","etag":null,"topics":["camera","expense-manager","fcm","firebase","social-network","socket-io","vietmap"],"latest_commit_sha":null,"homepage":"","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/ngodat213.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":"2024-09-26T15:24:42.000Z","updated_at":"2025-02-23T06:24:15.000Z","dependencies_parsed_at":"2024-11-01T20:27:09.634Z","dependency_job_id":"bdb4cc65-97a0-47be-a99f-f3ddecd0fa52","html_url":"https://github.com/ngodat213/kiwis_flutter","commit_stats":{"total_commits":1,"total_committers":1,"mean_commits":1.0,"dds":0.0,"last_synced_commit":"5208bdd4f953c085e8092992a9d2171ad1630889"},"previous_names":["ngodat213/kiwis_flutter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ngodat213/kiwis_flutter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngodat213%2Fkiwis_flutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngodat213%2Fkiwis_flutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngodat213%2Fkiwis_flutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngodat213%2Fkiwis_flutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ngodat213","download_url":"https://codeload.github.com/ngodat213/kiwis_flutter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngodat213%2Fkiwis_flutter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32605788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"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":["camera","expense-manager","fcm","firebase","social-network","socket-io","vietmap"],"created_at":"2024-11-03T04:03:39.185Z","updated_at":"2026-05-04T11:33:08.403Z","avatar_url":"https://github.com/ngodat213.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kiwis Flutter\n\nA Flutter application with advanced mapping and location features using VietMap integration.\n[Kiwis Demo](https://drive.google.com/file/d/1Yz9dKokiMr3sxB0LPazyc3M6ms6RZXtX/view?usp=sharing)\n\n![Giao diện ứng dụng](./photos/project1.png)\n## Features\n\n### Map Services\n- Custom map implementation using VietMap\n- Real-time location tracking\n- Custom markers with user avatars\n- Route drawing and navigation\n- Polyline tracking with auto-removal\n- Route recalculation when deviating\n- Location sharing in groups\n- Search locations with autocomplete\n\n### Location Services\n- High-accuracy location tracking\n- Background location updates\n- Distance calculation\n- Location permissions handling\n- GPS status monitoring\n\n### Core Features\n- Firebase integration (Auth, Firestore, Messaging, Crashlytics)\n- Multi-language support\n- Responsive design\n- File upload handling\n- API integration with caching\n- Socket.IO implementation\n- Local notifications\n\n### UI Components\n- Custom markers\n- Search with debouncing\n- Loading indicators\n- Snackbar notifications\n- Responsive layouts\n- Custom buttons and form fields\n\n## Technical Specifications\n\n### Dependencies\n- **Maps \u0026 Location**: \n  - vietmap_flutter_gl\n  - vietmap_flutter_plugin\n  - geolocator\n  - location\n\n- **State Management**:\n  - GetX\n  - Get It (Dependency Injection)\n\n- **Backend Integration**:\n  - Firebase Core\n  - Firebase Auth\n  - Firebase Messaging\n  - Cloud Firestore\n  - Socket.IO\n\n- **UI/UX**:\n  - Google Fonts\n  - Flutter SVG\n  - Cached Network Image\n  - Pull to Refresh\n  - Crystal Navigation Bar\n  - Animated Snackbar\n\n### Architecture\n- GetX pattern for state management\n- Service-based architecture\n- Repository pattern for data handling\n- Base API implementation with error handling\n- Custom utilities for responsive design\n\n### Key Services\n- MapService: Handles all map-related operations\n- GeolocatorService: Manages location tracking\n- AuthService: Handles authentication\n- NotificationService: Manages push notifications\n\n## Setup Requirements\n- Flutter SDK\n- Firebase project configuration\n- VietMap API key\n- Environment file (.env) configuration\n\n## Environment Variables \n\n## Installation \u0026 Setup Guide\n\n### Prerequisites\n1. Install Flutter SDK (version ^3.5.1)\n2. Install Android Studio or VS Code\n3. Setup your preferred IDE with Flutter and Dart plugins\n4. A physical device or emulator for testing\n\n### Step 1: Clone Repository\nbash\ngit clone [repository-url]\ncd kiwis_flutter\n\n### Step 2: Environment Setup\n1. Create a `.env` file in the root directory:\nenv\nVIETMAP_API_KEY=your_vietmap_api_key\n\n\n2. Firebase Setup:\n- Create a new Firebase project\n- Download `google-services.json` for Android\n- Download `GoogleService-Info.plist` for iOS\n- Place these files in their respective directories:\n  ```\n  android/app/google-services.json\n  ios/Runner/GoogleService-Info.plist\n  ```\n\n### Step 3: Install Dependencies\nbash\n```\nflutter pub get\n```\n\n### Step 4: iOS Setup\nbash\n```\ncd ios\npod install\ncd ..\n```\n\n### Step 5: Run the App\nbash\n```\nflutter run\n```\n\n## Development Guidelines\n\n### Code Structure\n```\nlib/\n├── core/ # Core functionality and utilities\n├── models/ # Data models\n├── services/ # Service classes\n├── views/ # UI screens\n├── widgets/ # Reusable widgets\n└── main.dart # Entry point```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngodat213%2Fkiwis_flutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fngodat213%2Fkiwis_flutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngodat213%2Fkiwis_flutter/lists"}