{"id":20648645,"url":"https://github.com/ccextractor/beacon","last_synced_at":"2025-05-16T17:04:54.956Z","repository":{"id":37961016,"uuid":"354548847","full_name":"CCExtractor/beacon","owner":"CCExtractor","description":"Flutter application to share location with a group. (under development)","archived":false,"fork":false,"pushed_at":"2025-04-27T15:34:58.000Z","size":10928,"stargazers_count":79,"open_issues_count":71,"forks_count":183,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-27T16:30:09.584Z","etag":null,"topics":["flutter","location-sharing"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/CCExtractor.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}},"created_at":"2021-04-04T13:20:30.000Z","updated_at":"2025-04-27T15:35:04.000Z","dependencies_parsed_at":"2025-01-09T07:04:57.440Z","dependency_job_id":"ac483b09-9fac-4d32-9601-6c0e4aeb161d","html_url":"https://github.com/CCExtractor/beacon","commit_stats":{"total_commits":170,"total_committers":17,"mean_commits":10.0,"dds":0.6764705882352942,"last_synced_commit":"4bc9d177bb6276fa8daa684b7873e8a69dfb8c48"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CCExtractor%2Fbeacon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CCExtractor%2Fbeacon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CCExtractor%2Fbeacon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CCExtractor%2Fbeacon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CCExtractor","download_url":"https://codeload.github.com/CCExtractor/beacon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254573588,"owners_count":22093731,"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":["flutter","location-sharing"],"created_at":"2024-11-16T17:09:39.536Z","updated_at":"2025-05-16T17:04:54.937Z","avatar_url":"https://github.com/CCExtractor.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beacon\n[![Flutter CI](https://github.com/CCExtractor/beacon/actions/workflows/flutter-ci.yml/badge.svg)](https://github.com/CCExtractor/beacon/actions/workflows/flutter-ci.yml)\n\n## Official Documentation\nhttps://ccextractor-beacon-docs.netlify.app/\n\nThe source code of documentation can be found here: https://github.com/CCExtractor/Beacon-Documentation\n\n## About the Project\n\nThis project is a flutter build native interface to ease the group travelling (or hiking). By using this, the group leader would be able to share his location with the entire crew, and in case if someone loses contact with the group, he can quickly get in the right place by following the beacon.\n\n## Getting Started\n\nYou can test Beacon in your own development environment. This section shows you how:\n\n### Prerequisites\n\nYou'll need to set up the IDE and mobile device emulator, or any mobile testing device on your local system.\n\n**Flutter Environment**: You'll need to have the following installed:\n1. [Flutter SDK](https://flutter.dev/docs/get-started/install)\n2. [Android Studio](https://developer.android.com/studio)\n\n***Ensure you are testing the app using Flutter version [3.0.1](https://docs.flutter.dev/development/tools/sdk/releases?tab=windows) and above.***\n\nFor checking flutter version:\n- Run `flutter --version` in terminal\n\nIf your version is not upto date, follow these steps to upgrade:\n- `flutter channel stable` to switch to the channel having stable version of flutter updates\n- `flutter upgrade` to get the latest flutter version\n\n**Development Environment**: For setting up the development environment, follow the steps given below.\n\n- Clone this repository after forking using `git clone https://github.com/\u003cusername\u003e/beacon.git`\n- `cd` into `beacon`\n- Check for flutter setup and connected devices using `flutter doctor`\n- Get all the dependencies using `flutter pub get`\n- Create a .env file in the root folder, copy the content from .env.example and add respected key's value\n- Run the app using `flutter run`\n\nFor help getting started with Flutter, view our\n[online documentation](https://flutter.dev/docs), which offers tutorials,\nsamples, guidance on mobile development, and a full API reference.\n\n## Project Structure\n\nThis project follows Clean architecture with following structure:\n\n```bash\nbeacon/\n├── lib/\n│   ├── config/                         # Configuration files\n│   ├── core/                           # Core application logic\n│   ├── data/\n│   │   ├── datasources/\n│   │   │   ├── local/                  # Local data sources\n│   │   │   └── remote/                 # Remote data sources\n│   │   ├── models/                     # Data models\n│   │   └── repositories/               # Data repositories\n│   ├── domain/\n│   │   ├── entities/                   # Domain entities\n│   │   ├── repositories/               # Domain repositories\n│   │   └── usecases/                   # Domain use cases\n│   ├── presentation/\n│   │   ├── auth/\n│   │   │   ├── cubit/                  # Authentication Cubit\n│   │   │   ├── widget/                 # Authentication widgets\n│   │   │   └── screen/                 # Authentication screens\n│   │   ├── home/\n│   │   │   ├── cubit/                  # Home Cubit\n│   │   │   ├── widget/                 # Home widgets\n│   │   │   └── screen/                 # Home screens\n│   │   ├── group/\n│   │   │   ├── cubit/                  # Group Cubit\n│   │   │   ├── widget/                 # Group widgets\n│   │   │   └── screen/                 # Group screens\n│   │   ├── hike/\n│   │   │   ├── cubit/                  # Hike Cubit\n│   │   │   ├── widget/                 # Hike widgets\n│   │   │   └── screen/                 # Hike screens\n│   │   ├── widgets/                    # Shared widgets used across all presentation folders\n│   │   └── splash_screen.dart          # Initial screen displayed while loading\n├── main.dart                           # App entry point\n├── theme/                              # Theme configurations\n├── locator.dart                        # Dependency injection setup (using get_it)\n├── router.dart                         # App navigation routes\n```\n\n## Screenshots\n\n\u003cimg src=\"screenshots/1.jpg\" width=\"24%\" /\u003e \u003cimg src=\"screenshots/2.jpg\" width=\"24%\"/\u003e \u003cimg src=\"screenshots/3.jpg\" width=\"24%\"/\u003e \u003cimg src=\"screenshots/4.jpg\" width=\"24%\"/\u003e\n\n\u003cimg src=\"screenshots/5.png\" width=\"24%\" /\u003e \u003cimg src=\"screenshots/6.png\" width=\"24%\"/\u003e \u003cimg src=\"screenshots/7.png\" width=\"24%\"/\u003e \u003cimg src=\"screenshots/8.png\" width=\"24%\"/\u003e\n\n\u003cimg src=\"screenshots/9.png\" width=\"24%\" /\u003e \u003cimg src=\"screenshots/10.png\" width=\"24%\"/\u003e \n\n## Contributing\n\nWhether you have some feauture requests/ideas, code improvements, refactoring, performance improvements, help is always Welcome. The more is done, better it gets.\n\nIf you found any bugs, consider opening an [issue](https://github.com/CCExtractor/beacon/issues/new).\n\n**To know the details about features implemented till Google Summer of Code'21 and future todo's please visit [this blog](https://blog.nishthab.tech/gsoc-2021-ccextractor-beacon)**\n\n## Community\n\nWe would love to hear from you! You may join gsoc-beacon channel of CCExtractor community through slack:\n\n[![Slack](https://img.shields.io/badge/chat-on_slack-purple.svg?style=for-the-badge\u0026logo=slack)](https://ccextractor.org/public/general/support/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccextractor%2Fbeacon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccextractor%2Fbeacon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccextractor%2Fbeacon/lists"}