{"id":26671940,"url":"https://github.com/bdadmehr0/aktshaf","last_synced_at":"2026-04-13T07:03:10.613Z","repository":{"id":284264503,"uuid":"954368047","full_name":"BDadmehr0/Aktshaf","owner":"BDadmehr0","description":"Aktshaf A city exploration system that shows the user's level of city discovery.","archived":false,"fork":false,"pushed_at":"2025-03-25T01:44:06.000Z","size":271,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T02:32:45.515Z","etag":null,"topics":["application","city-exploration","cross-platform","js","react-native"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/BDadmehr0.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}},"created_at":"2025-03-25T01:19:31.000Z","updated_at":"2025-03-25T01:55:41.000Z","dependencies_parsed_at":"2025-03-25T02:32:49.421Z","dependency_job_id":"28550b77-3646-4b5d-b4e3-708648b8a7ed","html_url":"https://github.com/BDadmehr0/Aktshaf","commit_stats":null,"previous_names":["bdadmehr0/aktshaf"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDadmehr0%2FAktshaf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDadmehr0%2FAktshaf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDadmehr0%2FAktshaf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDadmehr0%2FAktshaf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BDadmehr0","download_url":"https://codeload.github.com/BDadmehr0/Aktshaf/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245566385,"owners_count":20636452,"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":["application","city-exploration","cross-platform","js","react-native"],"created_at":"2025-03-26T00:35:37.791Z","updated_at":"2026-04-13T07:03:05.581Z","avatar_url":"https://github.com/BDadmehr0.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aktshaf\n\nAktshaf A city exploration system that shows the user's level of city discovery.\n\nCity Explorer App is a React Native application designed to help users explore their surroundings, track their movements, and visualize how much of a city they've covered. It uses GPS to display the user's current location on a map, highlights the areas they've visited, and calculates the percentage of the city they've explored based on predefined city boundaries. The app is built with React Native, utilizing `react-native-maps` and `react-native-geolocation-service`.\n\n## Features\n\n- **Real-time Location Tracking:** Display the user's current location on an interactive map.\n- **City Boundary Visualization:** Show the boundaries of the city based on available map data.\n- **Tracking Visited Areas:** Track and visualize the areas the user has explored, coloring the visited regions.\n- **Exploration Progress:** Calculate and display the percentage of the city explored based on the user's movements.\n  \n## Long-Term Vision \u0026 Planning\n\n### Milestones\n\n#### **Phase 1: Core Functionality (Completed)**\n- **Location Tracking:** Display user location on the map.\n- **Basic Map Interaction:** Ability to interact with the map and zoom in/out.\n- **Visited Areas:** Track areas the user has already visited and highlight them.\n- **City Boundaries:** Display the boundaries of the city based on initial data.\n\n#### **Phase 2: User Experience Enhancement**\n- **Real-Time Tracking:** Implement real-time tracking to update the user's location and visited area continuously.\n- **Improved Boundary Detection:** Enhance the accuracy of city boundaries by integrating additional data sources.\n- **Path Tracing:** Visualize the path the user has walked with a trail line.\n\n#### **Phase 3: Advanced Features \u0026 Optimization**\n- **Exploration Percentage:** Automatically calculate and display the percentage of the city covered, based on the user’s movement.\n- **Background Location Tracking:** Ensure the app continues tracking and updating the user’s location even when the app is in the background.\n- **Battery Optimization:** Improve battery efficiency while tracking location in the background.\n- **Offline Support:** Implement offline capabilities for areas with no network connection, enabling location tracking without internet access.\n  \n#### **Phase 4: User-Generated Data \u0026 Social Features**\n- **User Profiles:** Allow users to create profiles and save their exploration data (i.e., how much of a city they've explored).\n- **Sharing \u0026 Leaderboards:** Enable users to share their progress with friends or a community and introduce a leaderboard to motivate exploration.\n  \n#### **Phase 5: Cross-Platform \u0026 Device Support**\n- **Android \u0026 iOS Optimization:** Ensure the app performs well on both platforms, adjusting for any platform-specific challenges.\n- **Wearable Device Support:** Explore the possibility of integrating the app with wearable devices (e.g., smartwatches) to track exploration.\n  \n## Challenges\n\nWhile building this application, several challenges need to be addressed:\n\n- **GPS Accuracy \u0026 Battery Consumption:** Since the app uses continuous GPS tracking, ensuring that the location is accurate and doesn't drain the device's battery excessively is a significant challenge.\n- **Handling Large Data Sets:** Storing and processing location data efficiently is crucial, as the app needs to track the user’s movement across potentially large cities.\n- **Cross-Platform Compatibility:** Ensuring that the app runs smoothly on both Android and iOS requires platform-specific adjustments and optimizations.\n- **Background Location Tracking:** Maintaining location tracking while the app is in the background, especially on iOS devices, is tricky and requires special permissions and configuration.\n- **City Boundary Data Availability:** Acquiring reliable and detailed data for city boundaries might be challenging, as this requires access to accurate geographic datasets.\n  \n## How to Use\n\n1. **Install Dependencies:**  \n   ```bash\n   npm install\n   ```\n\n2. **Run the App:**  \n   Use Expo to run the app on your device.\n   ```bash\n   npx expo start\n   ```\n\n3. **Grant Permissions:**  \n   Make sure to grant the necessary permissions for location access and background location tracking.\n\n4. **Explore the Map:**  \n   The app will show your current location and track your movements. It will highlight the areas you've already covered and display the percentage of the city you've explored.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdadmehr0%2Faktshaf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdadmehr0%2Faktshaf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdadmehr0%2Faktshaf/lists"}