{"id":20887014,"url":"https://github.com/fleetbase/navigator-app","last_synced_at":"2025-04-10T00:16:54.057Z","repository":{"id":42155687,"uuid":"377777472","full_name":"fleetbase/navigator-app","owner":"fleetbase","description":"GPS and Order Management Mobile App for Drivers built with React Native","archived":false,"fork":false,"pushed_at":"2025-04-07T04:25:37.000Z","size":11162,"stargazers_count":38,"open_issues_count":1,"forks_count":56,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-10T00:16:46.119Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/fleetbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-06-17T09:35:27.000Z","updated_at":"2025-04-09T19:10:03.000Z","dependencies_parsed_at":"2024-02-05T04:21:33.303Z","dependency_job_id":"a632627f-ac98-44e1-a15b-627535524bd5","html_url":"https://github.com/fleetbase/navigator-app","commit_stats":{"total_commits":202,"total_committers":3,"mean_commits":67.33333333333333,"dds":0.5148514851485149,"last_synced_commit":"a7232f84f265d82ae5451e0acde7b860b25b5a52"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Fnavigator-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Fnavigator-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Fnavigator-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Fnavigator-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fleetbase","download_url":"https://codeload.github.com/fleetbase/navigator-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248131318,"owners_count":21052820,"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":[],"created_at":"2024-11-18T08:18:47.577Z","updated_at":"2025-04-10T00:16:54.049Z","avatar_url":"https://github.com/fleetbase.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://flb-assets.s3.ap-southeast-1.amazonaws.com/static/fleetbase-logo-svg.svg\" width=\"380\" height=\"100\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\nOpen source order managemenr, geolocation tracking \u0026 navigation app for Fleetbase drivers \u0026 agents.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://fleetbase.io\"\u003efleetbase.io\u003c/a\u003e | \u003ca href=\"https://twitter.com/fleetbase_io\"\u003e@fleetbase_io\u003c/a\u003e | \u003ca href=\"https://discord.gg/fjP4sReEvH\"\u003eDiscord\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/05c81b07-cd52-43e9-b0ac-91e0683ab5f9\" width=\"220\" height=\"416\" /\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/cfa08ce8-bf13-4bb3-96ef-f73045ee157a\" width=\"220\" height=\"416\" /\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/893b58f4-b1ce-4ff5-a78e-530a2035c84b\" width=\"220\" height=\"416\" /\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/770582ef-11c3-4d25-bc68-9df72b41c452\" width=\"220\" height=\"416\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/bfe5ca18-07c1-4188-be8e-277e5ebf7abc\" width=\"220\" height=\"416\" /\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/93e3ee4a-6add-4b82-ae93-ae6f5a217400\" width=\"220\" height=\"416\" /\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/f21c7514-9cfb-4c3e-bdc4-5254565c1b26\" width=\"220\" height=\"416\" /\u003e\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n- [About](#about)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n    - [Configure Environment](#configure-environment)\n- [Running in Simulator](#running-in-simulator)\n    - [Run the app in iOS Simulator](#run-the-app-in-ios-simulator)\n    - [Run the app in Android Simulator](#run-the-app-in-android-simulator)\n- [Navigation using Mapbox](#navigation-using-mapbox)\n- [Documentation](#documentation)\n- [Roadmap](#roadmap)\n\n### About\n\nFleetbase Navigator is an open source navigation and order management app for drivers and agents using Fleetbase. This app is fully customizable and supports QR code scanning, digital signatures, photos, and routing and navigation for agents. Drivers will be able to update activity to orders on the run as they complete job. Navigator app now includes fuel report and issue management and creation. Enable seamless communication with built in chat with operations personnel and customers.\n\n### Prerequisites\n\n- [Yarn](https://yarnpkg.com/) or [NPM](https://nodejs.org/en/)\n- [React Native CLI](https://reactnative.dev/docs/environment-setup)\n- Xcode 12+\n- Android Studio\n\n### Installation\n\nInstallation and setup is fairly quick, all you need is your Fleetbase API Key, and a few commands and your app will be up and running in minutes. Follow the directions below to get started.\n\nRun the commands below; first clone the project, use npm or yarn to install the dependencies, then run `npx pod-install` to install the iOS dependencies. Lastly, create a `.env` file to configure the app.\n\n```\ngit clone git@github.com:fleetbase/navigator-app.git\ncd navigator-app\nyarn\nyarn pod:install\ntouch .env\n```\n\n### Configure Environment\n\nBelow is the steps needed to configure the environment. The first part covers collecting your required API keys.\n\n1.  Get your API Keys;\n2.  **If you don't have a Fleetbase account already** proceed to the [Fleetbase Console](https://console.fleetbase.io/) and click \"Create an account\", complete the registration form and you will be taken to the console.\n3.  Once you're in the Fleetbase console select the \"Developers\" button in the top navigation. Next, select API Keys from the menu in the Developers section, and create a new API key. Copy your secret key generated, you'll need it later.\n4.  Once you have both required API keys open your `.env` file.\n\nIn your `.env` file supply your Fleetbase API secret key, and additionally you will need a Google Maps API Key. Lastly, you'll also need to supply your app/bundle identifier, and an `APP_NAME` key.\n\nYour `.env` file should look something like this once you're done.\n\n```\n# .env\nAPP_NAME=Fleetbase Navigator\nAPP_IDENTIFIER=io.fleetbase.navigator\nAPP_LINK_PREFIX=navigator://\nFLEETBASE_HOST=https://api.fleetbase.io\nFLEETBASE_KEY=\n```\n\n### Running in Simulator\n\nOnce you have completed the installation and environment configuration, you're all set to give your app a test-drive in the simulator so you can play around.\n\n#### Run the App in iOS Simulator\n\n```\nyarn ios\n```\n\n#### Run the App in Android Simulator\n\n```\nyarn android\n```\n\n### Documentation\n\nSee the [documentation webpage](https://fleetbase.io/docs).\n\nIf you would like to make contributions to the Fleetbase Javascript SDK documentation source, here is a [guide](https://github.com/fleetbase/fleetbase-js/blob/master/CONTRIBUTING.md) in doing so.\n\n### Roadmap\n\n- COMING SOON\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleetbase%2Fnavigator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffleetbase%2Fnavigator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleetbase%2Fnavigator-app/lists"}