{"id":25714017,"url":"https://github.com/amrit-dash/coffee-mapper-android","last_synced_at":"2025-08-12T21:08:56.050Z","repository":{"id":277619945,"uuid":"933005792","full_name":"amrit-dash/coffee-mapper-android","owner":"amrit-dash","description":"An Android application for Coffee Development Trust, Koraput to track and manage Coffee Plantations.","archived":false,"fork":false,"pushed_at":"2025-02-14T23:58:31.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T00:27:59.142Z","etag":null,"topics":["firebase","firebase-auth","firebase-firestore","flutter","flutter-android","flutter-apps"],"latest_commit_sha":null,"homepage":"https://coffeemapper.web.app","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/amrit-dash.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-14T23:43:06.000Z","updated_at":"2025-02-15T00:06:05.000Z","dependencies_parsed_at":"2025-02-15T00:38:10.802Z","dependency_job_id":null,"html_url":"https://github.com/amrit-dash/coffee-mapper-android","commit_stats":null,"previous_names":["amrit-dash/coffee-mapper-android"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrit-dash%2Fcoffee-mapper-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrit-dash%2Fcoffee-mapper-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrit-dash%2Fcoffee-mapper-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amrit-dash%2Fcoffee-mapper-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amrit-dash","download_url":"https://codeload.github.com/amrit-dash/coffee-mapper-android/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240666176,"owners_count":19837851,"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","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":["firebase","firebase-auth","firebase-firestore","flutter","flutter-android","flutter-apps"],"created_at":"2025-02-25T12:27:51.130Z","updated_at":"2025-02-25T12:27:51.602Z","avatar_url":"https://github.com/amrit-dash.png","language":"Dart","readme":"# Coffee Mapper\n\n\u003cdiv align=\"center\"\u003e\n\n![Coffee Mapper Logo](https://i.ibb.co/zWyCyM2x/logo-white.png)\n\n[![Flutter](https://img.shields.io/badge/Flutter-3.5.4-blue.svg)](https://flutter.dev/)\n[![Dart](https://img.shields.io/badge/Dart-3.5.0-blue.svg)](https://dart.dev)\n[![Firebase](https://img.shields.io/badge/Firebase-Enabled-orange.svg)](https://firebase.google.com/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/coffee_mapper/graphs/commit-activity)\n[![Made with Love](https://img.shields.io/badge/Made%20with-❤️-red.svg)](https://about.me/amritdash)\n\nAn Android application for Coffee Development Trust, Koraput to track and manage Coffee Plantations.\n\n[Features](#features) • [Installation](#installation) • [Environment Setup](#environment-setup) • [Usage](#usage) • [Contributing](#contributing) • [License](#license) • [Download](#download)\n\n---\n\n### 🚀 Quick Links\n\n[![Development Build](https://img.shields.io/badge/Download-Development%20Build-blue.svg)](https://drive.google.com/drive/folders/1C8NwMaO70dq4D4__WbDC1XxzWfgl8KTY?usp=drive_link)\n[![Production Build](https://img.shields.io/badge/Download-Production%20Build-green.svg)](https://drive.google.com/drive/folders/1Dkw3vWBz7sl_wriKBSacS3obYar-UhYu?usp=drive_link)\n\n![App Screenshots](https://i.ibb.co/b5C6mh6f/1.png)\n\n\u003c/div\u003e\n\n## ✨ Features\n\n🗺️ **Interactive Mapping**\n- Plot coffee plantation areas using GPS coordinates\n- Real-time area and perimeter calculations\n- Satellite view integration with Google Maps\n- Support for multiple image captures with location tagging\n\n📱 **User-Friendly Interface**\n- Clean and modern Material Design\n- Intuitive navigation\n- Responsive layout\n- Offline capability with data sync\n\n🔐 **Secure Authentication**\n- Firebase Authentication integration\n- Role-based access control\n- Admin dashboard for user management\n\n📊 **Plantation Management**\n- Detailed plantation information recording\n- Image capture and storage\n- Historical data tracking\n- Area-wise categorization\n\n🔄 **Sync \u0026 Backup**\n- Automatic data synchronization\n- Offline data persistence\n- Secure cloud storage for images\n- Real-time updates\n\n## 📥 Installation\n\n### Prerequisites\n\n1. Flutter SDK (^3.5.4)\n2. Android Studio\n3. Java Development Kit (JDK)\n4. Firebase Account\n5. Google Maps API Key\n\n### Getting Started\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/coffee_mapper.git\n   cd coffee_mapper\n   ```\n\n2. Install dependencies:\n   ```bash\n   flutter pub get\n   ```\n\n3. Follow the [Environment Setup](#environment-setup) instructions below.\n\n## ⚙️ Environment Setup\n\nThis project uses separate environments for development and production. Each environment has its own:\n- Firebase project\n- Google Maps API key\n- Package name\n\n### Initial Setup\n\nWhen setting up the project for the first time:\n\n1. Create necessary directories and copy template files:\n   ```bash\n   # Create directories\n   mkdir -p android/app/src/debug/res/values/\n   mkdir -p android/app/src/main/res/values/\n   \n   # Copy API Key templates\n   cp templates/strings.xml.template android/app/src/main/res/values/strings.xml\n   cp templates/strings.debug.xml.template android/app/src/debug/res/values/strings.xml\n   \n   # Copy keystore configuration template\n   cp templates/key.properties.template android/key.properties\n   ```\n\n2. Update the copied files with your actual values:\n   - Add your Maps API keys to both `strings.xml` files\n   - Update `key.properties` with your keystore details\n\n### Firebase Configuration\n\n1. Place your Firebase configuration files:\n   - Development: `android/app/google-services-dev.json`\n   - Production: `android/app/google-services-prod.json`\n\n2. Enable required Firebase services:\n   - Authentication\n   - Cloud Firestore\n   - Cloud Storage\n   - Crashlytics\n   - App Check\n\n### Google Maps Configuration\n\nConfigure Google Maps API keys in:\n1. Native Android configuration:\n   - Debug: `android/app/src/debug/res/values/strings.xml`\n   - Release: `android/app/src/main/res/values/strings.xml`\n2. Dart configuration in `lib/config/app_config.dart`\n\n## 🚀 Usage\n\n### Building the App\n\nUse the provided build scripts:\n\n```bash\n# Development build\n./scripts/build.sh dev 1.0.0\n\n# Production build\n./scripts/build.sh prod 1.0.0\n```\n\n### Running the App\n\nUse the run script for development:\n\n```bash\n# Run development version\n./scripts/run.sh dev\n\n# Production version\n./scripts/run.sh prod\n```\n\n### Security Notes\n\nThe following files contain sensitive information and should not be committed to version control:\n- `google-services-dev.json`\n- `google-services-prod.json`\n- `key.properties`\n- `*.jks` (keystore files)\n- `android/app/src/*/res/values/strings.xml`\n\n## 📱 Download\n\nYou can download the latest APK builds from the following links:\n\n- [Development Build](https://drive.google.com/drive/folders/1C8NwMaO70dq4D4__WbDC1XxzWfgl8KTY?usp=drive_link) - For testing and development purposes\n- [Production Build](https://drive.google.com/drive/folders/1Dkw3vWBz7sl_wriKBSacS3obYar-UhYu?usp=drive_link) - For end users\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. Fork the repository\n2. Create a new branch: `git checkout -b feature/your-feature`\n3. Make your changes\n4. Test thoroughly\n5. Create a pull request\n\nPlease read our [Contributing Guidelines](CONTRIBUTING.md) for more details.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Flutter Team for the amazing framework\n- Firebase for the robust backend services\n- Google Maps Platform for mapping services\n- Coffee Development Trust, Koraput for their support\n\n## 👨‍💻 Author\n\n**Amrit Dash**\n- Website: [about.me/amritdash](https://about.me/amritdash)\n- Twitter: [@amritdash](https://twitter.com/amritdash)\n- Email: [amrit.dash60@gmail.com](mailto:amrit.dash60@gmail.com)\n\n## 📞 Support\n\nIf you need help or have any questions, please email us at [geospatialtech.production@gmail.com](mailto:geospatialtech.production@gmail.com)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ for Coffee Development Trust, Koraput\n\n\u003csub\u003eIf you found this project helpful, please consider giving it a ⭐️\u003c/sub\u003e\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famrit-dash%2Fcoffee-mapper-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famrit-dash%2Fcoffee-mapper-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famrit-dash%2Fcoffee-mapper-android/lists"}