- About
- Prerequisites
- Installation
- Running in Simulator
- Localization
- Navigation using Mapbox
- Documentation
- Roadmap
Botit Fleet is a navigation and order management app for drivers and agents, built on 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 their jobs. The app includes fuel report and issue management and creation. Enable seamless communication with built-in chat with operations personnel and customers.
Key Features:
- 🌍 Multi-language support - Full Arabic (العربية) and English localization with RTL support
- 📱 Real-time order tracking and management
- 📸 Photo capture and digital signatures
- 🗺️ GPS navigation and routing
- ⛽ Fuel reporting
- 💬 Built-in chat system
- 🔍 QR code scanning
- Yarn or NPM
- React Native CLI
- Xcode 12+
- Android Studio
Installation 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.
Run 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.
git clone git@github.com:fleetbase/navigator-app.git
cd navigator-app
yarn
yarn pod:install
touch .env
Below is the steps needed to configure the environment. The first part covers collecting your required API keys.
- Get your API Keys;
- If you don't have a Fleetbase account already proceed to the Fleetbase Console and click "Create an account", complete the registration form and you will be taken to the console.
- 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.
- Once you have both required API keys open your
.envfile.
In 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.
Your .env file should look something like this once you're done.
# .env
APP_NAME=Botit Fleet
APP_IDENTIFIER=io.fleetbase.navigator
APP_LINK_PREFIX=navigator://
FLEETBASE_HOST=
FLEETBASE_KEY=
BACKEND_URL=
Once 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.
yarn ios
yarn android
Botit Fleet supports multiple languages, including Arabic (العربية) and English. The app automatically detects the device's language settings and displays the appropriate translations.
- English (en) - Default
- Arabic (ar) - Full RTL (Right-to-Left) support
Translation files are located in the translations/ directory:
translations/en.json- English translationstranslations/ar.json- Arabic translations
To add support for a new language:
- Create a new JSON file in the
translations/directory (e.g.,translations/fr.jsonfor French) - Copy the structure from
translations/en.json - Translate all the text values while keeping the keys the same
- The app will automatically detect and use the new language based on device settings
The app uses react-native-i18n and react-native-localize to:
- Detect the device's preferred language
- Load the appropriate translation file
- Support RTL layouts for Arabic and other RTL languages
- Fallback to English if a translation is missing
For more information about Fleetbase, see the documentation webpage.
Botit Fleet is a customized version of Fleetbase Navigator, tailored for specific fleet management needs with enhanced Arabic language support and localized features.