Fleetbo CLI

1.0.250 · active · verified Sun Apr 19

Fleetbo CLI (version 1.0.250) is the official command-line interface for the Fleetbo platform, engineered to streamline the development and deployment of native mobile applications built with React. This tool is actively maintained, with new releases likely synchronized with updates to the broader Fleetbo platform, though a specific public release cadence is not explicitly defined. It distinguishes itself by offering a suite of specialized commands tailored for the Fleetbo ecosystem's mobile development workflows, encompassing initial project setup, automated page scaffolding, and platform-specific build processes for both Android and iOS. A key differentiator is its 'AI Architect Mode' (Alex), indicating integration with AI-powered development assistance. The CLI functions as a comprehensive project scaffold, code generator, and build orchestrator, aiming to simplify the intricacies of React Native development within the Fleetbo framework.

Common errors

```
Error: Node.js version X.Y.Z is not supported. Please use >=16.0.0.
```
cause The installed Node.js version on your system does not meet the minimum requirement specified by the CLI.

fix Update Node.js to version 16.0.0 or higher. For example, `nvm install 16 && nvm use 16` or `nvm install --lts`.
```
Error: Missing required environment variable REACT_APP_ENTERPRISE_ID. Please check your .env file.
```
cause The CLI could not find a critical environment variable in the project's `.env` file, which is necessary for project identification.

fix Verify that `REACT_APP_ENTERPRISE_ID=your_project_id` is correctly set in your project's `.env` file.
```
Error: Command 'page' must be run inside a Fleetbo project.
```
cause The CLI command was executed in a directory that is not recognized as a valid Fleetbo project root.

fix Change your current working directory to the root of your Fleetbo project before running the command.

Warnings

breaking Node.js version requirements are strict. Running the CLI with an unsupported Node.js version (below 16.0.0) may lead to unexpected errors or silent failures.
Fix: Upgrade your Node.js installation to version 16.0.0 or higher using nvm (Node Version Manager) or by downloading the latest LTS from nodejs.org.
gotcha The CLI requires a valid Fleetbo project with a properly configured `.env` file at the project root. Missing or incorrect environment variables (e.g., REACT_APP_ENTERPRISE_ID, REACT_KEY_APP, REACT_APP_TESTER_EMAIL) will prevent core functionalities from working.
Fix: Ensure your project's `.env` file contains all necessary configuration keys as specified in the Fleetbo documentation, with correct values for your project.
gotcha Commands such as `page` or `android` must be executed within the root directory of an initialized Fleetbo project. Running them outside a recognized project context will result in an error indicating the absence of a valid project.
Fix: Navigate to the root directory of your Fleetbo project before executing any `fleetbo-cli` commands that operate on project files.

Install

npm install fleetbo-cockpit-cli npm
yarn add fleetbo-cockpit-cli yarn
pnpm add fleetbo-cockpit-cli pnpm

Quickstart

Demonstrates generating a new page component within a Fleetbo project using the CLI.

npx fleetbo-cli page Dashboard
# This command generates a new React component file named 'Dashboard'
# within your Fleetbo project's page directory, ready for customization.
# For example, it might create src/pages/Dashboard/index.js
# and an associated styles or test file. Ensure your .env is configured.

# Alternatively, if installed as a dev dependency:
# npm install --save-dev fleetbo-cockpit-cli
# npm run fleetbo page Settings --prefix admin
# This would generate a page component under an 'admin' subdirectory.

view raw JSON →